ImageGram

ImageGram is a full-stack image-sharing platform built using Node.js, Express, and MongoDB, with image storage powered by Cloudinary. The project follows a clean MVC (Model-View-Controller) architecture, ensuring separation of concerns, scalability, and maintainability.

Tech Stack

• Backend: Node.js, Express
• Database: MongoDB (with Mongoose ODM)
• File Upload: Cloudinary + Multer
• Validation: Zod
• Architecture: MVC with layered structure (Repository, Service, Controller)
• Routing: Express Router with API versioning (e.g., /api/v1/)

Project Structure

imageGram/
├── controllers/ # Handles incoming requests and calls services
├── services/ # Business logic lives here
├── repositories/ # Handles data access using Mongoose
├── schema/ # Mongoose schemas for MongoDB collections
├── routers/ # API routes and versioning
├── validation/ # Zod schemas for request validation
├── uploads/ # Multer setup for file handling
├── config/ # DB config, Cloudinary setup, helper functions etc.
└── server.js # Entry point of the application

Features

• ✅ Upload and share images using Cloudinary
• ✅ Middleware architecture using Express
• ✅ Schema definitions with Mongoose
• ✅ Request data validation with Zod
• ✅ Clean separation of logic using a Service Layer
• ✅ Routing layer using express.Router() and API versioning
• ✅ Organized MVC folder structure

Flow Overview

1. Server Setup: Initialized using Express.
2. Schema Layer: Defined Mongoose schemas for image and user data.
3. Repository Layer: Abstracts DB queries using Mongoose.
4. Service Layer (Model in MVC): Contains all business logic and talks to the repository.
5. Controller Layer: Takes client requests and passes data to the service.
6. Router Layer: Defines versioned API endpoints and passes them to the appropriate controllers.

Installation

git clone https://github.com/your-username/imageGram.git
cd imageGram
npm install

Running the App

npm start

Make sure to set up the following environment variables in a .env file:

DB_URL_PASSWORD=your_mongodb_passwordDB_URL=your_mongodb_connection_stringCLOUDINARY_CLOUD_NAME=your_cloud_nameCLOUDINARY_API_KEY=your_api_keyCLOUDINARY_API_SECRET=your_api_secret

API Endpoints

All API routes are versioned under /api/v1.

Example:

POST /api/v1/posts/ # Add new post
GET /api/v1/posts/ # Get all post

Contributing

Feel free to fork this repo and contribute. Pull requests are welcome!