Projects & Workspaces

Projects organize apps, build activity, and storage into focused work areas. Use them when a single organization has multiple products, environments, customers, or teams.

Projects

Open Projects from the sidebar to see every project in the active organization.

A project has:

• Name — Human-readable label.
• Slug — URL-friendly identifier used in project-scoped routes.
• Description — Optional context for the team.
• Members — Optional allowlist of users. If the list is empty, every organization member can access the project.

Project pages include quick links to:

• Apps — Deployments and catalog actions scoped to the project.
• Build — Editors, runs, issues, and build activity scoped to the project.
• Storage — Databases and object storage scoped to the project.

Creating a Project

1. Open Projects.
2. Click New Project.
3. Enter a name.
4. Accept the generated slug or edit it before creation.
5. Add an optional description.
6. Click Create.

TIP

Choose a stable slug. The slug appears in project URLs and is how teammates recognize project-scoped areas.

Project Membership

By default, an empty member list means every organization member can access the project.

To restrict access:

1. Open the project.
2. Click the edit button.
3. Add specific organization members.
4. Save the project.

Only members in the project list can access project-scoped views. Organization roles still apply; project membership narrows visibility, but it does not grant higher permissions.

Workspaces

Build workspaces are browser-based development environments. They are usually opened from a project-scoped Build view so editors, runs, issues, and storage stay grouped with the project they belong to.

Use a workspace when you need to:

• Edit code in the browser.
• Run commands in an isolated terminal.
• Use AI coding tools inside the editor.
• Commit and push changes back through the platform pipeline.

Moving Between Global and Project Views

Some pages exist in both global and project-scoped forms.

Area	Global view	Project view
Apps	/apps	/projects/{project}/apps
Build	/build	/projects/{project}/build
Storage	/storage	/projects/{project}/storage

Use global views when you need organization-wide visibility. Use project views for day-to-day work inside one team or workload.

Troubleshooting

Symptom	What to check
A teammate cannot see a project	Check project membership first, then confirm their organization role.
A project slug is rejected	Use lowercase letters, numbers, and hyphens. Avoid reserved platform words.
A resource appears outside a project	Open the resource from the global view and assign or recreate it in the intended project context.
You cannot create a project	You need at least contributor-level access in the organization.

Next Steps

• Take a portal tour
• Open the Build guide
• Deploy your first app