Projects, organizations and your team

Create a project

1. On Projects, choose Create Project (or Create Your First Project).
2. Enter a Project Name. A Project ID / Slug is suggested and checked for availability. Slugs are 3 to 48 characters, lowercase letters, numbers and hyphens.
3. Choose a Project Template / Architecture: Blank Project (no database yet) or Add Database (an empty PostgreSQL database now).
4. If you add a database, choose the PostgreSQL Engine Version and any Database Extensions.
5. Choose Create Project.

You land on Overview with a success message. Region is automatic. The project gets a Default Secret Key and a Default Publishable Key; their values are not shown, you create your own later.

Project Settings

Open Project Settings to see Project Name (change with Save Name), the Immutable Project ID, the slug, organization and region. Deleting a project is in the Danger Zone and is only possible when the project has no tables, functions, files, containers or actions.

Invite a teammate

1. Open IAM.
2. Choose Invite Team Member.
3. Enter the email and choose a role: Admin, Developer, Billing or Viewer.
4. Choose All Projects (*) or Selected Projects.
5. Choose Send Invitation.

The person opens the emailed link while signed in as that email (or registers with it) to join. Pending invitations show under Pending Invitations with Cancel. Use Edit Access and Remove later. Removing someone revokes the project keys they created.

Roles in one table

Developer: SQL read and write, containers, queues, keys. Billing: invoices and payment, read data. Viewer: read-only. Admin and Owner: everything including members and billing.

Switch organization

If you belong to several organizations, use the organization menu (Accounts & Workspaces) in the header. Check the name before creating anything.

Try it

Create a project named after your app with Blank Project, then invite a colleague as Viewer with Selected Projects.

Recap

• Projects live in organizations; roles and scope control access.
• Slugs are permanent; names can change.