A modern, full-stack TypeScript contact management system built with the MEAN stack (MongoDB, Express.js, Angular, Node.js) and containerized with Docker. Perfect for learning full-stack development or as a starting point for your own projects!

• TypeScript throughout the entire stack
• Angular 19 with reactive forms, guards, and SSR
• Express.js with TypeScript for a robust API
• MongoDB integration with Mongoose
• JWT Authentication for secure user management
• Docker containerization for development and production
• Nginx as a load balancer and API gateway
• CI/CD with GitHub Actions

• Docker and Docker Compose
• Git

# Clone the repository
git clone https://github.com/nitin27may/mean-docker.git
cd mean-docker

# Create environment file
cp .env.example .env
# Start the application
docker-compose -f docker-compose.nginx.yml up

The application supports two deployment modes:

1. Direct API Access: When using docker-compose.yml, the frontend connects directly to the Express API at http://localhost:3000/api

2. Nginx Proxy: When using docker-compose.nginx.yml, the frontend uses a relative path /api which Nginx routes to the Express service

This configuration is automatically set during the Docker build process. That's it! Visit http://localhost in your browser.

Login with:

• Username: [email protected]
• Password: P@ssword#321

When using the docker-compose.nginx.yml configuration, all traffic flows through a single port (80):

• Single Exposed Port: Only port 80 is exposed to the outside world
• Unified Access Point: Both UI and API requests enter through Nginx
• Intelligent Routing:
  • Requests to /api/* are proxied to the Express.js service
  • All other requests are served by the Angular frontend
• Simplified Deployment: No need to manage multiple public endpoints
• Enhanced Security: Internal services remain isolated from direct external access

The application uses a microservices architecture with four main components:

1. Angular Frontend - Modern UI with TypeScript and Bootstrap 5
2. Express.js API - RESTful API with TypeScript and JWT authentication
3. MongoDB Database - NoSQL database for flexible data storage
4. Nginx - Load balancer and reverse proxy for seamless integration

• JWT-based secure login and registration
• Protected routes with Angular guards
• Token-based API authorization
• Password change functionality

• Create, read, update, and delete contacts
• Responsive design for mobile and desktop
• Form validation with custom error messages
• Search, sort, and paginate contacts

• Hot reloading in development mode
• TypeScript type safety throughout
• Comprehensive error handling
• Swagger API documentation

MongoDb, API and UI running on different ports.

docker-compose up

• Api : http://localhost:3000
• UI:

Full microservices architecture with Nginx:

docker-compose -f docker-compose.nginx.yml up

• Application: http://localhost
• MongoDB: localhost:27017

We're constantly improving! Here's what's coming:

• Express.js API fully converted to TypeScript
• Type-safe models and controllers
• Enhanced API documentation with Swagger

• Angular Material and Tailwind CSS integration
• Dark/light theme support
• Enhanced mobile experience

• Admin, Manager, and User roles
• Permission-based UI components
• Secure API endpoints based on roles

For details, see the complete roadmap.

We welcome contributions! Please see our Contributing Guide for details.

When reporting issues, please use our issue templates:

• Bug Report
• Feature Request

This project demonstrates several modern web development best practices:

• TypeScript for type safety across the stack
• Angular reactive forms and component architecture
• Express.js middleware and REST API design
• MongoDB with Mongoose schemas
• JWT authentication flow
• Docker containerization and multi-container applications
• Nginx reverse proxy configuration

Explore the codebase to learn how these technologies work together in a real-world application!

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

Nitin Singh - @nitin27may Project Link: https://github.com/nitin27may/mean-docker

If you find this project useful, please consider giving it a star on GitHub to show your support!