Workspaces
Your app's managed home — tabs, lifecycle, and resources.
What is a workspace?
A workspace is an isolated, managed environment that holds and runs exactly one app. Everything for that app lives in its workspace: the source code, the PostgreSQL database, the running instance, and the public URL it's served at.
Workspaces are independent — building, restarting, or deleting one never touches another. Create as many as you have apps. Your account's Token Wallet funds the AI work across all of them, while each workspace runs on its own resource subscription.
Opening a workspace
From My Workspace you'll see a card for each workspace with its name, resource chips (CPU / RAM / storage), and a live status dot. Click a card to open that workspace. New here? Use New workspace to create one.
Workspace tabs
Inside a workspace there are four tabs:
One shared calendar, or one per staff member?
| Tab | What it's for |
|---|---|
| Chat | Your conversations with Solitud — this is where you build. Lists your chat threads and a New chat button. See The chat. |
| Members | Invite people to the workspace and manage who has access. |
| Activity | A chronological feed of workspace events — provisioning, restarts, manager updates — with status and timing. |
| Manage | Workspace settings and lifecycle actions (below). |
The Manage tab
Manage holds your workspace's name and description, its resource tier and subscription details, and the lifecycle actions:
| Action | What it does |
|---|---|
| Restart | Queues a redeploy — recreates the containers while preserving your data, tunnel, and configuration. Takes about 1–3 minutes. |
| Update manager | Syncs the latest Solitud workspace runtime and rebuilds the manager. Your app and URL are left untouched (~1–3 minutes). |
| Stop | Gracefully tears the running stack down to pause it. Your data and configuration are preserved; the app stops serving until you restart. |
| Delete workspace | Permanently deletes the workspace and all its data, and ends its resource subscription. |
Restart vs. Restart app. The Restart here (Manage tab) redeploys the whole workspace. There's also a quicker Restart app control inside the chat view that just restarts your running app — see The chat.
Deleting is irreversible. Delete asks you to type the workspace name to confirm. It removes the code, database, and URL, and cancels the subscription. Export to GitHub first if you want to keep a copy.
Lifecycle
A workspace moves through a simple, repeating cycle:
- Create — name it and choose a resource tier.
- Provision — Solitud builds the environment and brings it online.
- Build — you describe changes in the chat; the AI writes code.
- Run & verify — Solitud runs the app and checks it's healthy.
- Live — the app is served at its URL; iterate by chatting more.
You can Restart, Update manager, or Stop a workspace from the Manage tab at any time, and Delete it when you're done.
Resources
Each workspace is provisioned for its tier, which reserves CPU, RAM, and storage. Bigger tiers suit busier apps and more data. You can move a workspace to a different tier as your needs change. See Pricing for the tiers.
The stack inside
Every workspace runs the same modern stack — you never configure it:
| Layer | Technology |
|---|---|
| Frontend | Next.js + Tailwind CSS |
| Backend | FastAPI (Python) |
| Database | PostgreSQL |
| Realtime | WebSocket |
In the chat view, the App, Server, and Database status pills show the health of each of these — see The chat.
Custom domains
You can serve a workspace from your own domain instead of the default
*.solitud.dev address. You set this up right in the chat — Solitud gives you the
DNS records to add and verifies them for you. See
Custom domains.
FAQ
Can one workspace hold multiple apps? No — one app per workspace, by design. It keeps environments clean and the AI focused. Build a second workspace for a second app.
What happens to my data when I restart? Restarting recreates the containers but preserves your database and configuration. The AI changes code, not your data, unless you ask it to.
Can I share a workspace with my team? Yes — use the Members tab to invite people.