Now with AI-powered page building via MCP Server
Skip the boilerplate with the starter

Want a head start? Clone cmssy-io/cmssy-next-starter - a ready-made Next.js app wiring all of the steps below, with three example blocks (hero, prose, blog-index) - or deploy it to Vercel in one click. Try it instantly with the demo workspace slug cmssy-demo.

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.
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 createCmssyPage (your app/[[...path]]/page.tsx). Next, explore the Blocks guide and the MCP Server for AI-assisted editing.