Express TypeScript Boilerplate

Features

• Email/Password authentication
• Google OAuth integration
• JWT-based authentication with refresh tokens
• Email verification
• Password reset
• Two-factor authentication support
• File upload with S3/MinIO
• AI chat functionality
• OpenAPI documentation

🚀 Tech Stack

Backend Framework

• Node.js
• Express.js
• TypeScript

Database & Caching

• PostgreSQL - Primary database
• Redis - Caching and session management
• Drizzle ORM - Database ORM

Authentication

• Passport.js - Authentication middleware
• Argon2 - Secure password hashing
• JWT - Token-based authentication

File Storage

• AWS S3/MinIO - Object storage
• Multer - File upload middleware

Validation & Documentation

• Zod - Schema validation
• OpenAPI/Swagger - API documentation
• Zod-to-OpenAPI - Schema to OpenAPI conversion

Communication

• Nodemailer - Email sending
• React Email - Email templates

AI Integration

• OpenAI - AI services for chat functionality

Development & Testing

• Vitest - Testing framework
• Biome - Linter and formatter
• pino - Logging
• Husky - Git hooks
• Docker & Docker Compose - Containerization

📁 Project Structure

• /src
  • /config - Configuration files and environment setup
    • appConfig.ts - Application configuration
    • env.ts - Environment variables validation
  • /db - Database schemas and migrations
    • /schemas - Database table definitions and validation
  • /docs - OpenAPI/Swagger documentation
  • /lib - Shared library code
  • /middlewares - Express middlewares
  • /modules - Feature modules
    • /auth - Authentication functionality
    • /chat - Chat and AI functionality
    • /healthCheck - Health check endpoints
    • /upload - File upload functionality
    • /user - User management
  • /services - Business logic and external services
    • /strategies - Passport.js authentication strategies
  • /utils - Utility functions and helpers

Credits

express-typescript-boilerplate