Dashboard.
Every screen in the signed-in app at prized.dev/dashboard, what each control does, and where a setting lives. The feature pages explain the behaviour; this one says where to click.
Layout
The dashboard is one sidebar and one page at a time. A new sign-up meets it after the onboarding tour (Quickstart).
| Part | What it does |
|---|---|
| Sidebar | Three groups, top to bottom: Boxes, Snapshots, Environments; Filesystem, Connectors, Secrets; Workspace, Billing, Settings. The button at the left of the top bar (or Cmd/Ctrl+B) collapses it to an icon strip. |
| Top bar | The breadcrumb, and New box at the right of every page (gone while the workspace is closing). |
| Account row | The workspace name and your email at the bottom of the sidebar. Click it for Switch workspace (only when you belong to more than one), Workspace, Billing, Settings, and Sign out. |
| Free credit note | On the free credit, the sidebar footer counts down what is left, with an Upgrade button. It goes once you have a plan. |
| Banner | A line across the top of every page when money needs attention: credit running low, free credit used up, balance empty and boxes suspended, in overage, a failed plan payment, or no plan chosen yet (that one links to the plan step). The others link to Billing. A closing workspace shows the deletion date and Reopen instead. See When we tell you. |
Screens
| Screen | Route | What you can do | Details |
|---|---|---|---|
| Boxes | /dashboard | See every box, its state and vitals; copy its prized ssh command | Boxes |
| New box | /dashboard/boxes/new | Pick a size, name, template, environment and per-box vars; create | Create |
| Box: Overview | /dashboard/boxes/<id> | Pause, resume, resize, move region, snapshot, fork, template, auto-pause, deadline, env vars, phone access, delete; the event log | Boxes |
| Box: Terminal | /dashboard/boxes/<id>/terminal | A shell in the box's tmux session | Sessions |
| Box: Desktop | /dashboard/boxes/<id>/desktop | A Linux desktop or one Chrome window, streamed | Desktop |
| Box: Monitor | /dashboard/boxes/<id>/monitor | Live and historical cpu, memory, network, disk, ports and processes | Telemetry retention |
| Box: Files | /dashboard/boxes/<id>/files | Browse, edit, upload, download, rename and delete files | Files below |
| Box: Secrets | /dashboard/boxes/<id>/secrets | Mount and unmount workspace secrets on this box | Secrets tab below |
| Snapshots | /dashboard/snapshots | Take, restore, delete, name templates; undo a box delete | Snapshots |
| Environments | /dashboard/environments | Create and edit what new boxes inherit; upgrade boxes | Environments |
| Filesystem | /dashboard/filesystem | Pick a running box to browse | Files below |
| Connectors | /dashboard/connectors | Mount a provider credential into a box | Connectors |
| Secrets | /dashboard/secrets | Create, rotate and delete brokered secrets | Secrets for agents |
| Workspace | /dashboard/workspace | Name, icon, domain, invite link, members, CLI tokens, data and privacy, close, erase | Workspaces |
| Billing | /dashboard/billing | Plan, balance, top-ups, overage, what each box burns, activity, the Stripe portal | Billing |
| Settings | /dashboard/settings | Your name, sign-in providers, browser sessions | Settings below |
Boxes
/dashboard is a grid of cards, oldest first. Each card shows the name, state, size, last heartbeat, cpu, memory and disk, and the box's prized ssh <name> command (click it to copy). Click the card to open the box; deleted boxes leave the grid.
New box
New box in the top bar opens /dashboard/boxes/new.
| Control | What it does |
|---|---|
| Size ladder | One cell per size; arrow keys move between them. A size your balance cannot keep running is blocked with a line that says why, unless the plan offer below is checked; see Starting and resizing boxes. |
| Name | A fruit name is suggested; type your own or leave it. There is no rename later: a box keeps the name it was created with. |
| Start from | Only once you have a template: the box boots that disk, and the ladder jumps to the template's size. The new box from this link on Snapshots lands here with the template preset. |
| Environment | Only once you have an environment: your default is preselected; none gives the box no repos, script, vars or files. |
| Env vars for this box | NAME=value, one per line, editable later on the box page; see Per-box vars. |
| Restricted (safe for third parties) | Closes every credential channel to the box, permanently; see Safe for third parties. |
| Plan offer | Workspace owners see a checked offer when the box would outgrow the plan: Switch to the $X/mo plan; uncheck it to create on the current plan. With no plan and an empty balance it offers Start on the $X/mo plan instead, and the button reads Continue to checkout. |
| Create box | Back to the grid, where the new card shows up provisioning. A taken name, the box limit, or too little balance is refused with the reason. |
A closing workspace shows no ladder; reopen it from Workspace first.
The box page
Every box has six tabs: Overview, Terminal, Desktop, Monitor, Files, Secrets. The header above them shows the name, the state, the last heartbeat and the prized ssh chip.
Overview
Vitals (cpu, memory, disk; uptime and pauses survived) and Machine (size, disk, region, created) lead. Then Actions, one row per setting:
| Row | What it does | Details |
|---|---|---|
| Pause / Resume | One button whose verb follows the state. | Pause and resume |
| Environment | The pinned environment and version (restricted when the box is), Upgrade to vN when a newer version exists, and Vars to edit the per-box vars (Save vars replaces the set). | Versions and upgrade |
| Auto-pause | Off, or after 30 minutes, 1, 2, 4, 8 or 24 hours idle; while set, the row shows how long the box has been idle so far. | Auto-pause |
| Pause at | No deadline, in 1, 4, 12 or 24 hours, or Custom window (hours, or 90m, 36h, 3d), then Set. Picking a new window extends a deadline; the row is hidden while the box is paused. | Pause deadline |
| Resize | Pick a size card, then confirm: Resize, or Resize and switch for $X today with Just resize under it when the new size outgrows the plan. | Resize |
| Move region | Shown only when there is more than one region. Picking one starts the move; the button stays off while a move is in flight. | Regions |
| Snapshot | A name and an optional description, then Create snapshot. | Take a snapshot |
| Save as template | A template name, then Save. | Templates |
| Automatic snapshots | Off, or an interval from every hour to every week, and how many to keep. | Automatic snapshots |
| Fork | An optional name, a size whose disk holds the copy, keep the disk copy as a snapshot afterwards, then Fork, which opens the new box's page. | Fork a box |
| Phone access | Set up shows host, port and username. Generate password shows the password once, Regenerate password replaces it everywhere, Revoke removes it. | From your phone |
| Delete box | A dialog that asks you to type delete <name>. The undo is Recently deleted on Snapshots. | Deleting a box |
A refusal shows under the rows in the server's own words. Events closes the page: the last 50 state changes, each with its reason, actor and time.
Terminal
A shell in the box's persistent tmux session main, the same one prized ssh opens: a CLI window and this tab show the same screen, and closing the tab loses nothing. Opening it wakes a paused box. See Sessions.
- The header lists the session's tmux windows as chips; click one to switch. Full screen sits at the right, and reconnect appears after a drop.
- Select to copy: Cmd+C on a Mac, Ctrl+Insert or the right-click menu elsewhere; Ctrl+C goes to the shell. Nothing on the box can read or write your clipboard through this tab.
Desktop
Pick Desktop or Browser, then Open desktop or Open browser; the rest is on Desktop.
Monitor
The range switcher sits in the tab row: live, 1h, 6h, 24h, 7d, 30d. Live streams every 2 seconds, seeded with the last hour; the other ranges are stored history with averages and a max band, paused spans shaded, and lifecycle events as ticks. The panels are cpu (per core when live), memory, network, disk, ports · tmux, and processes (sorted by cpu or mem).
- Hover a chart for the value at that time. Click to pin the moment, and the ports and processes panels swap to the nearest stored snapshot; Esc, unpin or back to live releases it.
- The monitor never wakes a paused box. How long history is kept is on Data retention.
Files
A file browser over the box's own SSH, as the box's login user. It needs a running box and never wakes a paused one; the Filesystem page in the sidebar lists the running boxes with a Browse files button each.
- Each row has download (files only), rename and delete; delete confirms inline.
- Click a file to open it. A text file within the inline cap opens in an editor (Save writes the whole file back, Esc closes without saving); a bigger text file shows its head read-only, and a binary file offers download instead.
- Transfers run one at a time; the size caps are on Limits.
Secrets tab
Which workspace secrets this box receives as env vars: each mount with Unmount beside it, then a secret picker, an env name and Mount. Mounts need a running box, and a restricted box refuses them. The secrets themselves live under Secrets.
Snapshots
New snapshot picks a box, a name and an optional description. Everything you have taken is one table, newest first, with each snapshot's kind, box, size, status and age.
- Restore: an optional name for the new box, then Restore. Only an
availablesnapshot restores. - Make template (or Rename on a template): name the snapshot so new boxes can start from it.
- Delete: click once, then Confirm delete. A snapshot still
creatingshows Cancel instead. - templates, above the table once you have one: new box from this opens New box with the template preset, and Drop name keeps the snapshot as a plain one.
- recently deleted, below the table: the undo copies of deleted boxes, with their days left. Restore is prefilled with the box's old name; Delete now removes a copy early.
Kinds, limits and the CLI are on Snapshots.
Environments
One card per environment with Make default, Edit, and Delete (a dialog that asks you to type delete <name>). New environment asks for a name, description, base size (the size New box preselects for it), env vars, a setup script, and Make it the default for new boxes; repos, secret files and the credential switches are added on the card afterwards. Edit opens the card as sections, each saving on its own:
| Section | Controls |
|---|---|
| General | Name, description, base size, setup script; Save. Only a changed script mints a version. |
| Credentials a box may receive | Safe for third parties, or the channels one at a time: Secret mounts, Device keys, Phone access |
| Env vars | The list with Remove per var; NAME, value and Set to add or replace one |
| Secret files | A path relative to the box home, contents pasted or picked from a file, Set file; existing files show path, mode and size only |
| Repos | owner/name or an https URL, branch, directory, an optional script run inside the clone, blocking; Add repo |
| Versions | Every version with its box count; Upgrade N boxes to vX pins them all to the latest (one box at a time from that box's page) |
What a box receives from each field, and the limits, are on Environments.
Connectors
One card per provider; Connect opens the provider's page, which asks for a running box, the credential, the env name (the provider's conventional one is prefilled) and, for ClickHouse, the HTTPS endpoint. Done, it offers Box secrets to see the mount. See Connectors.
Secrets
Add secret asks for a name, the value, the allowed hosts, and a description. The table lists each secret's name, placeholder, hosts, mount count and last rotation.
- Rotate takes a new value and/or new hosts; the placeholder stays, so mounted boxes keep working.
- Delete is two clicks: Delete, then Confirm delete.
- Values are write-only: nothing here shows one after it is saved.
How the broker swaps the value in is on Secrets for agents.
Workspace
Everything on this page belongs to the whole team; owner-only controls say so to members. While the workspace is closing every control is read-only and the banner's Reopen is the way back.
| Section | Controls | Details |
|---|---|---|
| Icon | Upload image, Remove, and Use domain favicon once a domain is claimed | Workspace limits |
| Name | The workspace name and Save (owner) | Create one |
| Domain | Claim @yourdomain, then the auto-join and restrict-membership switches | Create one |
| Invite link | The link, Copy, and New link (owner) | Invite people |
| Members | Each member with their role; Remove (owner) or Leave (a member, on their own row) | Remove someone |
| CLI tokens | Every machine signed in with prized login, with when it was last used, the CLI version it reported and whether it registered an SSH key. Revoke per machine; Revoke all after a confirmation. | CLI tokens, Credentials Prized issues |
| Data and privacy | Zero data retention: Turn on (a typed confirmation) or Turn off | Zero data retention |
| Close workspace | Close workspace, confirmed by typing the workspace's name; while closing, the section names the deletion date instead | Closing a workspace |
| Erase now | Erase workspace now (owner), confirmed by typing the workspace's name | Closing a workspace |
Billing
Everyone in the workspace can read this page; only the owner sees the controls.
| Section | What it shows or does |
|---|---|
| Payment failed | Only while a plan payment is failing: the date and what to do |
| Plan | The current plan and its renewal date, a nudge when your boxes fit a smaller plan or outgrow this one, and the plan cards: Choose (no plan yet), Upgrade now or Switch next cycle (a second click confirms), Cancel plan, and Resume this plan while a cancel is scheduled. See Choosing and changing the plan. |
| Balance | The balance, with running low, out of credit or in overage beside it, and how long it lasts at the current burn. Add credit once buys a top-up in Checkout; the Overage checkbox is overage. |
| What you're burning | Every live box, awake or asleep, and its hourly rate right now |
| Recent activity | The last 50 ledger lines |
| Payment & invoices | Manage in Stripe opens the Stripe portal for the card, invoices and receipts |
Settings
Your account, not the workspace: what you sign in as, and where you are signed in.
| Section | Controls |
|---|---|
| Profile | Your name and Save. The email and photo come from your sign-in provider. |
| Sign-in methods | Google and GitHub (where enabled): Connect links another provider to this account by its verified email, Disconnect unlinks one. Your only sign-in method cannot be disconnected. |
| Sessions | Every browser this account is signed in from; Sign out per session, or Sign out other sessions. |
CLI tokens are per workspace, not per account, so they live under Workspace; the sign-in model is on Identity and access.
Where a setting lives
| Setting | Where |
|---|---|
| Box name | New box, at create; no rename later |
| Auto-pause, pause deadline | Box page, Overview, Auto-pause and Pause at |
| Size, region | Box page, Overview, Resize and Move region |
| Per-box env vars, environment version | Box page, Overview, Environment |
| Snapshot schedule | Box page, Overview, Automatic snapshots |
| Phone SSH password | Box page, Overview, Phone access |
| Secrets mounted on a box | Box page, Secrets tab |
| Default environment, safe for third parties | Environments |
| Workspace name, icon, domain, invite link, members | Workspace |
| CLI tokens and device SSH keys | Workspace, CLI tokens |
| Zero data retention, close, erase | Workspace, Data and privacy, Close workspace, Erase now |
| Plan, top-ups, overage, card, invoices | Billing (owner) |
| Sign-in providers, browser sessions | Settings |
| CLI usage telemetry | Not in the dashboard: CLI: usage telemetry |
| Dashboard analytics | Your browser's Do Not Track setting: Privacy |
Something unclear or out of date?
API reference
Every HTTP route a CLI token can call. The control plane at api.prized.dev/api/v1 creates and manages boxes, snapshots, environments and secrets; the edge runs commands, moves files, prompts the box's agent and stops its desktop. No SDK and no OpenAPI document yet; this page is the contract.
Workspaces
One account for the whole team; boxes, balance, and secrets shared by everyone in it.