POS Next

A modern, lightning-fast Point of Sale system for ERPNext

Features • Installation • Quick Start • Demo • Documentation

🎯 Why POS Next?

POS Next is a complete rewrite of the ERPNext POS system, built from the ground up with modern technologies to deliver:

⚡ Blazing Fast Performance - Vue 3 + Vite for instant load times
🔄 True Offline Support - Keep selling even when your internet drops
💎 Modern UI/UX - Clean, intuitive interface your staff will love
🎁 Advanced Promotions - Full-featured offers, coupons, and gift cards
💰 Smart Payments - Multiple payment methods, partial payments, split bills
📊 Real-time Insights - Live shift tracking and instant reports

📸 See It In Action

Complete Sales Cycle

📞 Support & Community

🐛 Bug Reports: GitHub Issues
💬 Discussions: GitHub Discussions
📖 Forum: Frappe Community
📱 Telegram Group: Join our community - Get help, share ideas, and connect with other users
📧 Email: support@brainwise.me

Key Features

Intuitive Shopping Cart Add items instantly with barcode scanning or search	Smart Payment Processing Multiple payment methods, quick amounts, partial payments
Promotional Schemes Buy X Get Y, discounts, bundle offers, and more	Comprehensive Settings Flexible configuration for every business need

✨ Features

Core Functionality

🚀 Modern Tech Stack
- Vue 3 with Composition API
- Vite for lightning-fast builds
- Tailwind CSS for beautiful UI
- TypeScript-ready architecture
🔄 Offline-First Architecture
- IndexedDB for local data caching
- Background sync when online
- Web Workers for smooth performance
- Service Worker for true PWA support
💰 Advanced Payment Options
- Multiple payment methods per transaction
- Partial payments with tracking
- Quick amount buttons for faster checkout
- Change calculation and write-off
- Credit sale support with approval
🎁 Promotional Engine
- Coupons: Percentage, fixed amount, free items
- Promotional Schemes: Buy X Get Y, tiered discounts
- Gift Cards: Full gift card management
- Auto-apply eligible offers
- Stack multiple promotions
💱 Multi-Currency Support
- Proper currency symbols (E£, ر.س, د.إ, $, €, £)
- Real-time exchange rates
- Currency-specific formatting
💾 Draft Invoices (Hold Orders)
- Save incomplete transactions
- Resume from any device
- Automatic cleanup
- Badge count indicator
🔄 Returns Management
- Quick return invoice processing
- Partial or full returns
- Auto-credit note generation
- Stock adjustment
💼 Shift Management
- Open/close shift workflow
- Live shift timer in navbar
- Shift-wise sales reports
- Cash reconciliation
🔍 Smart Search
- Real-time item search
- Barcode scanning support
- Item group filtering
- Keyboard shortcuts (F4, F8, F9)
📱 Responsive Design
- Desktop optimized
- Tablet friendly
- Touch-screen ready
- Grid and list views

Technical Features

🔥 Performance Optimized
- Virtual scrolling for large inventories
- Lazy loading components
- Debounced search
- Optimistic UI updates
🔒 Enterprise Ready
- Role-based permissions
- Audit trail logging
- Multi-warehouse support
- Tax compliance ready
🌐 Internationalization
- RTL support ready
- Multi-language capable
- Regional formats

📋 Prerequisites

Frappe Framework version 15 or higher
ERPNext version 15 or higher
Modern browser (Chrome, Firefox, Safari, Edge)

🚀 Installation

Fresh Installation

# Navigate to your bench
cd ~/frappe-bench

# Get the app from GitHub
bench get-app https://github.com/BrainWise-DEV/pos_next.git --branch develop

# Install on your site
bench --site [your-site-name] install-app pos_next

# Run migrations
bench --site [your-site-name] migrate

# Build assets
bench build --app pos_next

# Restart (production only)
bench restart

Development Setup

# Get app in dev mode
cd ~/frappe-bench
bench get-app /path/to/pos_next

# Install frontend dependencies
cd apps/pos_next/POS
npm install

# Run dev server with hot reload
npm run dev

# In another terminal, start Frappe
bench start

🔄 Updating

Already have POS Next? Update to the latest version:

cd ~/frappe-bench/apps/pos_next
git pull origin develop
cd ../..

# Apply updates
bench --site [your-site-name] migrate
bench build --app pos_next
bench --site [your-site-name] clear-cache

# Restart (production only - skip if using bench start)
bench restart

🎯 Quick Start

1. Setup POS Profile

Navigate to: Retail > POS Profile > New

Configure:

Company and Warehouse
Price List and Currency
Payment Methods (Cash, Card, etc.)
Default Customer (Walk-In)

2. Access POS

Visit: https://your-site.com/pos or http://localhost:8000/pos

3. Make Your First Sale

Search Items - Press F4 or scan barcode
Add to Cart - Click items or use auto-add mode
Select Customer - Press F8 (optional)
Apply Offers - Green button shows available offers
Checkout - Press F9, select payment method
Print - Receipt prints automatically

Optional: Create Promotional Offers

POS Offer: POS Next > POS Offer > New POS Coupon: POS Next > POS Coupon > New

⌨️ Keyboard Shortcuts

Shortcut	Action
`F4`	Search items
`F8`	Search customers
`F9`	Proceed to checkout
`Ctrl+S`	Save draft (hold order)
`Esc`	Close dialog

🎨 Feature Highlights

Offline Mode

Never lose a sale! POS Next works seamlessly even without internet:

All item data cached locally
Stock levels synced in background
Invoices saved and uploaded when online
Visual indicator shows connection status

Smart Offers Engine

Maximize revenue with sophisticated promotions:

