Organizations & projects

Organization#

The account, billing, and admin boundary. Your admin login belongs to exactly one organization; that organization owns every project you create. Org-wide settings (its name, admin accounts) are edited from the console.

Project#

A complete, isolated app backend: one runtime with its own database, storage, queues, schedules, signals, sites, and users, served at https://<project-ref>.snoozestack.com. What the project is lives in your repo — the committed snoozestack/ folder — and the hosted side runs what you publish. An organization can hold as many projects as you need; one per app is the common case, and nothing is shared between them — not data, not users, not sign-in providers.

Namespaces#

Within a project, state is namespaced: dev is your machine, default is live, and a named preview (snoozestack publish --preview staging) gets its own. Each namespace holds genuinely separate data, storage, queues, and secret overrides — so exercising a preview never touches live rows, and a device registered in development can never receive a live push.

Creating a project#

snoozestack projects create my-app
snoozestack link --project my-app     # records it in snoozestack/project.toml

See Using the console for where each of these lives in the console.