NextPy CLI

> Scaffold full-stack FastAPI + Next.js applications in seconds

![npm version](https://www.npmjs.com/package/nextpy)
![License: MIT](https://opensource.org/licenses/MIT)

NextPy is a powerful CLI tool that helps you quickly scaffold modern full-stack applications with FastAPI backend and Next.js frontend, complete with Docker support and multiple database options.

🚀 Quick Start

$3

``bash npx -y nextpy my-awesome-app`

`$3`

`bash

`With confirmation prompt`


npx nextpy my-awesome-app
Always use latest version

npx nextpy@latest my-awesome-app
Global install (no prompts, faster)

npm install -g nextpy
nextpy my-awesome-app


✨ Features
- 🦊 Fox - Your Smart Dev Companion - Intelligent CLI mascot that remembers your preferences and provides contextual suggestions
- FastAPI Backend - Modern, fast Python web framework
- Next.js Frontend - React framework with TypeScript support
- Multiple Database Options - PostgreSQL, MongoDB, or SQLite
- Docker Ready - Complete Docker and Docker Compose setup
- TypeScript - Full TypeScript support for type safety
- Vite - Lightning-fast development with Vite
- Interactive CLI - Beautiful, user-friendly prompts with personality
- Smart Suggestions - Fox learns your preferences and suggests your usual stack
- Best Practices - Production-ready project structure
📦 What You Get
$3

- RESTful API structure
- Database integration (PostgreSQL/MongoDB/SQLite)
- Environment configuration
- CORS setup
- Health check endpoints
- Docker configuration
$3

- TypeScript configuration
- Vite for fast development
- API client setup
- Modern React patterns
- Responsive design ready
- Docker configuration
$3

- Docker Compose for local development
- Separate Dockerfiles for frontend and backend
- Environment variable management
- Production-ready configurations
🎯 Usage
$3

`bash

`Quick start (recommended)`


npx -y nextpy my-project
Or with prompt

npx nextpy my-project


The CLI will guide you through:
1. Project name
2. Frontend framework (Next.js or Vite + React)
3. Database choice (SQLite, PostgreSQL, or MongoDB)
4. Docker support (yes/no)
5. GitHub repository initialization (yes/no)
6. Automatic setup and installation
$3

`bash cd my-project

`Start with Docker Compose (recommended)`


docker-compose up
Or start services individually:
Backend

cd backend
pip install -r requirements.txt
uvicorn main:app --reload
Frontend

cd frontend
npm install
npm run dev


🌐 Access Your Application
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- API Docs: http://localhost:8000/docs
🦊 Meet Fox - Your Smart Dev Companion
Fox is NextPy's intelligent CLI mascot that makes project creation delightful and efficient!
$3
- Remembers Your Preferences - "You usually go with Next.js + PostgreSQL. Use that again?"
- Smart Suggestions - Recommends the right database for your project type
- Celebrates Milestones - Special messages for your 1st, 5th, 10th, 25th, and 50th projects!
- Contextual Tips - Provides relevant advice based on your choices
- Personality Modes - Choose how chatty Fox should be
$3

`bash

`Verbose - Maximum personality, tips, and commentary`


nextpy my-project --fox-mode verbose
Normal - Balanced helpfulness (default)

nextpy my-project --fox-mode normal
Quiet - Essential messages only

nextpy my-project --fox-mode quiet
Silent - No Fox messages

nextpy my-project --fox-mode silent
Set globally with environment variable

export NEXTPY_FOX_MODE=verbose
nextpy my-project

$3

`bash

`Use your last configuration`


nextpy my-new-project --last
Combine options

nextpy my-project --fox-mode verbose --last


$3
- 🧠 Smart Memory - Tracks your preferences across projects
- 💡 Context-Aware - Detects project types (e-commerce, blog, API, etc.)
- 🎯 Intelligent Recommendations - Suggests appropriate tech stacks
- 🎉 Milestone Celebrations - Acknowledges your progress
- 🎨 Personality - Witty, dev-focused messages
📋 Requirements
- Node.js 18+ (for frontend)
- Python 3.11+ (for backend)
- Docker (optional, but recommended)
🛠️ Project Structure

`my-project/ ├── backend/ │ ├── main.py # FastAPI application │ ├── requirements.txt # Python dependencies │ ├── .env # Environment variables │ └── Dockerfile ├── frontend/ │ ├── src/ │ │ ├── pages/ # Next.js pages │ │ ├── components/ # React components │ │ └── lib/ # Utilities │ ├── package.json │ └── Dockerfile ├── docker-compose.yml # Docker orchestration └── README.md # Project documentation``

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see the LICENSE file for details.

🔗 Links

- GitHub Repository
- Report Issues
- npm Package

💡 Why NextPy?

- Save Time: Skip the boilerplate and start building features immediately
- Best Practices: Pre-configured with industry standards
- Flexible: Choose your database and customize as needed
- Modern Stack: Use the latest and greatest technologies
- Docker Ready: Deploy anywhere with confidence

---

Made with ❤️ by VesperAkshay

NextPy CLI

> Scaffold full-stack FastAPI + Next.js applications in seconds

![npm version](https://www.npmjs.com/package/nextpy)
![License: MIT](https://opensource.org/licenses/MIT)

NextPy is a powerful CLI tool that helps you quickly scaffold modern full-stack applications with FastAPI backend and Next.js frontend, complete with Docker support and multiple database options.

🚀 Quick Start

$3

``bash npx -y nextpy my-awesome-app`

`$3`

`bash

`With confirmation prompt`


npx nextpy my-awesome-app
Always use latest version

npx nextpy@latest my-awesome-app
Global install (no prompts, faster)

npm install -g nextpy
nextpy my-awesome-app


✨ Features
- 🦊 Fox - Your Smart Dev Companion - Intelligent CLI mascot that remembers your preferences and provides contextual suggestions
- FastAPI Backend - Modern, fast Python web framework
- Next.js Frontend - React framework with TypeScript support
- Multiple Database Options - PostgreSQL, MongoDB, or SQLite
- Docker Ready - Complete Docker and Docker Compose setup
- TypeScript - Full TypeScript support for type safety
- Vite - Lightning-fast development with Vite
- Interactive CLI - Beautiful, user-friendly prompts with personality
- Smart Suggestions - Fox learns your preferences and suggests your usual stack
- Best Practices - Production-ready project structure
📦 What You Get
$3

- RESTful API structure
- Database integration (PostgreSQL/MongoDB/SQLite)
- Environment configuration
- CORS setup
- Health check endpoints
- Docker configuration
$3

- TypeScript configuration
- Vite for fast development
- API client setup
- Modern React patterns
- Responsive design ready
- Docker configuration
$3

- Docker Compose for local development
- Separate Dockerfiles for frontend and backend
- Environment variable management
- Production-ready configurations
🎯 Usage
$3

`bash

`Quick start (recommended)`


npx -y nextpy my-project
Or with prompt

npx nextpy my-project


The CLI will guide you through:
1. Project name
2. Frontend framework (Next.js or Vite + React)
3. Database choice (SQLite, PostgreSQL, or MongoDB)
4. Docker support (yes/no)
5. GitHub repository initialization (yes/no)
6. Automatic setup and installation
$3

`bash cd my-project

`Start with Docker Compose (recommended)`


docker-compose up
Or start services individually:
Backend

cd backend
pip install -r requirements.txt
uvicorn main:app --reload
Frontend

cd frontend
npm install
npm run dev


🌐 Access Your Application
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- API Docs: http://localhost:8000/docs
🦊 Meet Fox - Your Smart Dev Companion
Fox is NextPy's intelligent CLI mascot that makes project creation delightful and efficient!
$3
- Remembers Your Preferences - "You usually go with Next.js + PostgreSQL. Use that again?"
- Smart Suggestions - Recommends the right database for your project type
- Celebrates Milestones - Special messages for your 1st, 5th, 10th, 25th, and 50th projects!
- Contextual Tips - Provides relevant advice based on your choices
- Personality Modes - Choose how chatty Fox should be
$3

`bash

`Verbose - Maximum personality, tips, and commentary`


nextpy my-project --fox-mode verbose
Normal - Balanced helpfulness (default)

nextpy my-project --fox-mode normal
Quiet - Essential messages only

nextpy my-project --fox-mode quiet
Silent - No Fox messages

nextpy my-project --fox-mode silent
Set globally with environment variable

export NEXTPY_FOX_MODE=verbose
nextpy my-project

$3

`bash

`Use your last configuration`


nextpy my-new-project --last
Combine options

nextpy my-project --fox-mode verbose --last


$3
- 🧠 Smart Memory - Tracks your preferences across projects
- 💡 Context-Aware - Detects project types (e-commerce, blog, API, etc.)
- 🎯 Intelligent Recommendations - Suggests appropriate tech stacks
- 🎉 Milestone Celebrations - Acknowledges your progress
- 🎨 Personality - Witty, dev-focused messages
📋 Requirements
- Node.js 18+ (for frontend)
- Python 3.11+ (for backend)
- Docker (optional, but recommended)
🛠️ Project Structure

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see the LICENSE file for details.

🔗 Links

- GitHub Repository
- Report Issues
- npm Package

💡 Why NextPy?

---

Made with ❤️ by VesperAkshay