Skip to content
Sign inJoin waitlist

Install and run — Cerette Next.js

Cerette runs on Node.js with the usual Next.js commands: install the packages once, then start the development server and edit while the page updates by itself.

Node.js 20.9 or newer (node -v). Download at https://nodejs.org — the LTS build is fine.
A package manager npm comes with Node. pnpm, yarn and bun work too.
A code editor VS Code is a good default; any editor works.
A browser Chrome, Edge, Firefox or Safari.
An internet connection The fonts (Plus Jakarta Sans, Marcellus, Inter) are downloaded from Google Fonts when the site builds, and the first time npm run dev runs. The site then serves them from your own domain.

No database, no account, no paid service. Every page is pre-rendered; only the inquiry forms run on the server.

Unzip the template, open the folder in a terminal and run:

Terminal window
npm install

This downloads the packages listed in package.json into node_modules/. It takes a few minutes the first time.

Terminal window
npm run dev

Open http://localhost:3000. Save a file and the page updates by itself.

Command What it does
npm run dev Development server with live reload
npm run build Production build — every page is pre-rendered as HTML, and the types are checked
npm start Serves the production build locally (run build first)
npm run lint Checks the code with ESLint. npm run build doesn’t run it, so run it yourself before you publish.
npx tsc --noEmit Checks the types without building. It reads the route types that npm run dev and npm run build generate, so run one of them once first.

Run npm run build before publishing. It checks the types, so it catches a missing field or a typo in a content file that the development server tolerates.

Cerette is built on Next.js 16.4, which differs from older versions in ways you may notice:

  • Turbopack is the bundler for both npm run dev and npm run build; there is nothing to configure.
  • next lint no longer exists: npm run lint runs ESLint directly (eslint.config.mjs), which is why npm run build doesn’t lint.
  • An AGENTS.md may appear. If you work with an AI coding assistant, npm run dev adds an AGENTS.md (and a CLAUDE.md that points to it) to the project root, telling the assistant to read the Next.js documentation bundled in node_modules/next/dist/docs/ before it writes code. That is Next.js’s own behaviour: keep the files if the assistant helps you, delete them if not; the site doesn’t use them.
  • Server actions carry the inquiry forms, so the site needs a host that runs Node.js: it can’t be exported as plain static files (Going live).
src/
app/ one folder per route; also the home-screen icon, sitemap.ts and robots.ts
page.tsx Home
about/ /about
project/ /project (every project) and /project/<slug> (one page per project)
service/ /service (every service) and /service/<slug> (one page per service)
blog/ /blog (every post, loaded a page at a time) and /blog/<slug> (one page per post)
contact/ /contact, with the inquiry form
legal/ /legal/<slug> (the Privacy Policy and the Terms of Service)
not-found.tsx the 404 page
style-guide/ every component with examples (noindex; delete the folder to remove it)
layout.tsx the fonts, the site's metadata and browser icons, the header and the footer
apple-icon.png the icon on a phone's home screen
globals.css Tailwind and the design tokens
components/
sections/ the sections pages are made of (HomeHero, ProjectStory, InquirySection, …)
site/ Header (with the phone menu) and Footer
content/
site.ts name, title, description, domain, menu, the "Let's talk" button, social links, booking link,
phone, e-mail and address, the footer
pages/*.ts the copy of one page each, including its title and description; project.ts, service.ts,
blog.ts (postPage) and legal.ts hold the fixed words of every project, service, post and legal
page; cta.ts the closing call to action; forms.ts the inquiry forms
collections/*.ts projects, services, testimonials, team, posts and legal pages
routes.ts every URL in the site, in one place
types.ts the shape of all content
design-system/ tokens and reusable components — see its own README
lib/
content.ts the only way pages read collections (swap this for a CMS, see cms.md)
actions-contact.ts what the inquiry form on Contact and Services sends
actions-service.ts what the inquiry form on a service's page sends
forms/ form providers (console, webhook, Mailchimp, Resend) and their guide
meta.ts the canonical link, share image and title of a page
format.ts dates, phone links and search descriptions
to-ui.ts turns collection items into what the cards show
image-size.ts reads the size of an image in public/ (not used by the pages as shipped)
public/
images/ photos (/images/<file>) and grain.png, the texture laid over some photos
icon.svg the browser icon (it turns white in a dark browser theme)
opengraph-image.png the picture shown when a link is shared
.env.example the settings of the forms (copy it to .env.local)

Delete src/app/style-guide/ if you don’t want the component gallery on your site; nothing else depends on it.

  • Install the Tailwind CSS IntelliSense and ESLint extensions for class name and code hints.
  • The project is TypeScript: your editor tells you when a content file is missing a field, before you open the browser.
  • Search across files (Ctrl/Cmd + Shift + F) for a phrase you see on the demo site to find the file that holds it.

Keep your edits in src/content/, public/ and theme.css where possible. When a new version of the template ships, you can copy your content folder into the new release instead of re-applying changes by hand. CHANGELOG.md lists what changed.