π§Ύ POS Frontend System
β‘ Fast β’ Simple β’ Scalable Retail POS + Inventory Management
A modern Point of Sale (POS) + Inventory system built for real-world retail operations.
Designed for speed at checkout, accurate stock tracking, and multi-store scalability.
π Live Demo
π Try it here: Demo
π Login: admin / admin and user / user
π· Screenshots
π₯ Why This Project?
Most POS systems are either:
- β Too complex for small businesses
- β Too slow for real checkout environments
- β Hard to scale across multiple stores
This system is built to be:
- β‘ Lightning fast at checkout
- π¦ Easy inventory control
- πͺ Multi-store ready
- π± Mobile scanner friendly
- π§ Simple enough for daily retail use
- πππππ EAN 13 support
- β¨ Handles variants and their inventory
β¨ Core Features
π Point of Sale (POS)
- Barcode-based product search
- Instant cart updates
- Discounts & tax handling
- Order creation & checkout flow
- Receipt-ready structure
π¦ Inventory System
- Product CRUD (create / update / delete)
- Real-time stock tracking
- Stock adjustments (in/out)
- Category-based organization
πͺ Multi-Store Support
- Multiple store locations
- Separate inventory per store
- Centralized control dashboard
β‘ Speed-Focused UI
- Optimized React interface
- Keyboard-friendly workflow
- Minimal clicks checkout flow
βοΈ Modes
| Mode | Description |
|---|---|
| π POS Mode | Full checkout experience |
| π Order Mode | Just order punching without payment |
| π Payment Mode | Only allows payment of orders |
| π· Quotation Mode | Give quotation without creating order |
π± Mobile Scanner App (Standalone Mode)
Turn any phone into a POS terminal or inventory scanner
πΉ What it does
- Scan barcodes instantly including EAN 13
- Lookup product details in real time
- Update stock (add/remove)
- Operate without full dashboard
- Works as lightweight POS terminal
π₯ Use Cases
- Retail counter checkout via phone
- Warehouse inventory audits
- Pop-up stores / temporary counters
- Multi-terminal retail setups
βοΈ Modes
| Mode | Description |
|---|---|
| π· Scanner Mode | Inventory lookup + stock updates |
| π POS Mode | Full checkout experience |
| π Hybrid Mode | Sync with main system dashboard |
π How it works
Barcode Scan β Product Lookup (API) β Stock Update / Cart Add β Sync with POS Dashboard
ποΈ Tech Stack
- βοΈ React.js (Frontend)
- π Websocket Realtime Communication
- ποΈ SurrealDB (Backend managed)
π Key Highlights
- Built for real retail workflows
- Designed for speed + simplicity
- Supports multi-device usage
- Works for small shops β scalable systems
β‘ Quick Start with Bun and Docker
git clone https://github.com/ahmedali5530/pos-frontend
cd pos-frontend
bun install
docker compose up -dπ§ Roadmap
- More features in mobile app
- Offline mode support
- Advanced analytics dashboard
- Role-based access control
- Multi-currency support
π€ Contribute
Want to improve it?
Fork it π΄ Create a branch πΏ Submit PR π β Support
If you like this project, consider giving it a β on GitHub It really helps visibility and growth.