https://github.com/hashim-baloch/react-pos
A POS that actually works.(sometimes)
https://github.com/hashim-baloch/react-pos
appwrite appwrite-auth appwrite-database appwrite-storage buisness-use finance javascript pos react react-pos reactjs reactjs-components stored-procedures tailwind
Last synced: about 1 year ago
JSON representation
A POS that actually works.(sometimes)
- Host: GitHub
- URL: https://github.com/hashim-baloch/react-pos
- Owner: hashim-baloch
- License: mit
- Created: 2024-11-05T18:30:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-11T08:29:31.000Z (over 1 year ago)
- Last Synced: 2025-03-02T20:17:26.923Z (about 1 year ago)
- Topics: appwrite, appwrite-auth, appwrite-database, appwrite-storage, buisness-use, finance, javascript, pos, react, react-pos, reactjs, reactjs-components, stored-procedures, tailwind
- Language: JavaScript
- Homepage: https://orderup.tech
- Size: 2.9 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# React POS System 🛒💻
This is a React-based **POS (Point of Sale)** system that took me hell lot of time to make. It's a modern, full-featured POS that won't make you want to throw your computer out the window... most of the time. 😅
💡 **Pro Tip (for all you hustling devs out there):** There's always a certain breed of developers who dream of quick riches, and POS systems just happen to be _the_ fastest way to turn code into money. Not saying anything... but iykyk. 😉
## ✨ Features
- ### 🔐 Authentication
- Email Sign Up & Log In
- OTP Verification
- Password Recovery
- ### 📦 Inventory Management
- Add, Edit, and Delete Products
- Track Stock Levels
- Set Minimum Stock Alerts
- Import/Export Excel Functionality
- SKU Generation
- Multiple Price Points (Retail/Wholesale)
- ### 💸 Sales
- Quick Product Search
- Cart Management
- Multiple Payment Methods
- Discount Handling
- Receipt Generation
- Sales History
- ### 🛍 Purchases
- Stock Purchase Tracking
- Supplier Management
- Purchase History
- Cost Tracking
- ### 💰 Expenses
- Expense Tracking
- Category Management
- Expense Analytics
- Monthly Reports
- ### 📊 Dashboard
- Sales Overview
- Low Stock Alerts
- Recent Transactions
- Daily Totals
- ### ⚙ Settings
- Coming soon!
## 🚀 Getting Started
Because we all love spending hours setting up projects, here's how to get this bad boy running:
1. Clone the repo (if you can figure out Git)
2. Run `npm install` and pray to the dependency gods 🙏
3. Rename `sample.env` to `.env` and fill in your **Appwrite IDs**.
### 🏗️ Appwrite Setup
1. Create a new project in Appwrite (the easy part)
2. Create a database with these collections (here comes the fun):
- `inventory`: For your precious products
- `sales`: Where the money magic happens
- `purchases`: For tracking where your money goes
- `expenses`: For crying about where else your money goes
- `users`: For those brave souls using your system
> Each one of these should have two attributes: `userId` & `data`. Don't think too much about it—just do as I say, and your life will be easy. 🙄
> Remember to set permissions for anyone to create, read, update docs in here: _(hehe)_ 
3. Create a storage bucket for profile pictures (because everyone loves a good selfie)
4. Enable email/password authentication (keep those hackers at bay!)
5. Integrate a platform:
- Set your platform to `localhost` for development.
- Update it to your domain name when deploying (e.g., `https://yourdomain.com`).
6. Update your `.env` file with all those lovely IDs.
Now you're ready to run `npm run dev` and watch your creation come to life! 🎉
## 🎨 Figma File
[Figma File](https://www.figma.com/design/Jg0Cp8zg8F97PQq1xwd1c9/POS-system?node-id=0-1&m=dev&t=QzyM9ngsWeXjcnLJ-1). Dev mode is turned on.
## 🛠️ Libraries & Frameworks Used
- **Appwrite**
- **React**
- **React Router**
- **Redux**
- **Tailwind CSS**
- **Vite**
- **react-otp-input**
- **recharts**
- **xlsx-js-style**
- **react-to-print**
- **react-toastify**
- **browser-image-compression**
- **Vercel**
- **DriverJs**
> Don't freak out—these also include some packages. 😅
---
## 🙌 Credits
- Icons from [Flaticons](https://www.flaticon.com) (because who has time to make their own?)
- Shoutout to [Bolt](https://bolt.new), ChatGPT, and CoPilot for helping throughout the project. 🤝 (what the hell am I doing?)
---
## 📜 License
Licensed under [MIT](/LICENSE), so I won't be responsible if it breaks or someone messes up the database. 😎