Account Setup and Configuration
Everything you need to know about setting up your Hopsule account: registration, profile configuration, notification preferences, security settings, and two-factor authentication.
Account Registration
Setting up your Hopsule account is the first step towards preserving, enforcing, and sharing your team's most important decisions and the reasoning behind them. The registration process is designed to be straightforward, allowing you to quickly gain access to the Hopsule Dashboard and begin establishing your organizational judgment. Hopsule ensures a secure and verified entry point, safeguarding the integrity of your team's collective memory from the outset.
You can register for Hopsule using a combination of your email and a secure password, or by leveraging supported third-party identity providers for a streamlined experience. Upon successful registration, a verification step is initiated to confirm the authenticity of your email address. This ensures that all critical notifications and communications regarding your decisions and memories reach the correct destination, reinforcing the reliability of Hopsule as your team's decision and memory layer.
Sign-Up Process
To begin your journey with Hopsule, navigate to the official Hopsule Dashboard registration page. You will be presented with options to create an account either by providing your email address and a strong password or by using a convenient single sign-on (SSO) method. Choosing a robust password is paramount for maintaining the security of your account, especially as it will safeguard access to your team's critical decisions and the historical context of your organizational judgment.
Open your web browser and go to the Hopsule Dashboard sign-up URL.
Select your preferred registration method:
Enter your Email and create a strong Password, then click Sign Up.
Alternatively, click on one of the supported third-party identity provider buttons (e.g., Google, GitHub) and follow the prompts to authorize Hopsule.
If you registered with email, a verification link will be sent to the email address you provided.
Email Verification
Email verification is a crucial security measure that confirms ownership of your email address and activates your Hopsule account. This step ensures that only authorized individuals can access and manage the decisions and memories associated with your profile and organization. Without verification, access to certain Hopsule Dashboard features may be restricted, emphasizing the importance of this initial security gate.
Check your inbox for an email from Hopsule with the subject line "Verify your email address" or similar.
Click the verification link contained within the email. This will redirect you back to the Hopsule Dashboard, confirming your account.
If you do not receive the email, check your spam or junk folder. You may also request a new verification email from the Hopsule Dashboard login page if necessary.
Important: Your account will remain in a pending state until your email address is successfully verified. This ensures the integrity of the Hopsule ecosystem and protects your organizational judgment.
Profile Settings
Your Hopsule profile allows you to personalize your identity within the Hopsule Dashboard, making your contributions to decisions and memories easily recognizable to your team. These settings govern how you appear to other users and how the Hopsule Dashboard adapts to your preferences, enhancing your overall experience. Maintaining an accurate profile contributes to clear communication and traceability within your organization's decision-making processes.
To access your profile settings, navigate to the user menu typically located in the top-right corner of the Hopsule Dashboard. Clicking on your avatar or name will reveal a dropdown menu from which you can select Settings, and then proceed to the Profile tab. This central location ensures that managing your personal details is straightforward and intuitive.
Managing Your Personal Information
Within the Profile tab, you can update various aspects of your personal information. This includes your full name, which is used for formal identification, and a display name, which offers a more flexible way to present yourself within the Hopsule Dashboard. A distinctive avatar further helps your team identify your contributions to decisions, memories, and context packs, fostering a more connected and transparent environment for preserving organizational judgment.
From the Hopsule Dashboard, click on your Avatar or Name in the top-right corner.
Select Settings from the dropdown menu.
Navigate to the Profile tab.
Update the following fields as needed:
Name: Your full name, for formal identification.
Display Name: A shorter or preferred name visible to other team members.
Avatar: Upload an image to represent yourself. This helps personalize your contributions across decisions, memories, and activity feeds.
Click Save Changes to apply your updates.
Timezone and Language Preferences
Hopsule supports customization of your timezone and language to ensure the Hopsule Dashboard aligns with your geographical location and linguistic preferences. Correct timezone settings are vital for accurate timestamping of decisions, memories, and activity events, which is crucial for maintaining a precise audit trail and understanding the chronological development of organizational judgment. Language preferences ensure that the user interface is presented in a way that is most comfortable and efficient for you.
In the Profile tab of your Hopsule settings, locate the Timezone and Language sections.
Select your preferred Timezone from the dropdown list. This impacts how timestamps are displayed throughout the Hopsule Dashboard.
Choose your desired Language for the user interface.
Click Save Changes to confirm your selections.
Tip: Setting the correct timezone is critical for collaborative teams to accurately track the lifecycle of decisions and the timing of memory contributions, ensuring consistent understanding across different geographical locations.
Notification Preferences
Hopsule's notification system keeps you informed about significant activities related to decisions, memories, and context packs within your organizations. Tailoring your notification preferences ensures you receive timely updates on events that matter most to you, without being overwhelmed by unnecessary alerts. This focused communication helps you stay engaged with the evolving landscape of your team's organizational judgment and respond promptly when required.
To configure your notification settings, access the user menu in the top-right corner of the Hopsule Dashboard, select Settings, and then navigate to the Notifications tab. Here, you will find comprehensive options to customize which events trigger alerts and how those alerts are delivered to you, allowing for a personalized experience that supports your workflow.
Event-Triggered Notifications
You can specify which types of events within Hopsule should trigger a notification. This granular control allows you to focus on the lifecycle stages of decisions, new memory contributions, or updates to context packs that are most relevant to your role and responsibilities. By carefully selecting your notification triggers, you ensure that Hopsule acts as a focused reminder system for critical changes in your team's shared organizational judgment.
Decision Lifecycle Events: Receive alerts when a decision you are involved with (e.g., as an author, reviewer, or stakeholder) transitions through its lifecycle states (Draft, Pending, Accepted, Deprecated).
Memory Contributions: Get notified when new memories are added or linked to decisions you follow or are associated with. This keeps you informed about the evolving context and reasoning.
Capsule Updates: Be alerted when Context Packs (Capsules) you are monitoring are updated, activated, or frozen, reflecting changes in portable organizational judgment.
Mentions: Receive notifications when another user mentions you in a decision or memory comment, facilitating direct communication and collaboration.
Delivery Channels and Frequency
Hopsule offers flexibility in how you receive notifications, allowing you to choose between in-app alerts within the Hopsule Dashboard or email notifications. You can also configure the frequency of these communications, opting for immediate alerts for critical events or a consolidated digest for less urgent updates. This adaptability ensures that Hopsule integrates seamlessly into your preferred communication style, reinforcing its role as a decision and memory layer.
In the Notifications tab, review the list of available event types.
For each event type, toggle whether you want to receive In-App notifications and/or Email notifications.
Adjust your Digest Frequency for email notifications, choosing options such as "Immediate," "Hourly," or "Daily" for a summarized overview of less critical events.
Click Save Changes to apply your updated notification preferences.
Important: While you can customize most notifications, certain critical security alerts or system-wide announcements may be sent regardless of your preferences to ensure your account security and service availability.
Security Settings
Security is a foundational pillar of Hopsule, ensuring the integrity and confidentiality of your team's decisions, memories, and organizational judgment. The security settings within your Hopsule Dashboard allow you to manage critical aspects of your account's protection, including your password, two-factor authentication (2FA), and active sessions. Regularly reviewing and updating these settings is a best practice for safeguarding your access to Hopsule and the sensitive information it preserves.
To access your security configurations, navigate to the user menu in the top-right corner of the Hopsule Dashboard, select Settings, and then proceed to the Security tab. This dedicated section provides a centralized interface for managing all aspects of your account's defensive posture, reflecting Hopsule's commitment to robust data protection.
Changing Your Password
Periodically updating your password is a fundamental security practice. Hopsule enforces strong password policies to protect your account and the valuable organizational judgment it contains. If you ever suspect unauthorized access or simply wish to enhance your account's security, changing your password is a straightforward process within the Hopsule Dashboard.
In the Security tab, locate the Change Password section.
Enter your Current Password.
Enter your New Password, ensuring it meets the specified complexity requirements (e.g., minimum length, mix of characters).
Confirm your New Password by entering it again.
Click Update Password to finalize the change.
Tip: Use a unique, strong password that combines uppercase and lowercase letters, numbers, and symbols. Consider using a password manager to generate and store complex passwords securely.
Two-Factor Authentication (2FA)
Two-Factor Authentication (2FA) adds an essential layer of security to your Hopsule account by requiring a second form of verification in addition to your password. This significantly reduces the risk of unauthorized access, even if your password is compromised. Hopsule supports time-based one-time password (TOTP) applications for 2FA, providing a widely adopted and secure method.
In the Security tab, find the Two-Factor Authentication section.
Click Enable 2FA.
Follow the on-screen instructions, which typically involve:
Scanning a QR code with a compatible authenticator app (e.g., Google Authenticator, Authy).
Manually entering a setup key into your authenticator app if scanning is not possible.
Entering the six-digit code generated by your authenticator app into the Hopsule Dashboard to confirm setup.
Once enabled, Hopsule will provide a set of Recovery Codes. Download or print these codes and store them in a secure, offline location. These codes are crucial for regaining access to your account if you lose access to your authenticator device.
Important: Never share your 2FA recovery codes or one-time passcodes with anyone. Hopsule personnel will never ask for these details.
Active Sessions
The Active Sessions section allows you to review all current logins to your Hopsule account across various devices and locations. This feature provides transparency and control over who is accessing your organizational judgment. If you notice any unfamiliar or suspicious sessions, you can immediately terminate them, protecting your account from potential compromise.
In the Security tab, scroll down to the Active Sessions list.
Review the details for each session, including the device type, browser, approximate location, and last activity.
If you identify any session that you do not recognize or wish to end, click the Revoke or Log Out button next to that session.
Confirm your action when prompted. This will immediately terminate the selected session, requiring a new login for that device.
Tip: Regularly check your active sessions, especially if you access Hopsule from public or shared computers. This proactive measure helps maintain the security of your decisions and memories.
Organization Management
Hopsule is designed to support both individual developers and large engineering organizations, enabling the preservation and enforcement of collective organizational judgment. Within Hopsule, an organization serves as a container for your teams, projects, decisions, memories, and context packs. This structure facilitates collaboration and ensures that shared governance principles are applied consistently across your engineering efforts.
Upon initial registration, you will typically be prompted to create your first organization. Subsequently, the Hopsule Dashboard allows you to manage multiple organizations, switch between them, and configure their specific settings. This flexibility is crucial for enterprises with diverse teams and projects, each requiring its own dedicated decision and memory layer.
Creating a New Organization
Your first organization in Hopsule is where you will begin to formalize your team's decisions and build your collective memory. Even if you are a solo developer, creating an organization provides the necessary structure to manage your personal architectural decisions and coding conventions, embodying the principle that enforcement is remembrance.
After completing your account registration and email verification, you will typically be guided to an "Create Your Organization" page.
Enter a descriptive Organization Name. This name will be visible to all members and in your Hopsule Dashboard navigation.
Provide an optional Organization Description to clarify its purpose or scope.
Click Create Organization.
You will then be directed to your new organization's dashboard, ready to create your first decisions and memories.
Organization Settings
Each organization within Hopsule has its own set of configurable settings, accessible by navigating to the organization selector in the Hopsule Dashboard and then choosing Organization Settings. These settings allow administrators to manage members, define roles, configure billing, and update the organization's profile, ensuring that the decision and memory layer aligns with the organization's operational needs.
General: Update the organization's name and description, which are crucial for clear identification across multiple teams and projects.
Members & Roles: Invite new team members, manage existing users, and assign specific roles (e.g., Admin, Editor, Viewer) to control access and permissions for decisions, memories, and context packs. Refer to the "Managing Team Members" documentation for more details.
Billing: Manage your subscription plan, view invoices, and update payment methods. This section is essential for ensuring uninterrupted service and access to advanced Hopsule features.
Integrations: Configure connections to external tools and services, enhancing Hopsule's ability to integrate with your existing engineering workflows.
Important: Only users with appropriate administrative roles can access and modify organization settings. Role-based access control is a core aspect of Hopsule's security and governance framework.
Switching Between Organizations
For users who are members of multiple Hopsule organizations, the Hopsule Dashboard provides a seamless way to switch contexts. This feature is invaluable for consultants, project leads, or engineers working across different clients or internal departments, allowing them to quickly access the relevant decisions and memories for each distinct organizational judgment.
In the Hopsule Dashboard, locate the Organization Selector in the top-left corner (typically displaying the current organization's name).
Click on the current organization's name to open a dropdown list of all organizations you are a member of.
Select the desired organization from the list. The Hopsule Dashboard will refresh, displaying decisions, memories, and context packs specific to that organization.
Account Data
Hopsule provides transparency into your individual contributions and activities within the platform, reinforcing the collaborative nature of building organizational judgment. Your personal account data sections allow you to review your authored decisions, contributed memories, and a comprehensive activity feed. This empowers you to track your impact and understand your engagement with the decision and memory layer.
Your Activity Feed
The personal activity feed provides a chronological record of your interactions within Hopsule, offering a clear overview of your contributions to decisions, memories, and context packs. This feed serves as a personal audit trail, helping you recall specific actions and understand your historical involvement in various aspects of your team's organizational judgment.
From the Hopsule Dashboard, click on your Avatar or Name in the top-right corner.
Select My Activity from the dropdown menu.
Review the feed, which displays events such as decisions you've drafted, accepted, or deprecated; memories you've added; and comments you've made.
Your Decisions and Memories
Hopsule allows you to quickly filter and view all decisions you have authored and all memories you have contributed across your organizations. This consolidated view is invaluable for understanding your personal impact on the team's shared decision-making and the context that supports those choices. It highlights your direct role in shaping and preserving organizational judgment.
To view your authored decisions, navigate to the Decisions section of the Hopsule Dashboard.
Utilize the filtering options to select "Authored by Me" or similar, which will display only the decisions you have created.
Similarly, to view your contributed memories, go to the Memories section.
Apply filters to show "Contributed by Me" to see your personal memory entries.
Danger Zone
The "Danger Zone" in your Hopsule account settings provides options for irreversible actions, such as account deletion and data export. These features are designed with careful consideration, ensuring that you have full control over your personal data and the organizational judgment associated with your account. It is crucial to understand the implications of these actions before proceeding, as they have significant consequences for your presence within the Hopsule ecosystem.
Access to the Danger Zone is typically found within your personal Settings under a clearly marked section. Hopsule implements multiple confirmation steps for these actions to prevent accidental data loss, reinforcing the philosophy that enforcement is remembrance, not control, and that decisions about data are paramount.
Account Deletion
Deleting your Hopsule account is a permanent and irreversible action that removes your personal profile and all associated data from Hopsule's systems. While your contributions to organizational decisions and memories may persist (as they are part of the collective organizational judgment), your personal identity and access will be removed. Carefully consider the impact on your team and any ongoing projects before initiating this process.
Navigate to your personal Settings by clicking your Avatar > Settings.
Scroll down to the Danger Zone section.
Click on the Delete Account button.
You will be prompted to confirm your decision, often by re-entering your password or typing a specific phrase. Read the warnings carefully.
Once confirmed, your account will be scheduled for deletion, and access will be immediately revoked.
Important: Account deletion is permanent. While your direct personal data will be removed, certain contributions (e.g., decisions authored, memories contributed) may remain associated with the organization's historical record, anonymized where appropriate, to preserve the integrity of collective organizational judgment. Refer to Hopsule's Terms of Service for full details on data retention policies.
Data Export
Hopsule provides functionality to export your personal account data, upholding your right to data portability. This feature allows you to download a copy of your personal information, including your profile details, activity logs, and any personal drafts of decisions or memories not yet contributed to an organization. This ensures that you retain a personal record of your engagement with the decision and memory layer.
Navigate to your personal Settings by clicking your Avatar > Settings.
In the Danger Zone section, locate the Export Data option.
Click the Request Data Export button.
Hopsule will compile your personal data into a machine-readable format (e.g., JSON or CSV) and send a download link to your verified email address.
The export process may take some time depending on the volume of your data. You will be notified when your export is ready.
Tip: Regularly exporting your data can be a useful practice for personal record-keeping or if you are transitioning your workflow. This ensures you always have a copy of your individual contributions to Hopsule's decision and memory layer.