Skip to content

uchechukwuSamuel/inventoryMgt

Repository files navigation

Inventory Management System

A simple web-based Inventory Management System using JavaScript and IndexedDB. This project allows you to manage inventory, purchases, and sales directly in your browser with a user-friendly interface.

Features

  • Inventory Management: Add, edit, delete, and search inventory items.
  • Purchases: Record purchases, auto-calculate total cost, edit and delete purchase records.
  • Sales: Record sales, auto-calculate total amount, update inventory stock, and delete sales.
  • Search: Search functionality for inventory, purchases, and sales.
  • Data Persistence: Uses IndexedDB for local storage (no server required).

Getting Started

Prerequisites

  • Modern web browser (Chrome, Firefox etc.)

Installation

  1. Clone or Download the Repository

    git clone https://github.com/yourusername/inventoryMgt-main.git
    

    Or download and extract the ZIP file.

  2. Open the Project

    • Open the project folder in your code editor (e.g., VS Code).
    • Open index.html in your browser.

inventoryMgt-main/ ├── index.html # Landing page ├── inventory.html # Inventory management UI ├── purchases.html # Purchases records ├── sales.html # Sales records ├── script.js # UI logic and event handling └── db.js # IndexedDB wrapper for CRUD operations

Usage

  1. Inventory Page

    • Add new items with name, quantity, and price.
    • Edit or delete existing items.
    • Search inventory by name or ID.
  2. Purchases Page

    • Record new purchases with vendor, date, item, unit cost, and quantity.
    • Edit or delete purchase records.
    • Search purchases by vendor, item, or ID.
  3. Sales Page

    • Record sales by selecting item, customer, quantity, and price.
    • Inventory stock is automatically updated.
    • Delete sales records.
    • Search sales by customer, item, or ID.

Note: All data is stored locally in your browser using IndexedDB. Clearing browser data will remove all records.

Customization

  • You can modify the UI or add new features by editing index.html and script.js.
  • To add more fields or validation, update the relevant form and JavaScript logic.

Troubleshooting

  • If you see a "Failed to initialize database" error, try refreshing the page.
  • Make sure your browser supports IndexedDB.

License

This project is open-source and free to use under the MIT License.

Credits

  • Bootstrap (for UI components)
  • Built with ❤️ by uche

About

Simple, offline-first inventory tracker built with JavaScript and IndexedDB. Keep tabs on your stock right from the browser, no backend needed.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors