🚀 Overview

Geo POS centralizes everyday operations across counters and back office: barcode-driven checkout, customer billing, supplier purchasing, warehouse stock transfers, and end-of-day reconciliation.
It’s designed for shops, supermarkets, pharmacies, cafés, electronics & apparel stores, and small distributors that need reliable POS, accurate inventory, and clean accounting exports.

Experience-driven design: Built around real tills and storerooms — fast item search, offline-tolerant carts (PWA-ready), receipt printers/cash drawers, and practical reports for managers and accountants.

✨ Key Features

• Fast POS Checkout: barcode scan, quick search, hold/resume carts, returns/exchanges, discounts, and notes.
• Billing & Invoicing: tax-inclusive/exclusive pricing, multiple taxes (VAT/GST), credit sales, pro-forma & e-invoices.
• Inventory Control: multi-warehouse stock, transfers, stock adjustments, low-stock alerts, serial/batch & expiry tracking (for pharma/food).
• Product Catalog: variants (size/color), composite/kits, price tiers, purchase & landing cost management.
• Purchasing & Suppliers: RFQ/PO, GRN, supplier returns, payable tracking.
• Customers & CRM Lite: customer groups, store credits, loyalty points, statements, reminders.
• Payments: cash, card, mobile wallet, split payments, gift cards, partial/instalment support.
• Receipts & Documents: thermal receipt and A4 invoice templates, branding, multi-language printouts, email/PDF.
• Multi-Store & Roles: branches with separate registers, user roles (Admin/Manager/Cashier/Auditor) and audit trails.
• Accounting Friendly: chart-of-accounts mapping, taxes, end-of-day Z reports, export to CSV/Excel for bookkeeping tools.
• Reports & KPIs: sales by time/branch/cashier, product performance, margin, stock valuation, ageing, supplier performance.
• Hardware Friendly: works with barcode scanners, thermal printers, cash drawers (via printer kick), and label printers.
• PWA & Offline-Tolerant: continue ringing up sales when the network blips; sync when back online (where enabled).
• Localization: multi-currency, multi-language, number/date formats, RTL support.
• Security: per-register permissions, cash drawer logs, refund approvals, activity logs.

⚙️ Technical Stack

• Framework: PHP framework build (commonly CodeIgniter or Laravel depending on release)
• PHP: 8.1+ recommended
• Database: MySQL 5.7+/8.0 or MariaDB 10.3+
• Frontend: Blade/CI Views, Bootstrap/Tailwind, Vanilla JS/Alpine
• Server: Nginx or Apache with HTTPS; recommended OPCache
• Extensions: pdo_mysql, mbstring, openssl, curl, intl, fileinfo, zip, json
• Build Tools: Composer, Node.js + NPM (if asset pipeline provided)
• Optional: Redis/File cache, PWA service worker

🧩 Installation Guide

1. Upload: deploy files to your Linux hosting or server.
2. Database: create DB & user; set credentials in .env or app config.
3. Dependencies: run composer install --no-dev; generate app key if applicable.
4. Migrate/Seed: php artisan migrate --force (or run the project installer wizard, if included).
5. Assets: npm install & npm run build (when a build pipeline is shipped).
6. Permissions: ensure storage/ and bootstrap/cache (or writable/ for CI) are writable.
7. POS Setup: configure taxes, registers, branches, receipt template, and payment methods.
8. Hardware: set thermal printer (ESC/POS) and barcode scanner keyboard mode; test cash-drawer kick.
9. Harden: enable HTTPS, configure backups, and restrict admin routes.

Tip: Test barcode scanning, returns, and Z report at day-end on staging before going live.

📦 Deliverables

• Complete Geo POS source code (GPL build)
• POS (register) interface + Back-office admin
• Inventory, purchasing, customers & suppliers modules
• Receipt/invoice templates and branding options
• Docs & sample configuration notes
• GPL license text & changelog

📱 Supported Platforms

• Devices: desktop terminals, all-in-one POS PCs, small form factor PCs; tablet-friendly UI for kiosks
• Browsers: latest Chrome, Edge, Firefox; Safari for back office
• OS: Linux server recommended; Windows/macOS acceptable for development/onsite deployments
• Peripherals: barcode scanners (USB HID), thermal printers (ESC/POS), cash drawers (printer-kick), label printers

🧠 Notes

• License: Distributed under the GNU General Public License (GPL) for educational, testing, and lawful self-hosting.
• Customization Tips: avoid core edits; extend via service classes/events and view overrides; keep taxes & receipts in separate config for easy audits.
• Compliance: configure VAT/GST rules per jurisdiction; maintain product batch/expiry where required (pharma/food).
• Performance: enable OPCache/caching, index frequently queried columns, archive old documents for speed.
• Security: enforce strong roles, cashier PINs, refund approvals, and IP-restricted admin access.

👨‍💻 Original Developer Credit

Originally developed by the vendor listed on
CodeCanyon.
Please support the original developer by purchasing a commercial license when required by your use case.

🔒 Disclaimer

This is a GPL redistribution intended for learning, testing, and lawful self-hosting. We are not the original developers and provide no implied warranties.
All trademarks and product names are property of their respective owners. For commercial production, review licensing obligations and obtain a valid license from the original developer when necessary.