Developer docs · v0.2

Build on the edge.

Model content, read it from the nearest cache, write it as commands you can review. These guides are the Markdown in the open-source repo, rendered here.

Start the quickstart skyvis-my/edgecms
bash · clone to first public read
git clone https://github.com/skyvis-my/edgecms
cd edgecms && bun install
bun run db:migrate:local
bun run db:seed:smoke
bun run dev:api     # API on :8787
bun run dev:admin   # admin on :5173
# publish an entry in the admin, then:
curl localhost:8787/api/tenants/smoke/api/public/smoke-posts/<slug>

FigHow EdgeCMS ships

How a change reaches the edge.

Promote, draft↔published, locale resolution, and the visual-edit loop — the same cards as the home page.

Immutable snapshot, then flip the published pointer. Roll back by pointing at the previous release.
One origin serves draft and published. A header or cookie selects the channel — no second stack.
Public reads report which locale each field resolved from. Locale-exact fields never cascade — promote refuses gaps.
Click-to-edit overlays on the draft host. Edits PATCH the entry on the same Worker — then promote when ready.

01Start

Run it locally and read your first entry.

  1. 01QuickstartClone, migrate, seed and read your first published entry.
  2. 02Content modelCollections, fields, locales, relations and the entry lifecycle.
  3. 03Public APITenant-scoped read routes, query parameters, caching and errors.

02Build

Write content, ship it to your frontend.

  1. 04Frontend integrationFetch published content from any frontend.
  2. 05Client SDKTyped fetching and rich-text rendering with @edgecms/client.
  3. 06Commands and admin APIEvery write is a typed command: envelope, dry run, versions.
  4. 07MediaUploads, image variants, limits and asset routes.
  5. 08WebhooksEvents, delivery, retries and replay.

03Releases and partners

Atomic promote, visual edit and the design-partner dry-run.

  1. 09Atomic Edge PromoteSnapshots, channel promote/rollback, locale provenance and visual edit.
  2. 10Latency opsJoin-key dashboards and alerts for preview and delivery — no public numeric SLOs.
  3. 11Design-partner pilotICP boundaries, demo loop and honest claim map for first pilots.
  4. 12Partner demo (5 min)Scripted edit → promote → rollback path for external demos.

04Secure

Who can sign in, and what they can do.

  1. 13Auth and accessSign-in, invites, MFA, roles, ABAC and tenant states.
  2. 14Operations and securityAudit, SIEM sink, rate limits, headers and backups.
  3. 15WCAG 2.2 AA (Admin)Admin and visual-edit baseline plus axe CI gate.
  4. 16GDPR + Malaysia PDPAInventory, retention, consent and DSAR seams.

05AI and agents

Agents propose, people approve.

  1. 17MCP serverGive agents tenant-scoped tools over the Model Context Protocol.
  2. 18AI command safetyHow AI edits are previewed, approved and audited.

06Extend

Plugins and hooks for hosts.

  1. 19Plugin SDKTrusted plugins: fields, hooks, routes and admin UI.
  2. 20Sample pluginsWorked plugin examples to copy from.
  3. 21Hosting seamsPolicies for running EdgeCMS as a multi-customer service.

07Deploy

Your own Cloudflare account.

  1. 22Deployment runbookBindings, secrets, migrations and rollback on your own account.
  2. 23Supply chainLockfile discipline, CycloneDX SBOM and light SLSA hygiene.
  3. 24SemVer and commitsConventional Commits and Changesets package policy.