Express Auth Boilerplate 🚀

✨ Features

🔐 Security

• JWT Authentication with refresh tokens
• Two-Factor Auth (2FA) with QR code support
• Email Verification with secure tokens
• Rate Limiting against DDoS attacks
• CORS Protection with configurable origins
• Password Hashing with bcrypt
• XSS Protection with security headers

🏗 Architecture

• Clean Architecture principles
• Domain-Driven Design patterns
• Repository Pattern for data access
• Error Handling with custom AppError
• Dependency Injection ready

🧪 Quality Assurance

• 100% TypeScript coverage
• Jest Testing with mocks
• ESLint & Prettier configured
• Git Hooks with Husky
• CI/CD ready

🐳 Infrastructure

• Docker Compose setup
• PostgreSQL database
• MailHog for email testing
• Hot Reload development
• Swagger UI documentation

🚀 Quick Start

1# Create new project
2npx create-express-auth my-app
3
4# Navigate and start services
5cd my-app && docker-compose up -d

📚 Documentation

Authentication API

1POST /api/auth/register     # Create new account
2POST /api/auth/login        # Get JWT token
3GET  /api/auth/verify      # Verify email

Two-Factor Auth API

1POST /api/otp/enable       # Enable 2FA
2POST /api/otp/verify       # Verify OTP code
3POST /api/otp/disable      # Disable 2FA

🛠 Development

1# Start development server
2npm run dev
3
4# Run tests
5npm test
6
7# Database operations
8npm run prisma:generate    # Generate Prisma client
9npm run prisma:migrate     # Run migrations
10npm run seed              # Seed database

📦 Project Structure

src/
├── application/          # Business Logic Layer
│   └── use-cases/       # Application Use Cases
│
├── domain/              # Domain Layer
│   ├── entities/        # Business Objects
│   ├── repositories/    # Data Contracts
│   └── errors/          # Error Handling
│
├── infrastructure/      # Infrastructure Layer
│   ├── http/           # Express Setup
│   │   ├── controllers/  # Request Handlers
│   │   ├── middlewares/ # HTTP Pipeline
│   │   └── routes/      # API Routes
│   └── services/       # External Services
│
└── test/               # Test Suites

🔧 Environment Variables

1# Server
2PORT=8080
3NODE_ENV=development
4
5# Database
6DATABASE_URL=postgresql://postgres:postgres@localhost:5432/auth-boiler-plate
7
8# JWT
9JWT_SECRET=your-secret-key
10JWT_EXPIRES_IN=1d
11
12# Email
13SMTP_HOST=mailhog
14SMTP_PORT=1025

🌐 Available Services

• API: http://localhost:8080
• API Docs: http://localhost:8080/api-docs
• Email UI: http://localhost:8025
• Database: localhost:5432

📝 License

MIT © Francesco Mazzi

---