@theholocron/nextjs-template

A modern Next.js template with pre-configured tools, best practices, and CI/CD setup for rapid application development.

Getting Started

Use the Holocron CLI to scaffold a new Next.js project. It clones the template, renames all placeholder references, wires up your vault provider, and runs holocron setup in one step:

npx @theholocron/cli new nextjs my-app \
  --description "My app description" \
  --homepage "https://my-app.example.com" \
  --vault doppler \
  --agent claude

This will:

1. Create theholocron/my-app from this template on GitHub
2. Replace all nextjs-template references with my-app throughout the repo
3. Run pnpm install (including Playwright browser download)
4. Run holocron setup to configure branch protection, labels, workflows, and repo settings

Development

This repo uses pnpm workspaces.

pnpm dev              # start Next.js dev server
pnpm build            # production build
pnpm start            # serve production build
pnpm start:storybook  # start Storybook dev server
pnpm test             # run Storybook interaction tests
pnpm test:coverage    # run tests with coverage
pnpm typecheck        # tsc --noEmit
pnpm lint             # lint via super-linter (Docker)

What's Included

Tool	Purpose
Next.js 16	React framework with App Router
React 19	UI framework
TypeScript	Type safety
Storybook	Component development and interaction testing
Vitest	Test runner with browser mode
Playwright	Browser automation for play tests
MSW	API mocking
ESLint	Linting
Stylelint	CSS linting
Prettier	Formatting
semantic-release	Automated releases

Releases

Releases are automated via semantic-release on push to main. See CHANGELOG.md for the release history.