Quickstart Guide
Build and ship your first cmssy page end-to-end in a few minutes.
1
Install the SDK
Add
@cmssy/next + @cmssy/react to a Next.js (App Router) app and create cmssy/config.ts. See Installation for the full setup - or clone the cmssy-web reference repo and point it at your workspace.2
Define a block
Create
blocks/hero/block.ts with defineBlock + fields and a React component in blocks/hero/src/, then register it in cmssy/blocks.ts. Run pnpm dev.3
Create a page in the admin
Sign in at cmssy.io, open your workspace, click Pages → Add Page, and give it a name and slug.
4
Add your block & edit content
Open the page editor - your site is framed for live preview. Drag your Hero block onto the canvas and edit its fields in the right panel; changes appear instantly.
5
Publish
Click Publish. Your published content is served from the cmssy delivery API.
6
Live on your site
Deploy your Next.js app (e.g. on Vercel) - it renders the published content via
CmssyServerPage. Next, explore the Blocks guide and the MCP Server for AI-assisted editing.