@theholocron/react-template

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

Getting Started

Use the Holocron CLI to scaffold a new React 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 react 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 react-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 dev server
pnpm build         # production build
pnpm preview       # serve production build locally
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
React 19	UI framework
Vite	Build tool and dev server
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.