A advance backend boilerplate with modern secure high demand features

Ready PostgreSQL Backend is a TypeScript-based Express.js application that provides a secure and scalable API. It uses Prisma as an ORM and implements various security features and optimizations.

• Runtime Environment: Node.js
• Framework: Express.js
• Language: TypeScript
• Database ORM: Prisma
• Authentication: JWT, Cookie-based
• Security:
  • Rate Limiting
  • CORS
  • Compression
  • Cookie Parser
• Development Tools:
  • ESLint
  • Prettier
  • Husky (Git Hooks)
  • ts-node-dev

• Authentication & Authorization

  • JWT-based authentication
  • Secure cookie handling
  • Role-based access control

• API Security

  • Rate limiting to prevent abuse
  • CORS configuration
  • Request compression
  • Error handling middleware

• Development Features

  • Hot reloading
  • TypeScript support
  • Code formatting and linting
  • Git hooks for code quality
  • CI/CD with GitHub Actions
  • Docker support
  • AWS S3 for file storage
  • Cloudinary for image processing
  • Nodemailer for email sending
  • Swagger for API documentation
  • Sentry for error monitoring
  • Docker Compose for easy local development

• Node.js (v14 or higher)
• npm or yarn or pnpm
• PostgreSQL database

Create a .env file in the root directory with the following variables:

1. Clone the repository:

2. Install dependencies:

3. Run database migrations:

4. Start the development server:

• yarn start: Start production server
• yarn dev: Start development server with hot reloading
• yarn build: Build the TypeScript project
• yarn lint:check: Check for linting issues
• yarn lint:fix: Fix linting issues
• yarn prettier:check: Check code formatting
• yarn prettier:fix: Fix code formatting
• yarn lint-prettier: Run both lint and prettier checks

• Rate limiting configuration to prevent abuse
• CORS setup for development and production
• Request compression for better performance
• Secure cookie handling
• Global error handling middleware

This project uses GitHub Actions for continuous integration and deployment. Our workflow automatically:

• Builds the application
• Runs tests
• Checks code quality
• Deploys to production (when merging to main branch)

• Automatic builds on push and pull requests
• Node.js environment setup
• Dependency caching for faster builds
• Environment variable handling
• Deployment automation

To view detailed workflow configurations, check .github/workflows/build-deploy.yml.

The backend supports file uploads with the following features:

• Image upload support for user profiles
• Automatic directory creation for uploads
• File type validation
• Size limits and optimization
• Secure file storage

• Role-based access control (User, Admin, Super Admin)
• Super Admin seeding on first startup
• Profile management with image upload
• Secure password handling
• Email verification

• JWT-based authentication
• Refresh token support
• Password reset functionality
• Email verification
• Session management
• Rate limiting on auth endpoints

1. Start all services:

2. Stop all services:

3. View logs:

1. Build the Docker image:

2. Run the container:

The project includes:

• Multi-stage build optimization
• Production-ready Node.js configuration
• PostgreSQL database container
• Volume persistence for database
• Hot-reloading for development
• Automatic container restart
• Network isolation

• Dockerfile: Multi-stage build configuration
• docker-compose.yml: Service orchestration
• .dockerignore: Build optimization

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

• Sarwar Hossin

• Express.js community
• Prisma team
• TypeScript team