@edward-hyde/template-next

A CLI tool for creating reusable Next.js starter apps with TypeScript, React Compiler, Turbopack, shadcn/ui preset b1YmqvjRA, and next-themes.

Features

• Next.js 16 with App Router, TypeScript, and src/ directory
• React Compiler enabled by default
• Turbopack enabled for development
• Tailwind CSS for styling
• Shadcn/ui preset b1YmqvjRA pre-configured
• AGENTS.md included by default for up-to-date Next.js coding guidance
• next-themes included for theme support
• Prettier with Tailwind plugin for code formatting
• Automatic formatting before setup completes
• VSCode settings optimized for development
• Clean project structure with junk files removed
• Version pinning for reliable builds
• Git initialization with initial commit

Installation & Usage

Quick Start

# Create a new project
npx @edward-hyde/template-next my-awesome-app

# Navigate to project
cd my-awesome-app

# Start development server
npm run dev

System requirements: Node.js 20.9+ (required by Next.js 16)

Advanced Usage

# Use latest versions (potentially unstable)
npx @edward-hyde/template-next my-app --latest

# Choose a package manager (npm, pnpm, yarn, bun)
npx @edward-hyde/template-next my-app --pm pnpm

# Pick which shadcn/ui components to add
npx @edward-hyde/template-next my-app --components button,card,input

# Skip optional features
npx @edward-hyde/template-next my-app --no-themes --no-prettier

# Run non-interactively with all defaults (no prompts)
npx @edward-hyde/template-next my-app --yes

# Skip git initialization
npx @edward-hyde/template-next my-app --skip-git

# Skip dependency installation
npx @edward-hyde/template-next my-app --skip-install

# Show version information
npx @edward-hyde/template-next versions

| Flag | Description | | --- | --- | | --pm <manager> | Package manager to use: npm (default), pnpm, yarn, or bun. | | --components <list> | Comma-separated shadcn/ui components to add (default button). | | --no-themes | Skip next-themes (dark mode) support. | | --no-prettier | Skip Prettier setup. | | --yes | Accept defaults and skip all prompts. | | --latest | Use latest versions instead of the pinned/stable set. | | --skip-git | Skip git initialization. | | --skip-install | Skip the dependency install (shadcn still installs its own deps). | | --here | Initialize in the current directory (same as .). |

Notes:

• Run interactively (omit the flags) and you'll be prompted for the package manager, components, and optional features. The package-manager prompt defaults to whichever manager you launched the command with (auto-detected).
• When scaffolding into ., use a lowercase directory name because it becomes the npm package name.
• Dependencies are merged into package.json and resolved in a single install pass before shadcn runs, so scaffolding is noticeably faster than installing each package separately.
• When Prettier is enabled, the generated project is formatted before setup finishes.

What's Included

Dependencies

• Next.js - React framework with App Router
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework
• Shadcn/ui preset b1YmqvjRA - Beautiful, accessible UI components
• next-themes - Theme switching support
• Lucide React - Icon library (via Shadcn)

Development Tools

• Prettier - Code formatting
• ESLint - Code linting
• VSCode settings - Optimized development experience

Scaffold Defaults

template-next/
├── src/
│ ├── app/
│ │ ├── globals.css
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── components/
│ │ ├── theme-provider.tsx
│ │ └── ui/
│ └── lib/
├── AGENTS.md
├── .prettierrc
├── .vscode/settings.json
├── components.json
├── next.config.ts
├── postcss.config.mjs
├── eslint.config.mjs
├── tsconfig.json
└── package.json

Adding Components

# Add Shadcn/ui components as needed
npx shadcn@latest add card
npx shadcn@latest add input
npx shadcn@latest add dialog

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Lint code with ESLint
• npm run format - Format code with Prettier
• npm run format:check - Check formatting without writing changes

Version History

v0.4.2

• Run create-next-app non-interactively with --yes
• Preserve package-managed git setup by disabling upstream git init
• Include Next.js agent guidance files by default
• Switch to the b1YmqvjRA shadcn/ui preset

v0.4.0

• Switch scaffold execution to npm exec for more reliable local and packaged runs
• Use the abkeIa shadcn/ui preset with next-themes
• Update landing page and layout templates
• Fix TypeScript theme provider typing and font variable wiring
• Run formatting automatically before setup completes

v0.3.2

• Bump scaffold to Next.js 16 (requires Node 20.9+)

v0.3.0 & v0.3.1

• Complete CLI rewrite with modern architecture
• Version pinning for reliable builds
• Improved project templates
• Better error handling and user experience

v0.2.8

• Previous git clone-based approach

Contributing

Feel free to contribute by submitting pull requests or opening issues.

Support

• GitHub: template-next
• Website: template-next-official.vercel.app
• Author: Thilina Rathnayaka (Edward Hyde)

License

MIT License (c) 2024 Thilina Rathnayaka (Edward Hyde)