Skip to content

docs: expand Maincloud deployment page#4316

Merged
clockwork-labs-bot merged 5 commits intomasterfrom
bot/expand-maincloud-docs
Feb 17, 2026
Merged

docs: expand Maincloud deployment page#4316
clockwork-labs-bot merged 5 commits intomasterfrom
bot/expand-maincloud-docs

Conversation

@clockwork-labs-bot
Copy link
Collaborator

Rewrites the Maincloud deployment guide from a bare-bones stub into a comprehensive page. Addresses all three points from #3108 plus a community request for the connection URI.

New content:

  1. Finding your module on the dashboard - Direct URL (spacetimedb.com/my-module) and profile page navigation
  2. Database lifecycle - Running vs suspended states, automatic suspension after inactivity, automatic resumption on first request
  3. Next steps section - Links to dashboard, SpacetimeAuth setup, quickstart guides, and usage monitoring

Also added:

  • Prerequisites section (CLI install + spacetime login to link web account)
  • Publishing workflow (initial publish, hot-swap updates, --delete-data)
  • Client connection code examples for TypeScript, C#, Rust, and C++ with the Maincloud host URL (https://maincloud.spacetimedb.com) - per community request in Docs - Expand "Deploying: Maincloud" page #3108
  • Database deletion instructions
  • Link to pricing page

Closes #3108

Rewrote the Maincloud deployment guide to cover:

- Prerequisites: CLI install and login flow to link web account
- Publishing: initial publish, hot-swap updates, clearing data
- Client connection: host URL (https://maincloud.spacetimedb.com) with
  code examples for TypeScript, C#, Rust, and C++
- Web dashboard: how to find your database (direct URL and profile),
  dashboard features (logs, SQL console, SpacetimeAuth)
- Database lifecycle: running vs suspended states, automatic
  suspension/resumption behavior
- Deleting a database
- Next steps: dashboard, auth, quickstarts, usage monitoring

Closes #3108
- Database can now be manually paused and resumed from the dashboard
- Pausing stops energy usage while preserving data
- Added usage breakdown details (bytes scanned/written, index seeks,
  CPU instructions, bandwidth, table storage)
- Added 24-hour stats (CCU, rows per table, transactions)
- Fix API: withModuleName -> withDatabaseName (2.0 rename)
- Fix direct URL to include @username/database format
- Clarify auto-suspension is Free tier only; Pro/Team never
  auto-suspend with pay-as-you-go enabled
- Note startup time is typically less than 1 second
- Fix delete command to use my-database
Copy link
Contributor

@cloutiertyler cloutiertyler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This now LGTM

- /spacetimeauth -> /core-concepts/authentication/spacetimeauth
- /authentication -> /core-concepts/authentication
- /quickstart -> /quickstarts/react
@clockwork-labs-bot clockwork-labs-bot added this pull request to the merge queue Feb 17, 2026
Merged via the queue into master with commit 8a2208b Feb 17, 2026
31 of 32 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs - Expand "Deploying: Maincloud" page

2 participants