This is a production-ready Next.js template featuring a comprehensive development environment with modern tooling, testing infrastructure, and CI/CD pipeline. Perfect for building static-export applications with built-in LLM integration capabilities.

Click "Use this template" button on GitHub or clone the repository:

git clone {{REPOSITORY_URL}} cd {{PROJECT_NAME}}

Run the setup script to replace template placeholders:

npm run setup

This will prompt you for:

• Project name
• Project description
• Author information
• Repository URL
• App name and descriptions
• Feature descriptions

npm install

npm run dev

Open http://localhost:3000 to see your application.

• Next.js 15 with App Router and TypeScript
• React 19 with latest features
• Tailwind CSS v4 for styling
• Static Export ready for deployment

• Vitest for unit testing
• MSW for API mocking
• React Testing Library for component testing
• Coverage reporting with thresholds

• Biome for linting and formatting
• TypeScript strict mode
• Husky git hooks
• Conventional commits with Commitizen

• GitHub Actions workflow
• Semantic Release for versioning
• Automated deployment to GitHub Pages
• Security audits and quality gates

• WebAssembly support configured
• Multi-provider architecture
• Privacy-first approach with local processing
• Mock APIs ready for integration

├── src/ │ ├── app/ # Next.js App Router │ │ ├── layout.tsx # Root layout │ │ ├── page.tsx # Home page (customizable) │ │ └── globals.css # Global styles │ ├── components/ # Reusable components │ ├── lib/ # Utilities and API functions │ ├── mocks/ # MSW mock handlers │ ├── stories/ # Storybook stories │ └── types/ # TypeScript type definitions ├── public/ # Static assets ├── .github/workflows/ # CI/CD configuration └── Configuration files # Various config files 

npm run dev # Start development server npm test # Run tests in watch mode npm run coverage # Generate test coverage report npm run lint # Check code quality npm run lint:fix # Auto-fix linting issues npm run type-check # TypeScript type checking

npm run test:run # Run tests once (CI mode) npm run test:ui # Open Vitest UI npm run coverage # Generate coverage report

npm run build # Build for production npm run storybook # Start Storybook npm run build-storybook # Build Storybook

npm run commit # Interactive conventional commit npm run release:dry # Preview release

The following placeholders will be replaced during setup:

Package.json:

• {{PROJECT_NAME}} - NPM package name
• {{PROJECT_DESCRIPTION}} - Project description
• {{REPOSITORY_URL}} - Git repository URL
• {{AUTHOR_NAME}} - Author name
• {{AUTHOR_EMAIL}} - Author email
• {{LICENSE}} - License type

Application Content:

• {{APP_NAME}} - Application display name
• {{APP_DESCRIPTION}} - Application description
• {{FEATURE_X_TITLE}} - Feature titles (1-4)
• {{FEATURE_X_DESCRIPTION}} - Feature descriptions (1-4)
• {{CTA_TITLE}} - Call-to-action title
• {{CTA_DESCRIPTION}} - Call-to-action description
• {{CTA_BUTTON_TEXT}} - Button text

Create a .env.local file for local development:

# Add your environment variables here NEXT_PUBLIC_APP_NAME="{{APP_NAME}}"

• Vitest configuration with React Testing Library
• Coverage thresholds: 80% statements/functions/lines, 70% branches
• Co-located tests: Tests next to source files

• MSW for realistic API mocking
• Handlers for all endpoints
• Browser and Node environments supported

• MSW Provider for development
• Storybook for component testing
• E2E ready structure

• GitHub Pages deployment on main branch push
• Quality gates ensure code quality
• Semantic versioning with automated releases
• Static export optimized for CDN

npm run build # Generate static export npx serve out # Test locally

• Replace colors in tailwind.config.ts
• Update logo in public/ directory
• Modify src/app/layout.tsx for metadata

• Create components in src/components/
• Add pages in src/app/
• Update API layer in src/lib/api.ts

• Update next.config.ts for providers
• Implement actual API calls in src/lib/api.ts
• Replace MSW mocks with real endpoints

• Modify .github/workflows/ci.yml
• Update deployment targets
• Configure secrets and variables

• CLAUDE.md - AI assistant guidance
• CONTRIBUTING.md - Contribution guidelines
• CHANGELOG.md - Version history
• biome.json - Code quality configuration
• vitest.config.ts - Testing configuration

Component documentation and development environment:

npm run storybook

• Dependency auditing in CI/CD
• No server-side attack vectors (static export)
• Privacy-first LLM integration
• Secure defaults throughout

npm run security:check # Check for vulnerabilities npm audit # Dependency audit

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Create a pull request

See CONTRIBUTING.md for detailed guidelines.

This project is licensed under the {{LICENSE}} License - see the LICENSE file for details.

If you encounter any issues or have questions:

1. Check the documentation
2. Search existing GitHub issues
3. Create a new issue with detailed information
4. Refer to CLAUDE.md for AI assistant guidance

• Add more component examples
• Implement additional LLM providers
• Add E2E testing setup
• Create deployment guides
• Add internationalization support

Built with modern web development best practices and inspired by the Next.js community. Special thanks to all contributors and the open-source ecosystem.

Happy coding! 🎉