AuthCraft - Suggests crafted authentication solutions

A Node.js authentication boilerplate with Express, MongoDB, and optional integrations like Cloudinary and payment gateways.

Installation

To create a new project, use the following command instead of installing the package globally:

npx create-visyadav-app

Features

• ✅ Complete authentication system (register, login, logout)
• ✅ Email verification with nodemailer
• ✅ Password reset functionality
• ✅ JWT-based authentication
• ✅ Cookie-based session management
• ✅ Mongoose models and database connection
• ✅ Optional integrations:
  • Cloudinary for image uploads
  • Razorpay/Stripe for payments
  • Socket.io for real-time features

Installation

Quick Start

Create a new project:

npx create-visyadav-app

Follow the interactive prompts to configure your project.

After generation:

cd your-project-name
npm install

Set up your environment variables in .env:

PORT=4000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key
[email protected]
SMTP_APP_PASSWORD=your_app_password

# For Cloudinary:
CLOUDINARY_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_SECRET_KEY=your_secret_key

# For Razorpay:
RAZORPAY_KEY_ID=your_key_id
RAZORPAY_KEY_SECRET=your_key_secret

Start the development server:

npm run dev

API Endpoints

Authentication

• POST /api/v1/auth/sign-up - User registration
• POST /api/v1/auth/verify-email - Email verification
• POST /api/v1/auth/sign-in - User login
• POST /api/v1/auth/logout - User logout
• POST /api/v1/auth/forget-password - Request password reset
• POST /api/v1/auth/reset-password/:resetToken - Reset password
• GET /api/v1/auth/check-auth-user - Get authenticated user data
• GET /api/v1/auth/check-token - Check if valid token exists
• GET /api/v1/auth/get-all-user - Get all users (admin)

Configuration

The generator creates a project with the following structure:

your-project/
├── connectDB/           # Database connection
├── controllers/         # Route controllers
├── generateToken/       # JWT token generation
├── middleware/          # Authentication middleware
├── models/              # Mongoose models
├── nodemailer/          # Email templates and sending
├── routes/              # API routes
├── utils/               # Utility functions (if Cloudinary enabled)
├── .env                 # Environment variables
├── index.js             # Main application file
└── package.json

Available Scripts

npm run start  # Start the production server
npm run dev    # Start the development server with nodemon

Dependencies

• Express.js - Web framework
• Mongoose - MongoDB ODM
• jsonwebtoken - JWT authentication
• bcryptjs - Password hashing
• nodemailer - Email sending
• cookie-parser - Cookie handling
• dotenv - Environment variables
• cors - Cross-origin resource sharing
• (Optional) cloudinary - Image uploads
• (Optional) razorpay/stripe - Payment processing

Contributing

Contributions are welcome! Please open an issue or submit a pull request.