🚀 Node.js Category Management API

A RESTful backend API for category management, CRUD operations, and image uploads.

Backend API built with Node.js and Express.js for managing categories, custom categories, and category images.

---

✨ Features

• Category CRUD: Create, read, update, and delete categories.
• Custom Category Management: Manage custom category records through REST API endpoints.
• Category Image Management: Upload and manage multiple category images.
• File Uploads: Handle image uploads using Multer.
• RESTful API: Structured API endpoints using Express.js.
• MySQL Integration: Designed for MySQL-backed data management.
• CORS Support: Enables communication with frontend applications.
• Static File Serving: Uploaded images are served through a public API path.
• JSON & Form Data Support: Supports JSON requests and URL-encoded form data.

---

🛠️ Tech Stack

Technology	Purpose
Node.js	JavaScript runtime environment
Express.js	REST API and server framework
MySQL	Relational database
Multer	Image and multipart file uploads
CORS	Cross-origin API communication
Body Parser	Request body parsing
JavaScript	Backend development

---

🏗️ API Architecture

The backend follows a standard REST API architecture:

React Frontend
      │
      ▼
   Axios
      │
      ▼
Express.js REST API
      │
      ▼
Admin Routes
      │
      ▼
Controller Layer
      │
      ▼
MySQL Database

Image Upload Architecture

Frontend
   │
   ▼
Multipart Form Data
   │
   ▼
Multer
   │
   ▼
public/images/
   │
   ▼
Image URL Served by Express

---

🔗 API Integration

All administrative endpoints are available under: /api/admin/

📂 Category Management

Method	Endpoint	Description
GET	/api/admin/category/	Fetch all categories
POST	/api/admin/category/	Create a new category
PUT	/api/admin/category/:categoryid	Update a category
DELETE	/api/admin/category/:categoryid	Delete a category

🗂️ Custom Category Management

Method	Endpoint	Description
GET	/api/admin/mycategory/	Fetch all custom categories
POST	/api/admin/mycategory/	Create a custom category
PUT	/api/admin/mycategory/:mycategoryid	Update a custom category
DELETE	/api/admin/mycategory/:mycategoryid	Delete a custom category

🖼️ Category Image Management

Method	Endpoint	Description
GET	/api/admin/mycategoryimage/	Fetch category images
POST	/api/admin/mycategoryimage/	Upload new category images
PUT	/api/admin/mycategoryimage/:mycategoryimageid	Update image records
DELETE	/api/admin/mycategoryimage/:mycategoryimageid	Delete image records

---

🔗 Related Frontend

This backend API was designed to work with a React.js frontend application.

👉 Frontend Repository:
React Category Management Dashboard

---

📁 Image Uploads

Click to view image upload details

The API uses Multer for handling image uploads.

Single Image Upload

Category images are uploaded using:

Image

Multiple Image Upload

Category image collections support multiple uploads using:

Images

The backend supports uploading up to:

10 images per request

Uploaded files are stored in:

public/images/

Images are served through:

/images/<filename>

Example:

http://localhost:5000/images/example.jpg

---

📂 Project Structure

Click to view project structure

nodejs-category-management-api/
│
├── app/
│   │
│   ├── controllers/
│   │   └── admin.controller.js
│   │
│   ├── routes/
│   │   └── admin.route.js
│   │
│   └── ...
│
├── public/
│   └── images/
│
├── package.json
│
├── main.js
│
└── README.md

---

⚙️ Installation

Click to view installation instructions

1. Clone the repository

git clone https://github.com/yeshagevariya/nodejs-category-management-api.git

2. Navigate to the project directory

cd nodejs-category-management-api

3. Install dependencies

npm install

4. Start the API server

node main.js

The API server will run at:

http://localhost:5000

---

🔌 Frontend Integration

Click to view frontend integration

This backend API was designed to work with a React.js frontend application. Example Axios request:

axios.get("http://localhost:5000/api/admin/category/");

Example image URL for React component:

<img src="http://localhost:5000/images/image-name.jpg" alt="Category" />

---

🧪 API Request Examples

Click to view api request examples

Create a Category

POST /api/admin/category/

The request supports multipart form data with the following fields:

• Name
• Description
• Image Upload Category Images

POST /api/admin/mycategoryimage/

The request supports multiple image uploads using the following field:

• Images

---

🎯 Project Purpose

This project demonstrates the development of a backend REST API using:

• Node.js & Express.js
• MySQL Database Integration
• RESTful API architecture (CRUD operations)
• Multer for multipart form data and file uploads
• CORS configuration for cross-origin requests
• Static file serving for image retrieval

The API provides the backend foundation for a complete React-based category management dashboard.

---

👩‍💻 Author

Yesha Gevariya

Frontend Engineer building modern web applications and AI-powered products.

Specialized in: React.js Next.js TypeScript JavaScript Node.js REST APIs AI Integration RAG LLM Applications

🔗 Connect With Me

📄 License

This project was created for educational and professional development purposes.