Buy 2 Get 1 Free - Product-based offers
Spend $100, Get 10% Off - Value-based discounts
Seasonal Coupons - Time-limited promotions
Free Shipping - Threshold-based benefits

Shift Management

Complete shift lifecycle:

Open shift to start selling
Live timer shows shift duration
Close shift for reconciliation
Detailed shift reports with cash movements

💱 Currency Support

Display prices in proper local format:

Egypt: E£ (EGP)
Saudi Arabia: ر.س (SAR)
UAE: د.إ (AED)
US: $ (USD)
Europe: € (EUR)
UK: £ (GBP)
And many more...

🔧 Configuration

Stock Settings

Warehouse Selection: Choose active warehouse
Negative Stock: Allow overselling
Auto Sync: Background stock updates
Stock Policy: Validation rules

Pricing & Discounts

Tax Inclusive: Prices include tax
Max Discount: Item-level limits
Additional Discount: Invoice-level
Rounded Totals: Exact or rounded

Sales Operations

Credit Sales: Allow payment terms
Partial Payments: Split over multiple methods
Returns: Enable return processing
Write-off: Small change amounts
Silent Print: Auto-print receipts

🛠️ Troubleshooting

Items Not Loading

Check:

Items exist in selected warehouse
Price list has item prices defined
POS Profile warehouse setting
Browser console for errors

Solution: Clear cache and reload

bench --site [your-site-name] clear-cache

Offline Mode Not Working

Check:

Service Worker registered
IndexedDB enabled in browser
Sufficient storage available

Solution: Check browser console, ensure HTTPS (required for Service Workers)

Close Shift Not Working

Status: Fixed in v1.6.0+

Solution: Update to latest version

🏗️ Build for Production

cd apps/pos_next/POS
npm run build
bench build --app pos_next
bench restart

🔌 API Reference

Get Available Offers

frappe.call({
    method: 'pos_next.api.offers.get_offers',
    args: {
        pos_profile: 'Main POS',
        customer: 'CUST-00001'
    },
    callback: (r) => console.log(r.message)
})

Validate Coupon

frappe.call({
    method: 'pos_next.api.offers.validate_coupon',
    args: {
        coupon_code: 'SUMMER2024',
        customer: 'CUST-00001',
        company: 'My Company',
        grand_total: 1000
    },
    callback: (r) => console.log(r.message)
})

Create Invoice

frappe.call({
    method: 'pos_next.api.invoices.create_invoice',
    args: {
        invoice_data: {
            customer: 'CUST-00001',
            items: [
                { item_code: 'ITEM-001', qty: 2, rate: 100 }
            ],
            payments: [
                { mode_of_payment: 'Cash', amount: 200 }
            ]
        }
    },
    callback: (r) => console.log(r.message)
})

🤝 Contributing

We welcome contributions! Here's how:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Install pre-commit hooks: cd apps/pos_next && pre-commit install
Make your changes
Test thoroughly
Commit with clear messages
Push to your fork
Open a Pull Request

Code Quality

We use automated tools to maintain code quality:

Python: ruff, pyupgrade
JavaScript: eslint, prettier
Git: pre-commit hooks

📄 License

AGPL-3.0 License - See LICENSE file for details

This means you can:

✅ Use commercially
✅ Modify
✅ Distribute
✅ Use privately

You must:

📋 Disclose source
📋 Include license
📋 State changes
📋 Share alike

🙏 Credits & Technology

Built with amazing open-source technologies:

Frappe Framework - Full-stack web framework
ERPNext - Open-source ERP
Vue.js 3 - Progressive JavaScript framework
Vite - Next-generation frontend tooling
Tailwind CSS - Utility-first CSS framework
Heroicons - Beautiful hand-crafted SVG icons

📝 Changelog

v1.6.1 (Latest)

Enhanced partial payments with overdue status tracking
Major backend refactoring for better maintainability
Performance improvements

v1.6.0

✨ Implemented free items support for promotional offers
🐛 Fixed tax-inclusive calculation preventing tax being treated as discount
🔧 Improved promotional scheme handling

v1.0.0

🎉 Initial release
✨ Modern Vue 3 interface
🔄 Offline-first architecture
💰 Multi-currency support
🎁 Coupon and offer system
💾 Draft invoice management

🎯 Roadmap

Coming soon:

🍽️ Restaurant Mode - Table management, kitchen display
📱 Mobile App - Native iOS and Android apps
📊 Advanced Analytics - Sales insights, trends, forecasting
🎯 Loyalty Program - Points, rewards, membership tiers
📦 Quick Restock - Low stock alerts, auto-ordering
🖨️ Receipt Customization - Custom templates, branding
🔗 Integration Hub - Payment gateways, accounting software
👥 Customer Display - Facing display for customers

Made with ❤️ by BrainWise

⭐ Star us on GitHub — it motivates us a lot!

Report Bug • Request Feature • Documentation

Name		Name	Last commit message	Last commit date
Latest commit History 356 Commits
.github/workflows		.github/workflows
POS		POS
docs		docs
pos_next		pos_next
scripts		scripts
.clauderc		.clauderc
.editorconfig		.editorconfig
.eslintrc		.eslintrc
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
CHANGELOG.md		CHANGELOG.md
FEATURES.md		FEATURES.md
POS_MIGRATION_PLAN.md		POS_MIGRATION_PLAN.md
POS_SALE_INTEGRATION_PLAN.md		POS_SALE_INTEGRATION_PLAN.md
README.md		README.md
license.txt		license.txt
package.json		package.json
pyproject.toml		pyproject.toml

License

BrainWise-DEV/POSNext

Folders and files

Latest commit

History

Repository files navigation