Getting Started with the Next.js Boilerplate
by webhouse.app
getting-startedtutorial
Quick Start
npm install
npm run dev
Open http://localhost:3000 in your browser.
Project Structure
cms.config.ts— collection and field definitionssrc/app/— Next.js App Router pagessrc/components/— reusable React componentssrc/lib/content.ts— content reading utilitiescontent/— JSON content files (one per document)public/uploads/— media files (images, PDFs, etc.)
Adding Content
You can edit content in two ways:
- CMS Admin — run
npx @webhouse/cms-admin-cliand edit visually - JSON files — edit
content/posts/*.jsondirectly
Adding a New Post
Create a new file in content/posts/:
{
"slug": "my-new-post",
"status": "published",
"data": {
"title": "My New Post",
"excerpt": "A short summary.",
"content": "## Hello\n\nThis is my post.",
"date": "2026-03-28",
"author": "Your Name"
},
"id": "my-new-post",
"_fieldMeta": {}
}
The dev server picks up changes automatically — no rebuild needed.