[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93595":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":9,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":15,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":17,"hasPages":17,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":19,"readmeContent":20,"aiSummary":9,"trendingCount":15,"starSnapshotCount":15,"syncStatus":21,"lastSyncTime":22,"discoverSource":23},93595,"POSNext","BrainWise-DEV\u002FPOSNext","BrainWise-DEV","A modern, high-performance Point of Sale system for ERPNext with offline capabilities, real-time updates, and intuitive UI.",null,"https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002FPOSNext","Vue",138,173,6,0,43.72,false,"main","2026-07-22 04:02:09","# POS Next\n\n\u003Cdiv align=\"center\">\n\n![POS Next Banner](docs\u002Fscreenshots\u002F01-main-dashboard.png)\n\n**A modern, lightning-fast Point of Sale system for ERPNext**\n\n[![License: AGPL-3.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-AGPL%203.0-blue.svg)](LICENSE)\n[![Frappe Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFrappe-v15+-orange.svg)](https:\u002F\u002Fgithub.com\u002Ffrappe\u002Ffrappe)\n[![ERPNext Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FERPNext-v15+-green.svg)](https:\u002F\u002Fgithub.com\u002Ffrappe\u002Ferpnext)\n\n[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Demo](#-demo) • [Documentation](#-documentation)\n\n\u003C\u002Fdiv>\n\n---\n\n## Branches\n\n| Branch | Stability | Purpose |\n|--------|-----------|---------|\n| [`version-15`](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002FPOSNext\u002Ftree\u002Fversion-15) | **Stable** | Production-ready release for Frappe\u002FERPNext v15 |\n| [`develop`](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002FPOSNext\u002Ftree\u002Fdevelop) | **Unstable** | Active development — may contain breaking changes |\n\n> For production use, always install from the `version-15` branch.\n\n---\n\n## 🎯 Why POS Next?\n\nPOS Next is a **complete rewrite** of the ERPNext POS system, built from the ground up with modern technologies to deliver:\n\n- ⚡ **Blazing Fast Performance** - Vue 3 + Vite for instant load times\n- 🔄 **True Offline Support** - Keep selling even when your internet drops\n- 💎 **Modern UI\u002FUX** - Clean, intuitive interface your staff will love\n- 🎁 **Advanced Promotions** - Full-featured offers, coupons, and gift cards\n- 💰 **Smart Payments** - Multiple payment methods, partial payments, split bills\n- 📊 **Real-time Insights** - Live shift tracking and instant reports\n\n## 📸 See It In Action\n\n### Complete Sales Cycle\n\n![Sales Cycle Demo](docs\u002Fscreenshots\u002Fsales-cycle.gif)\n\n## 📞 Support & Community\n\n- 🐛 **Bug Reports**: [GitHub Issues](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next\u002Fissues)\n- 💬 **Discussions**: [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next\u002Fdiscussions)\n- 📖 **Forum**: [Frappe Community](https:\u002F\u002Fdiscuss.frappe.io\u002F)\n- 📱 **Telegram Group**: [Join our community](https:\u002F\u002Ft.me\u002F+J2WHnNKCn8ZhOWQ0) - Get help, share ideas, and connect with other users\n- 📧 **Email**: support@brainwise.me\n\n### Key Features\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"50%\">\n      \u003Cimg src=\"docs\u002Fscreenshots\u002F02-cart-with-items.png\" alt=\"Shopping Cart\"\u002F>\n      \u003Cp align=\"center\">\u003Cb>Intuitive Shopping Cart\u003C\u002Fb>\u003Cbr\u002F>Add items instantly with barcode scanning or search\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd width=\"50%\">\n      \u003Cimg src=\"docs\u002Fscreenshots\u002F04-payment-dialog.png\" alt=\"Payment Processing\"\u002F>\n      \u003Cp align=\"center\">\u003Cb>Smart Payment Processing\u003C\u002Fb>\u003Cbr\u002F>Multiple payment methods, quick amounts, partial payments\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd width=\"50%\">\n      \u003Cimg src=\"docs\u002Fscreenshots\u002F03-offers-dialog.png\" alt=\"Promotional Offers\"\u002F>\n      \u003Cp align=\"center\">\u003Cb>Promotional Schemes\u003C\u002Fb>\u003Cbr\u002F>Buy X Get Y, discounts, bundle offers, and more\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd width=\"50%\">\n      \u003Cimg src=\"docs\u002Fscreenshots\u002F06-settings.png\" alt=\"Settings\"\u002F>\n      \u003Cp align=\"center\">\u003Cb>Comprehensive Settings\u003C\u002Fb>\u003Cbr\u002F>Flexible configuration for every business need\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## ✨ Features\n\n### Core Functionality\n\n- 🚀 **Modern Tech Stack**\n  - Vue 3 with Composition API\n  - Vite for lightning-fast builds\n  - Tailwind CSS for beautiful UI\n  - TypeScript-ready architecture\n\n- 🔄 **Offline-First Architecture**\n  - IndexedDB for local data caching\n  - Background sync when online\n  - Web Workers for smooth performance\n  - Service Worker for true PWA support\n\n- 💰 **Advanced Payment Options**\n  - Multiple payment methods per transaction\n  - Partial payments with tracking\n  - Quick amount buttons for faster checkout\n  - Change calculation and write-off\n  - Credit sale support with approval\n\n- 🎁 **Promotional Engine**\n  - **Coupons**: Percentage, fixed amount, free items\n  - **Promotional Schemes**: Buy X Get Y, tiered discounts\n  - **Gift Cards**: Full gift card management\n  - Auto-apply eligible offers\n  - Stack multiple promotions\n\n- 💱 **Multi-Currency Support**\n  - Proper currency symbols (E£, ر.س, د.إ, $, €, £)\n  - Real-time exchange rates\n  - Currency-specific formatting\n\n- 💾 **Draft Invoices (Hold Orders)**\n  - Save incomplete transactions\n  - Resume from any device\n  - Automatic cleanup\n  - Badge count indicator\n\n- 🔄 **Returns Management**\n  - Quick return invoice processing\n  - Partial or full returns\n  - Auto-credit note generation\n  - Stock adjustment\n\n- 💼 **Shift Management**\n  - Open\u002Fclose shift workflow\n  - Live shift timer in navbar\n  - Shift-wise sales reports\n  - Cash reconciliation\n\n- 🔍 **Smart Search**\n  - Real-time item search\n  - Barcode scanning support\n  - Item group filtering\n  - Keyboard shortcuts (F4, F8, F9)\n\n- 📱 **Responsive Design**\n  - Desktop optimized\n  - Tablet friendly\n  - Touch-screen ready\n  - Grid and list views\n\n### Technical Features\n\n- 🔥 **Performance Optimized**\n  - Virtual scrolling for large inventories\n  - Lazy loading components\n  - Debounced search\n  - Optimistic UI updates\n\n- 🔒 **Enterprise Ready**\n  - Role-based permissions\n  - Audit trail logging\n  - Multi-warehouse support\n  - Tax compliance ready\n\n- 🌐 **Internationalization**\n  - RTL support ready\n  - Multi-language capable\n  - Regional formats\n\n## 📋 Prerequisites\n\n- **Frappe Framework** version 15 or higher\n- **ERPNext** version 15 or higher\n- Modern browser (Chrome, Firefox, Safari, Edge)\n\n## 🚀 Installation\n\n### Fresh Installation\n\n```bash\n# Navigate to your bench\ncd ~\u002Ffrappe-bench\n\n# Get the app from GitHub\nbench get-app https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next.git --branch version-15\n\n# Install on your site\nbench --site [your-site-name] install-app pos_next\n\n# Run migrations\nbench --site [your-site-name] migrate\n\n# Build assets\nbench build --app pos_next\n\n# Restart (production only)\nbench restart\n```\n\n### Development Setup\n\n```bash\n# Get app in dev mode\ncd ~\u002Ffrappe-bench\nbench get-app \u002Fpath\u002Fto\u002Fpos_next\n\n# Install frontend dependencies\ncd apps\u002Fpos_next\u002FPOS\nnpm install\n\n# Run dev server with hot reload\nnpm run dev\n\n# In another terminal, start Frappe\nbench start\n```\n\n## 🔄 Updating\n\nAlready have POS Next? Update to the latest version:\n\n```bash\ncd ~\u002Ffrappe-bench\u002Fapps\u002Fpos_next\ngit pull origin version-15\ncd ..\u002F..\n\n# Apply updates\nbench --site [your-site-name] migrate\nbench build --app pos_next\nbench --site [your-site-name] clear-cache\n\n# Restart (production only - skip if using bench start)\nbench restart\n```\n\n## 🎯 Quick Start\n\n### 1. Setup POS Profile\n\nNavigate to: **Retail > POS Profile > New**\n\nConfigure:\n- Company and Warehouse\n- Price List and Currency\n- Payment Methods (Cash, Card, etc.)\n- Default Customer (Walk-In)\n\n### 2. Access POS\n\nVisit: `https:\u002F\u002Fyour-site.com\u002Fpos` or `http:\u002F\u002Flocalhost:8000\u002Fpos`\n\n### 3. Make Your First Sale\n\n1. **Search Items** - Press `F4` or scan barcode\n2. **Add to Cart** - Click items or use auto-add mode\n3. **Select Customer** - Press `F8` (optional)\n4. **Apply Offers** - Green button shows available offers\n5. **Checkout** - Press `F9`, select payment method\n6. **Print** - Receipt prints automatically\n\n### Optional: Create Promotional Offers\n\n**POS Offer**: `POS Next > POS Offer > New`\n**POS Coupon**: `POS Next > POS Coupon > New`\n\n## ⌨️ Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| `F4` | Search items |\n| `F8` | Search customers |\n| `F9` | Proceed to checkout |\n| `Ctrl+S` | Save draft (hold order) |\n| `Esc` | Close dialog |\n\n## 🎨 Feature Highlights\n\n### Offline Mode\n\nNever lose a sale! POS Next works seamlessly even without internet:\n- All item data cached locally\n- Stock levels synced in background\n- Invoices saved and uploaded when online\n- Visual indicator shows connection status\n\n### Smart Offers Engine\n\nMaximize revenue with sophisticated promotions:\n- **Buy 2 Get 1 Free** - Product-based offers\n- **Spend $100, Get 10% Off** - Value-based discounts\n- **Seasonal Coupons** - Time-limited promotions\n- **Free Shipping** - Threshold-based benefits\n\n### Shift Management\n\nComplete shift lifecycle:\n- Open shift to start selling\n- Live timer shows shift duration\n- Close shift for reconciliation\n- Detailed shift reports with cash movements\n\n## 💱 Currency Support\n\nDisplay prices in proper local format:\n- **Egypt**: E£ (EGP)\n- **Saudi Arabia**: ر.س (SAR)\n- **UAE**: د.إ (AED)\n- **US**: $ (USD)\n- **Europe**: € (EUR)\n- **UK**: £ (GBP)\n- And many more...\n\n## 🔧 Configuration\n\n### Stock Settings\n\n- **Warehouse Selection**: Choose active warehouse\n- **Negative Stock**: Allow overselling\n- **Auto Sync**: Background stock updates\n- **Stock Policy**: Validation rules\n\n### Pricing & Discounts\n\n- **Tax Inclusive**: Prices include tax\n- **Max Discount**: Item-level limits\n- **Additional Discount**: Invoice-level\n- **Rounded Totals**: Exact or rounded\n\n### Sales Operations\n\n- **Credit Sales**: Allow payment terms\n- **Partial Payments**: Split over multiple methods\n- **Returns**: Enable return processing\n- **Write-off**: Small change amounts\n- **Silent Print**: Auto-print receipts\n\n## 🛠️ Troubleshooting\n\n### Items Not Loading\n\n**Check:**\n1. Items exist in selected warehouse\n2. Price list has item prices defined\n3. POS Profile warehouse setting\n4. Browser console for errors\n\n**Solution:** Clear cache and reload\n```bash\nbench --site [your-site-name] clear-cache\n```\n\n### Offline Mode Not Working\n\n**Check:**\n1. Service Worker registered\n2. IndexedDB enabled in browser\n3. Sufficient storage available\n\n**Solution:** Check browser console, ensure HTTPS (required for Service Workers)\n\n### Close Shift Not Working\n\n**Status:** Fixed in v1.6.0+\n\n**Solution:** Update to latest version\n\n## 🏗️ Build for Production\n\n```bash\ncd apps\u002Fpos_next\u002FPOS\nnpm run build\nbench build --app pos_next\nbench restart\n```\n\n## 🔌 API Reference\n\n### Get Available Offers\n\n```python\nfrappe.call({\n    method: 'pos_next.api.offers.get_offers',\n    args: {\n        pos_profile: 'Main POS',\n        customer: 'CUST-00001'\n    },\n    callback: (r) => console.log(r.message)\n})\n```\n\n### Validate Coupon\n\n```python\nfrappe.call({\n    method: 'pos_next.api.offers.validate_coupon',\n    args: {\n        coupon_code: 'SUMMER2024',\n        customer: 'CUST-00001',\n        company: 'My Company',\n        grand_total: 1000\n    },\n    callback: (r) => console.log(r.message)\n})\n```\n\n### Create Invoice\n\n```python\nfrappe.call({\n    method: 'pos_next.api.invoices.create_invoice',\n    args: {\n        invoice_data: {\n            customer: 'CUST-00001',\n            items: [\n                { item_code: 'ITEM-001', qty: 2, rate: 100 }\n            ],\n            payments: [\n                { mode_of_payment: 'Cash', amount: 200 }\n            ]\n        }\n    },\n    callback: (r) => console.log(r.message)\n})\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how:\n\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b feature\u002Famazing-feature`\n3. **Install** pre-commit hooks: `cd apps\u002Fpos_next && pre-commit install`\n4. **Make** your changes\n5. **Test** thoroughly\n6. **Commit** with clear messages\n7. **Push** to your fork\n8. **Open** a Pull Request\n\n### Code Quality\n\nWe use automated tools to maintain code quality:\n- **Python**: ruff, pyupgrade\n- **JavaScript**: eslint, prettier\n- **Git**: pre-commit hooks\n\n## 📄 License\n\nAGPL-3.0 License - See [LICENSE](LICENSE) file for details\n\nThis means you can:\n- ✅ Use commercially\n- ✅ Modify\n- ✅ Distribute\n- ✅ Use privately\n\nYou must:\n- 📋 Disclose source\n- 📋 Include license\n- 📋 State changes\n- 📋 Share alike\n\n## 🙏 Credits & Technology\n\nBuilt with amazing open-source technologies:\n\n- [Frappe Framework](https:\u002F\u002Ffrappeframework.com\u002F) - Full-stack web framework\n- [ERPNext](https:\u002F\u002Ferpnext.com\u002F) - Open-source ERP\n- [Vue.js 3](https:\u002F\u002Fvuejs.org\u002F) - Progressive JavaScript framework\n- [Vite](https:\u002F\u002Fvitejs.dev\u002F) - Next-generation frontend tooling\n- [Tailwind CSS](https:\u002F\u002Ftailwindcss.com\u002F) - Utility-first CSS framework\n- [Heroicons](https:\u002F\u002Fheroicons.com\u002F) - Beautiful hand-crafted SVG icons\n\n## 📝 Changelog\n\n### v1.6.1 (Latest)\n- Enhanced partial payments with overdue status tracking\n- Major backend refactoring for better maintainability\n- Performance improvements\n\n### v1.6.0\n- ✨ Implemented free items support for promotional offers\n- 🐛 Fixed tax-inclusive calculation preventing tax being treated as discount\n- 🔧 Improved promotional scheme handling\n\n### v1.0.0\n- 🎉 Initial release\n- ✨ Modern Vue 3 interface\n- 🔄 Offline-first architecture\n- 💰 Multi-currency support\n- 🎁 Coupon and offer system\n- 💾 Draft invoice management\n\n## 🎯 Roadmap\n\nComing soon:\n\n- [ ] 🍽️ **Restaurant Mode** - Table management, kitchen display\n- [ ] 📱 **Mobile App** - Native iOS and Android apps\n- [ ] 📊 **Advanced Analytics** - Sales insights, trends, forecasting\n- [ ] 🎯 **Loyalty Program** - Points, rewards, membership tiers\n- [ ] 📦 **Quick Restock** - Low stock alerts, auto-ordering\n- [ ] 🖨️ **Receipt Customization** - Custom templates, branding\n- [ ] 🔗 **Integration Hub** - Payment gateways, accounting software\n- [ ] 👥 **Customer Display** - Facing display for customers\n\n---\n\n\u003Cdiv align=\"center\">\n\n**Made with ❤️ by [BrainWise](https:\u002F\u002Fnexus.brainwise.me)**\n\n⭐ Star us on GitHub — it motivates us a lot!\n\n[Report Bug](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next\u002Fissues) • [Request Feature](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next\u002Fissues) • [Documentation](https:\u002F\u002Fgithub.com\u002FBrainWise-DEV\u002Fpos_next\u002Fwiki)\n\n\u003C\u002Fdiv>\n",2,"2026-07-21 02:30:08","trending"]