Docusaurus migration

[JulienLavocat]

Description of Changes

• Migrate the documentation site to Docusaurus.
• Add a GitHub Action workflow that runs pnpm build on pull requests targeting master.
  This command checks for broken links and images and ensures the site builds correctly.
• Add a GitHub Action workflow to publish the docs automatically when a merge occurs on the docs/release branch.

Important: The workflows haven't been tested yet due to the fact that they need to be merged first before being able to run. It's a fairly basic workflow I don't expect this to block anyone but anyways I will make another PR with the complete changes when I can actually run it.

---

API and ABI Breaking Changes

No breaking changes for SpaceTimeDB users.
Documentation contributors should experience minimal disruption — content is still written in Markdown.

---

Expected Complexity Level and Risk

Complexity: 3/5

Reasons:

1. Several adjustments were made to fit Docusaurus conventions:

   • Replaced our custom :::server-rust blocks with Docusaurus <Tabs/> components.
   • Converted “Note” callouts using admonitions instead of Markdown blockquotes.
   • Updated all images (including Unity tutorial ones, which were previously commented out).
   • Moved images from the DO bucket into the repository at docs/static/images.

2. Customized Docusaurus CSS and one component to apply our theme and color palette.

---

Testing

Tested locally.

---

Review Notes

This PR involves many file changes — a full code review is likely not productive.
Instead, please focus on verifying that the documentation content was migrated correctly:

• Review sections you’re familiar with to confirm accuracy.
• Ensure formatting, links, and images render as expected.

You can follow the updated README for instructions on running Docusaurus locally.

[jdetter]

One question on this one so far, otherwise the rest of the edits look good to me

[JasonAtClockwork]

I've reviewed the entire Unreal tutorial and it looks 100% (all links, code and images), the only thing is it looks like new version is missing the Unreal Reference from the Client SDK:

New:

Old:

[jdetter]

Reminder that I still needed to run this command in order to get the docs rendering:

pnpm add @docusaurus/theme-common

[jdetter]

I've reviewed a majority of the documentation and I think it looks good. There are just 2 issues to fix here I think:

1. Fix the issue with having to manually install @docusaurus/theme-common
2. Fix the code formatting issues in the Unity tutorial

besides that I think this is ready to go. Let me know when you want me to take another look 👍

[JulienLavocat]

the only thing is it looks like new version is missing the Unreal Reference from the Client SDK:
Added @JasonAtClockwork

[JasonAtClockwork]

the only thing is it looks like new version is missing the Unreal Reference from the Client SDK:
Added @JasonAtClockwork

Looks great! All the Unreal stuff is complete.

[jdetter]

Few more formatting issues here

[jdetter]

I committed some small formatting issues that I found. Other than that I don't have any issues here with the docs. The only remaining issue was the error when I tried to npm install. Thanks Julien 👍

The error for reference was:

boppy@geralt MINGW64 ~/clockwork/SpacetimeDB/docs (docusaurus-migration)
$ pnpm install
Scope: all 5 workspace projects
..                                       |  WARN  Broken lockfile: no entry for 'tsup@8.5.0(jiti@2.5.1)(postcss@8.5.6)(tsx@4.20.4)(typescript@5.9.3)' in pnpm-lock.yaml
 ERR_PNPM_LOCKFILE_MISSING_DEPENDENCY  The lockfile is broken! Resolution step will be performed to fix it.
../crates/bindings-typescript            |  WARN  Could not find preferred package tsup@8.5.0(jiti@2.5.1)(postcss@8.5.6)(tsx@4.20.4)(typescript@5.9.3) in lockfile

    WARN  2 deprecated subdependencies found: node-domexception@1.0.0, source-map@0.8.0-beta.0
..                                       |  +12  -11 +-
..                                       | Progress: resolved 1619, reused 1554, downloaded 6, added 12, done
 WARN  Issues with peer dependencies found
docs
└─┬ @types/react-dom 18.3.7
  └── ✕ unmet peer @types/react@^18.0.0: found 19.1.13

Done in 6.2s