Next.js Boilerplate

A minimal boilerplate to quick start new projects with Next.js, TypeScript, and modern tooling.

Tech Stack

• Next.js 16 with Turbopack
• React 19
• TypeScript 5
• CSS Modules
• Vitest + React Testing Library
• Storybook 10
• ESLint 9 + Prettier
• Husky + lint-staged
• Commitlint

Getting Started

npx create-next-app -e https://github.com/helderburato/nextjs-boilerplate

Install dependencies and run the development server:

npm install
npm run dev

Open http://localhost:3000 with your browser.

Scripts

Command	Description
npm run dev	Start dev server (Turbopack)
npm run build	Production build
npm start	Start production server
npm test	Run tests
npm run test:watch	Run tests in watch mode
npm run lint	Run ESLint
npm run format	Format with Prettier
npm run storybook	Start Storybook
npm run generate	Scaffold a new component

Component Generator

Generate a new component with all boilerplate files:

npm run generate

This creates:

• index.tsx - Component
• ComponentName.module.css - Styles
• stories.tsx - Storybook story
• test.tsx - Test file

Deploy on Vercel

The easiest way to deploy your Next.js app is to use Vercel.

Check out Next.js deployment documentation for more details.