@dharun_r/create-fullstack-app

A modern CLI tool to instantly scaffold full-stack React + Express + MongoDB applications with JWT authentication, best practices, and modern tooling.

Features

• Quick setup of full-stack applications
• React frontend with Vite and Tailwind CSS
• Express.js backend with MongoDB integration
• JWT-based authentication system
• Pre-styled authentication pages
• Pre-configured environment variables
• Development and production configurations
• Testing setup with Jest
• ESLint + Prettier configured

Quick Start

# Using npx (recommended)
npx @dharun_r/create-fullstack-app my-app

# OR using npm
npm init @dharun_r/create-fullstack-app my-app

cd my-app
npm run install:deps  # Install dependencies for both frontend and backend
npm run dev          # Start development servers

Visit:

• Frontend: http://localhost:5173
• Backend API: http://localhost:3000

Project Structure

my-app/
├── frontend/                # React frontend (Vite)
│   ├── src/
│   │   ├── pages/         # Pre-built auth pages
│   │   │   ├── Home.jsx
│   │   │   ├── Login.jsx
│   │   │   └── Register.jsx
│   │   ├── App.jsx        # Root component
│   │   └── main.jsx       # Entry point
│   ├── .env               # Frontend environment variables
│   └── package.json
├── backend/                # Express backend
│   ├── src/
│   │   ├── controllers/   # Route controllers
│   │   ├── middleware/    # Auth middleware
│   │   ├── models/        # MongoDB models
│   │   ├── routes/        # API routes
│   │   └── index.js       # Server entry
│   ├── .env               # Backend environment variables
│   └── package.json
└── package.json           # Root package.json

Requirements

• Node.js >= 16.0.0
• MongoDB (local or remote)

Getting Started

1. Create your project:

   npx @dharun_r/create-fullstack-app my-app

2. Install dependencies:

   cd my-app
   npm run install:deps

3. Set up MongoDB:

   • Start your MongoDB server
   • Update connection string in backend/.env

4. Start development servers:

   npm run dev

5. Create a test user:

   • Navigate to http://localhost:5173/register
   • Register with email and password
   • You will be automatically logged in

Environment Variables

Backend (.env)

PORT=3000
MONGODB_URI=mongodb://localhost:27017/your-database
JWT_SECRET=your-secret-key

Frontend (.env)

VITE_API_URL=http://localhost:3000

Available Scripts

In the root directory:

• npm run install:deps - Install dependencies for both frontend and backend
• npm run dev - Start both frontend and backend in development
• npm run dev:frontend - Start only frontend
• npm run dev:backend - Start only backend
• npm run build - Build for production
• npm start - Start production server

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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

Built With

• React - Frontend library
• Vite - Frontend build tool
• Tailwind CSS - CSS framework
• Express.js - Backend framework
• MongoDB - Database
• JWT - Authentication