create-frontnova

🚀 Kickstart modern frontend projects with ease. A CLI tool that scaffolds Next.js or Vite+React projects with pre-configured features like UI libraries, state management, authentication, and more.

Features

• ⚡ Fast Setup - Get a production-ready project in minutes
• 🎨 UI Libraries - Pre-configured shadcn/ui or Material-UI
• 🔧 Modern Stack - Next.js 14+ or Vite 5+ with React 18
• 📦 Package Managers - Support for npm, yarn, pnpm, and bun
• 🎯 TypeScript First - Full TypeScript support out of the box
• 🎨 Tailwind CSS - Pre-configured with sensible defaults

Quick Start

npx create-frontnova my-app

Or use with a specific package manager:

pnpm create frontnova my-app
yarn create frontnova my-app
bun create frontnova my-app

What You Get

Framework Options

• Next.js - React meta-framework with SSR, App Router, and more
• Vite + React - Lightning-fast build tool with React

UI Libraries

• shadcn/ui - Beautiful, accessible components built with Radix UI and Tailwind CSS
• Material-UI - Comprehensive React component library
• None - Plain Tailwind CSS (always included)

Core Features

• ✅ TypeScript (always enabled)
• ✅ ESLint (optional)
• ✅ Prettier (optional)
• ✅ Path aliases with @/ prefix (optional)

Usage

After running the CLI, you'll be prompted to select:

1. Runtime - Node.js or Bun
2. Framework - Next.js or Vite+React
3. Package Manager - npm, yarn, pnpm, or bun
4. Core Features - ESLint, Prettier, Path aliases
5. State Management - Redux, Zustand, Jotai, Context API, or None
6. UI Library - shadcn/ui, Material-UI, or None
7. Authentication - NextAuth, Better Auth, Manual, or None
8. Database - Prisma, Drizzle, or None

Examples

Next.js with shadcn/ui

npx create-frontnova my-saas-app
# Select: Next.js, shadcn/ui

Vite + React with Material-UI

npx create-frontnova my-dashboard
# Select: Vite+React, Material-UI

Generated Project Structure

my-app/
├── src/
│   ├── app/          # Next.js App Router (or src/ for Vite)
│   ├── components/   # React components
│   └── lib/          # Utilities (if shadcn/ui selected)
├── public/           # Static assets
├── package.json
├── tsconfig.json
└── tailwind.config.ts

Development

Prerequisites

• Node.js >= 18.0.0
• pnpm (recommended) or npm/yarn

Setup

# Clone the repository
git clone https://github.com/your-org/create-frontnova.git
cd create-frontnova

# Install dependencies
pnpm install

# Build
pnpm build

# Run in development mode
pnpm dev

Testing

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

License

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

Acknowledgments

• Inspired by create-next-app and create-react-app
• Built with inquirer for interactive prompts
• Templates use modern best practices from the React ecosystem

Roadmap

• [ ] Add more state management options (Recoil, Valtio)
• [ ] Add more UI libraries (Chakra UI, Ant Design)
• [ ] Add more authentication providers
• [ ] Add more database options (Supabase, Firebase)
• [ ] Support for Remix and other frameworks
• [ ] Template versioning system

Support

If you encounter any issues or have questions, please open an issue on GitHub.

Made with ❤️ by the create-frontnova team