A robust, desktop-native Point of Sale (POS) application designed specifically to manage sales, track inventory, and streamline daily operations for campus facilities.
- Sales & Khaata Management – Process transactions quickly with an intuitive interface.
- Inventory Tracking – Real-time synchronization of stock levels and product details.
- Barcode Scanner Integration – Rapid item entry and checkout workflows tailored for high-traffic environments.
- Cross-Platform Desktop App – Packaged as an executable for Windows and macOS, running entirely as an independent desktop application.
This project is built using a modern desktop and web development stack:
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite |
| Routing | React Router v7 |
| Desktop Framework | Electron 30 (electron-builder) |
| Backend / Database | Firebase 11 |
| UI / Styling | Material-UI (MUI) & Emotion |
- Node.js (v18 or higher recommended)
npmoryarn
-
Clone the repository:
git clone <repository-url> cd tuckstack
-
Install dependencies:
npm install
To start the application in development mode with hot-reloading for both the React frontend and the Electron main process, run:
npm run electron:devThis uses
concurrentlyto run the Vite dev server and the Electron app simultaneously.
If you only need to work on the web view in the browser without spinning up the desktop app:
npm run devTo compile the React code and package the Electron application into a distributable format:
-
Build the web assets and test the production Electron build locally:
npm run electron:build
-
Pack the application for distribution (creates executables / DMG):
npm run electron:pack
The packaged outputs (e.g.
.exefor Windows NSIS or.dmgfor macOS) will be generated in therelease/directory as defined inpackage.json.
This application relies on Firebase for real-time database and backend services. Ensure your src/firebase.js is properly configured with your project's credentials before running or building.