Creating a Workspace

Workspaces are shared environments where teams and collaborators can work together on apps. Only members of your workspace can view and manage the app—unless you choose to make it public.

Private (individual) workspace. When you create a Health Universe account, you'll have a private workspace. This is ideal for individual projects. They can be made public so that others can use the apps you create, but only you will be able to develop and deploy those apps. FastAPI apps that are deployed in your individual workspace cannot be moved into a shared workspace — you will need to redeploy those apps into the shared workspace.

Shared Workspaces: Shared workspaces are used for team or enterprise projects. The person who creates the workspace can then invite other members of their team to that workspace. Shared workspaces are ideal for team projects or projects that require multiple apps to work together within the Navigator environment. Apps within a workspace will be available within the instance of Navigator within that workspace.

To create a shared workspace:

1. Go to the Workspaces Page

Navigate to: 👉 https://www.healthuniverse.com/workspaces

2. Create a New Organization

The New organization can be names for the project team, the organization, or the enterprise. It is best to make it unique to the scope of the project that you are working on. Only one person on the team (the team leader), should need to create the project workspace.

• In the top-left corner, click the dropdown next to your personal account.

  
• Select Create Organization.

• A pop-up window will appear.

  

3. Fill Out Organization Info

In the pop-up:

• Upload your organization logo (optional)

• Enter a name for the workspace

• The slug will autofill based on your name (e.g. my-org)

• Click Create Organization

4. Invite Members (Optional)

After creating the organization, a second pop-up will appear to invite team members:

• Add email addresses (separated by commas)

• Select each person's role from the dropdown:

  • Member – can view and use the app

  • Admin – can manage settings, deployments, and members

• Click Send Invitations or choose Skip to add members later

✅ You’ll see a confirmation message: "Invitations successfully sent" Click Finish to complete setup.

5. Confirm Members

Invited users will receive an email and can accept the invitation to join your organization.

To check their status:

• Go to your workspace

• In the left-hand menu, click Settings > Members

• You’ll see a list of all current members and invited members

🔄 Inviting More Members Later

Admins can invite more people anytime:

1. Go to your workspace, then in the left-hand menu select Settings>Members

2. Click Invite (top-right corner)

3. Add emails, select roles, and send!

⚙️ Managing Workspace Settings

Within your workspace Settings, you can access the following options:

• General:

  • Update your Organization Profile (name, slug, logo)

  • Leave Organization

  • Delete Organization

• Members:

  • View current members

  • Invite or remove members

  • Adjust roles and permissions