Bulldogs is a robust, scalable, and enterprise-ready Node.js backend framework designed for modern web applications. Built with performance, security, and maintainability in mind, it provides a solid foundation for building RESTful APIs and microservices.
-
Backend: (you are here!)
- Repository:
strivedi4u/bulldogs - Built with: JavaScript (99.9%), Shell (0.1%)
- Handles APIs, authentication, data storage, and business logic
- Repository:
-
Frontend:
- Repository:
strivedi4u/puppies - Renders UI, handles user interaction, fetches data from this backend
- Repository:
Bulldogs in action - Clean, efficient, and powerful
bulldogs/
│
├── 📁 controllers/ # Business logic & request handlers
│ ├── authController.js # Authentication logic
│ ├── userController.js # User management
│ └── apiController.js # Main API endpoints
│
├── 🔒 middlewares/ # Express middleware stack
│ ├── authMiddleware.js # JWT authentication
│ ├── rateLimiter.js # Rate limiting
│ ├── validator.js # Request validation
│ └── errorHandler.js # Global error handling
│
├── 📊 models/ # Database schemas & models
│ ├── User.js # User model
│ ├── Session.js # Session management
│ └── index.js # Model exports
│
├── 🛣️ routes/ # API route definitions
│ ├── auth.js # Authentication routes
│ ├── users.js # User routes
│ ├── api/ # API versioning
│ │ ├── v1/ # Version 1 routes
│ │ └── v2/ # Version 2 routes
│ └── index.js # Route aggregation
│
├── 📤 uploads/ # File storage & assets
│ ├── images/ # Image uploads
│ ├── documents/ # Document storage
│ ├── files4-pu.jpg # Demo images
│ └── files3-puppu3.jpg # Application screenshots
│
├── 🌐 public/ # Static assets (compressed)
│ └── public.zip # Frontend assets bundle
│
├── ⚙️ config/ # Configuration files
│ ├── database.js # DB configuration
│ ├── server.js # Server settings
│ └── environment.js # Environment variables
│
├── 🔧 utils/ # Utility functions
│ ├── helpers.js # General helpers
│ ├── validation.js # Validation utilities
│ └── logger.js # Logging system
│
├── 📋 tests/ # Test suites
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── e2e/ # End-to-end tests
│
├── 🗄️ db.js # Database connection & setup
├── 🚀 index.js # Application entry point
├── 🔐 .env # Environment variables
├── 📦 package.json # Project dependencies
├── 🔒 package-lock.json # Dependency lock file
└── 📁 node_modules/ # Installed packages
- ⚡ High Performance - Optimized for speed and efficiency
- 🔒 Security First - Built-in security middleware and best practices
- 📈 Scalable Architecture - Microservices-ready design
- 🔄 API Versioning - Support for multiple API versions
- 🛡️ Error Handling - Comprehensive error management
- 📊 Logging & Monitoring - Advanced logging capabilities
- 🔐 Authentication - JWT-based authentication system
- 📝 Validation - Request/response validation
- ⚡ Rate Limiting - Built-in rate limiting protection
- 🔄 Real-time Communication - WebSocket support
- 📁 File Management - Advanced file upload/download
- 🗄️ Database Agnostic - Support for multiple databases
- 🐳 Docker Support - Containerization ready
- 🔧 Environment Management - Multi-environment configuration
- 📊 Analytics Integration - Built-in analytics hooks
- 🔍 Search Functionality - Advanced search capabilities
- 📧 Email Integration - Email service integration
| Category | Technologies |
|---|---|
| Runtime |  |
| Framework |  |
| Language |   |
| Database |   |
| Authentication |  |
| Documentation |  |
| Testing |   |
| Deployment |   |
| Monitoring |  |
- Node.js (v16.0.0 or higher)
- npm or yarn
- MongoDB (local or cloud)
- Git
-
Clone the Repository
git clone https://github.com/strivedi4u/bulldogs.git cd bulldogs -
Install Dependencies
npm install # or yarn install -
Environment Setup
cp .env.example .env # Edit .env with your configuration -
Database Setup
# Start MongoDB (if local) mongod # Run database migrations npm run db:migrate
-
Start Development Server
npm run dev # or yarn dev -
Access the Application
- API:
http://localhost:3000 - Documentation:
http://localhost:3000/docs - Health Check:
http://localhost:3000/health
- API:
POST /api/v1/auth/register # User registration
POST /api/v1/auth/login # User login
POST /api/v1/auth/logout # User logout
GET /api/v1/auth/profile # Get user profile
PUT /api/v1/auth/profile # Update user profileGET /api/v1/users # Get all users
GET /api/v1/users/:id # Get user by ID
PUT /api/v1/users/:id # Update user
DELETE /api/v1/users/:id # Delete userPOST /api/v1/upload # Upload files
GET /api/v1/files/:id # Get file
DELETE /api/v1/files/:id # Delete file# Run all tests
npm test
# Run unit tests
npm run test:unit
# Run integration tests
npm run test:integration
# Run with coverage
npm run test:coverage
# Run tests in watch mode
npm run test:watch# Build Docker image
docker build -t bulldogs-app .
# Run container
docker run -p 3000:3000 bulldogs-app# Build for production
npm run build
# Start with PM2
npm run start:prod
# Or start directly
npm startWe welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Check out other amazing projects by @strivedi4u:
- 🎵 Moodify - Music mood analysis platform
- 🧠 Brainic - AI-powered brain training app
- ☕ Gavina - Coffee shop management system
- 🔍 GoQuery - Advanced query builder
This project is licensed under the MIT License - see the LICENSE file for details.
- Express.js team for the amazing framework
- MongoDB team for the robust database
- All contributors who made this project possible
- The amazing Node.js community
Follow the Developer:
⭐ If you found this project helpful, please give it a star! ⭐