Runnable example projects built with the cmssy headless SDK.
Each directory is a standalone app. There is no workspace and no root manifest, so a fork inherits nothing:
git clone https://github.com/cmssy-io/examples
cd examples/simple-blog
pnpm install
cp .env.example .env.local
pnpm devEvery example ships an .env.example pointing at the public cmssy demo workspace, so a fresh
clone renders real content without a cmssy account. Point one at your own workspace with
npx @cmssy/cli link --token cs_....
| Example | Framework | What it shows |
|---|---|---|
| simple-blog | Next.js | Blog listing with a server loader, rich text, model records bound via fields.relation |
| next-storefront | Next.js | Commerce: products, categories, cart, checkout, member accounts and orders as Server Actions |
| astro-storefront | Astro | The catch-all route, block registry and verified edit mode on the Astro adapter |
| remix-storefront | React Router 7 | The same, on React Router (Remix) |
All four point at the same cmssy-demo workspace - one set of content, four unrelated frontends,
none of which the CMS knows about.
That is the goal, not yet the state. Today only next-storefront implements the blocks that
workspace uses. simple-blog renders its /blog listing but a blank home page; the Astro and
React Router examples register a single hero block that no page uses, so they render nothing at
all. examples.json records which examples are asserted in CI and why the others are not.
Bringing them to the same block set is in progress.
Example code that nobody builds rots. Tutorials on cmssy.com once taught SDK APIs that had never existed, because prose has no compiler.
The plan is that every example here is built in CI against the packed tarballs of the SDK - the artifact you install, not a symlink into a monorepo - with the build asserting that a page actually renders, not just that it compiles, so an SDK change that breaks an example turns its pull request red. That CI does not exist yet; until it does, these examples are verified by hand.
npx @cmssy/cli init- generates this same wiring into an app you already have, if you want an empty starting point rather than a finished one.- Documentation