My Site
← Back to blog

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 definitions
  • src/app/ — Next.js App Router pages
  • src/components/ — reusable React components
  • src/lib/content.ts — content reading utilities
  • content/ — JSON content files (one per document)
  • public/uploads/ — media files (images, PDFs, etc.)

Adding Content

You can edit content in two ways:

  1. CMS Admin — run npx @webhouse/cms-admin-cli and edit visually
  2. JSON files — edit content/posts/*.json directly

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.