Skip to content

MustafaAjnawala/Smart-Inventory-Management-System

Repository files navigation

✨ Smart Inventory Management System ✨

React Electron.js Node.js MongoDB

An inventory management solution for a proposed company One Smart Inc., crafted with the MERN stack and Electron to deliver a seamless, robust, and user-friendly experience.


🌐 Live Demo

Check out the live version of the application here: https://careeco-inventory-management-system-x0ri.onrender.com/


🚀 Key Feature: Uninterrupted Workflow with Hybrid Online/Offline Sync

SmartInc is engineered for reliability. Work offline without a hitch, and watch as your data automatically syncs to the central server the moment you're back online. Your business never stops, and neither does your inventory system.


🌟 Core Features

  • 📦 Product Management: Effortlessly add, edit, and track your entire inventory.
  • 🛒 Purchase Tracking: Keep a close eye on incoming stock and manage purchases with ease.
  • 🧾 Billing & Invoicing: Generate and manage customer invoices seamlessly.
  • ↩️ Returns Management: Handle product returns with an efficient and clear process.
  • 🗓️ Expiry Date Notifications: Stay ahead with timely alerts for expiring products.

💻 Tech Stack

Category Technology
Frontend React, Electron, Material-UI, Vite
Backend Node.js, Express
Database MongoDB, Mongoose

📸 Screenshots

Dashboard Dashboard

Purchase Orders Purchase Orders

Billing Billing


🛠️ Getting Started

Prerequisites:

  • Node.js
  • MongoDB

Installation:

  1. Backend:

    cd server
    npm install
  2. Web Frontend:

    cd one-smart-inc-frontend
    npm install
  3. Electron Frontend:

    cd one-smart-inc-frontend-electron
    npm install

Running the Application:

  1. Start the backend server:

    cd server
    npm run dev
  2. Start the Web application:

    cd one-smart-inc-frontend
    npm run dev
  3. Start the Electron application:

    cd one-smart-inc-frontend-electron
    npm run dev

📂 Project Structure

.
├── one-smart-inc-frontend-electron/  # Electron frontend application
│   ├── src/
│   │   ├── main/                       # Electron main process
│   │   ├── preload/                    # Electron preload script
│   │   └── renderer/                   # React frontend
│   │       ├── src/
│   │       │   ├── components/         # React components
│   │       │   ├── services/           # API and local DB services
│   │       │   └── theme/              # Material-UI theme
├── server/                             # Node.js backend
│   ├── controllers/                    # Route handlers
│   ├── models/                         # Mongoose models
│   └── ...
└── ...

↔️ API Endpoints

  • POST /api/products - Add a new product
  • GET /api/products - Get all products
  • POST /api/purchases - Add a new purchase
  • GET /api/purchases - Get all purchases
  • GET /api/bills - Get all bills

📚 Documentation

For more detailed information, please refer to the documentation for each part of the project:


✍️ Authors

This project was brought to life by:


Star this repository if you find it helpful!

About

A comprehensive inventory management application built with React, Node.js, and MongoDB, designed for seamless web and desktop experiences. Features Electron app for cross-platform support.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors