Skip to content

Overhaul README with up-to-date content#4500

Open
clockwork-labs-bot wants to merge 1 commit intomasterfrom
bot/update-readme
Open

Overhaul README with up-to-date content#4500
clockwork-labs-bot wants to merge 1 commit intomasterfrom
bot/update-readme

Conversation

@clockwork-labs-bot
Copy link
Collaborator

The README was significantly out of date. This overhaul brings it in line with the current docs and product state.

What changed

Content updates:

  • "What is SpacetimeDB" now mentions all 4 module languages (Rust, C#, TypeScript, C++) instead of only Rust
  • Removed the smart contracts comparison (outdated framing)
  • Updated BitCraft description to match current docs wording
  • Shortened the architecture description to be punchier

New Quick Start section:

  • 5-step flow: install, login, init, dev, publish
  • Introduces spacetime dev (the primary local development experience)
  • Introduces spacetime publish to Maincloud
  • Much more approachable than the old "Installation" wall of text

New "How It Works" section:

  • Rust module code example showing tables and reducers
  • TypeScript client code example showing useTable subscriptions
  • Shows the core value prop in < 20 lines of code

Language support:

  • Added TypeScript and C++ as server module languages
  • Added Unreal Engine (C++) as a client SDK
  • Listed all supported web frameworks (React, Next.js, Vue, Svelte, Angular, Node.js, Bun, Deno)
  • Fixed all doc links to current URL patterns (/docs/quickstarts/...)

Build from source:

  • Collapsed into expandable <details> sections (macOS/Linux and Windows)
  • Removed duplicate Git for Windows instructions
  • Still complete, just not the first thing you see

Badges:

  • Added npm download count badge for the TypeScript SDK

License:

  • Shortened to essentials with link to full license file

Major changes:
- Update 'What is SpacetimeDB' to mention all 4 module languages
  (Rust, C#, TypeScript, C++) instead of only Rust
- Replace verbose installation section with concise quick start flow:
  install, login, init, dev, publish
- Add spacetime dev workflow (the primary local dev experience)
- Add Maincloud deployment step
- Add 'How It Works' section with Rust module + TypeScript client
  code examples showing tables, reducers, and subscriptions
- Update language support tables to include TypeScript modules,
  C++ modules, and Unreal Engine SDK
- List all supported client frameworks (React, Next.js, Vue, Svelte,
  Angular, Node.js, Bun, Deno)
- Fix doc links to current URL patterns (/docs/quickstarts/...)
- Collapse build-from-source instructions into expandable details
  sections (macOS/Linux and Windows) to reduce visual clutter
- Remove stale smart contracts comparison
- Remove duplicate Git for Windows instructions
- Add npm download badge
- Shorten license section (link to FAQ for details)
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.

1 participant