MiniMart POS SaaS – Complete POS & Store Management
A self-hosted, multi-tenant point-of-sale and store-management platform for retail shops, mini-marts, supermarkets and pharmacies. One install runs unlimited stores — launch it as your own SaaS and sell subscriptions through a dedicated superadmin console with11 payment gateways built in (Stripe, Razorpay, PayPal, Paddle, Paystack, Flutterwave, Xendit, LigdiCash, Tap, Mollie & Payfast), while every store gets a fast, offline-first till. Built with Laravel 13 + React 19. Full source code included.
Hosting Recommendations
Demo
Demo Link: Click for demo
Super Admin Login:
Email: superadmin@example.com
Password: 123456
Store Admin Login:
Email: admin@example.com
Password: 123456
Key highlights
- Multi-tenant SaaS — one codebase, unlimited stores, your own superadmin control plane
- Built-in subscription billing via 9 gateways: Stripe, Razorpay, PayPal, Paddle, Paystack, Flutterwave, Xendit, Payfast, LigdiCash, Tap and Mollie
- White-label landing-page builder, store approve/suspend, impersonation, trial & licence control
- Offline-first POS — keeps selling with no internet, syncs exactly-once when back
- Barcode & weight-scale scanning, split tender (cash, card, UPI, wallet), held orders, customer credit (khata)
- Products: simple, variant, kit & weight-based, categories, brands, units, per-branch pricing
- Inventory: real-time stock, batch & expiry tracking with FEFO auto-pick, stock transfers, adjustments & counts
- Purchasing: POs draft → ordered → received → billed, purchase & sales returns, supplier ledger & payables ageing
- Customers: groups, running credit ledger & full statement, CSV import/export
- Shifts & cash drawer with X/Z reports; role-based staff permissions per branch
- Reports: sales, tax, inventory, receivables & payables — per-branch or consolidated, export to Excel/PDF
- 7 languages including right-to-left Arabic; per-store currency, tax rules & number formats
- Clean, documented Laravel 13 + React 19 + TypeScript codebase with an OpenAPI-documented REST API
Full feature list
Point of Sale
- Offline-capable till that keeps ringing up sales with no internet connection and syncs exactly once when back online, via an Idempotency-Key on every sale and a dead-letter Sync Log screen for anything that needs attention
- Installable as a Progressive Web App
- Barcode and weighing-scale scanning
- Split tender payments (cash, card, UPI, wallet), order-level extra charges, and quick-cash preset amounts on the payment screen
- Held orders, with a dedicated tab separate from sales history
- Real product photo tiles, falling back to a category-matched icon when a product has no photo
- Simple, variant, kit and weight-based products sold directly from the grid, with a variant/weight picker where one is needed
- Quick picks (featured products) pinned to the front of the grid
- Per-variant stock tracking — turn tracking on or off for one option of a product without affecting its siblings
- Batch and expiry aware checkout with automatic FEFO (first-expired, first-out) picking, and a soft warning on prescription-only items
- Customer running credit accounts, selectable mid-sale, with a configurable credit limit
- Shift open and close with a starting float, a cash-count denomination helper, and X and Z reports
- Full keyboard shortcuts for a till operator who never wants to touch a mouse
Catalog & Inventory
- Simple, variant, kit and weight-based products, with categories, brands and units
- One shared, store-wide catalog — only stock and price vary per branch
- Real-time stock on hand backed by a full movement ledger; on-hand is never edited directly, only through a logged stock movement
- Batch and expiry tracking with automatic FEFO picking at checkout
- Low-stock alerts against a configurable reorder level, with a store-wide default a product can inherit or override
- Stock transfers between branches, and stock adjustments and cycle counts through a draft-to-posted lifecycle
- Quick restock — top up on-hand stock directly, without the full purchase-order workflow, when you just need to add stock fast
- Bulk product import
- Barcode label printing
- Pharmacy-specific fields: regulatory code, storage condition and drug schedules, with multi-batch sale traceability
Purchasing & Suppliers
- Purchase orders through a full draft, ordered, received and billed workflow
- Purchase and sales returns
- Supplier ledger, supplier payments and payables ageing
- Purchase order PDF generation
Customers
- Customer groups
- Running credit ledger with a full statement per customer
- Customer payments that settle against one or more outstanding sales
- Bulk CSV import
Reporting
- Sales, tax, inventory and receivables/payables reports
- Per-branch or consolidated views across the whole store
- CSV export from any report view
Multi-branch
- Unlimited branches per store
- Branch-scoped operations — shifts, registers and stock on hand are per branch; the catalog itself is shared store-wide
- Instant branch switching from anywhere in the app
Receipts, Printing & Hardware
- Visual receipt designer
- Printer settings per register, including paper size per printer
- Direct printing from the till, with no print-preview dialog in the way
- Weighing-scale integration with barcode-encoded weight labels
Localization
- Seven languages out of the box, including right-to-left Arabic with full UI mirroring
- Per-store currency, tax rules and number formats
- Store-level currency management, independent of the platform default
SaaS Billing & Subscriptions
- Multi-tenant architecture: one installation, unlimited stores, your own superadmin control plane
- Eleven built-in payment gateways, each with webhook handling: Stripe, Razorpay, PayPal, Paddle, Paystack, Flutterwave, Xendit , LigdiCash, Tap, Mollie and Payfast
- Plans with trial periods and automatic licence-expiry and renewal handling
- Store approval and suspension, and admin impersonation for support
Superadmin Console
- Store management: approve, suspend and impersonate any store
- Platform-level settings: SMTP mail, file storage and push-notification credentials, managed centrally rather than per store
- Live operational alerts across the platform: low stock, expiring batches and ageing held orders
Marketing CMS & SEO
- Block-based landing-page builder — hero, features, pricing, FAQ and more, edited visually with no code
- Server-rendered pages so search engines and link previews see real content, not an empty app shell
- Automatic SEO: robots.txt, sitemap.xml and structured data (JSON-LD)
Storage
- Switchable file storage at the platform level: Local disk, Amazon S3, DigitalOcean Spaces, Wasabi or MinIO
Team & Permissions
- Four built-in roles per store: Store Manager, Admin, Cashier and Inventory Staff
- Branch-scoped permissions
Tech Stack
- Backend: Laravel 13 (PHP 8.3+), MySQL 8
- Frontend: React 19 + TypeScript, React Router 7, TanStack Query, Zustand, Tailwind CSS 4, Vite
- Offline: Dexie (IndexedDB) with a Progressive Web App build
Requirements
- PHP 8.3 or newer
- MySQL 8.0 or newer
- Standard PHP extensions: PDO, Mbstring, OpenSSL, Fileinfo, GD, cURL
- Writable storage/ and bootstrap/cache/ directories
- Ability to run a scheduled cron job
What’s Included
- The complete installable application, ready to deploy as your own multi-tenant POS SaaS
- A guided web installer for database setup and the first admin account
- Full HTML documentation covering installation and day-to-day setup (branches, catalog, counters, customer payments and more)
- A demo data seeder that populates a realistic store — products, sales history, customers and stock — so you can explore the app immediately after install
Sources & Credits
MiniMart POS is built on these open-source projects — thanks to their authors and communities: Laravel, Laravel Sanctum, Laravel Cashier, Spatie Laravel Permission, Spatie Laravel Translatable, React, React Router, TanStack Query, Zustand, Dexie, TipTap, dnd-kit, Intervention Image, DomPDF, Flutterwave PHP SDK, and the payment provider APIs for Stripe, Razorpay, PayPal, Paddle, Paystack, Xendit, LigdiCash, Tap, Mollie and Payfast.
Change Log
v1.0.44/strong>—28 October 2026
- New: Tap and Mollie are now available as payment gateways for subscription payments.
- New: bulk product import now handles files of any size, checks for duplicate SKUs and barcodes before importing, and tells you if your plan’s product limit is reached.
- New: add product photos in bulk by choosing a folder, a set of photos or a ZIP – each photo is matched to its product by SKU.
- Fixed: product search now finds products by barcode on every screen, not just the POS.
- Fixed: the hourly cleanup no longer clears print jobs for every store at once.
v1.0.43/strong>—27 October 2026
- Fixed: Automatic update bug
v1.0.41/strong>—27 October 2026
- Fixed: plans created before the platform’s default currency was changed could not be re-priced in a different currency, which blocked LigdiCash (XOF-only) checkout on existing plans.
- Added a billing currency picker to the plan editor so existing plans can be re-pointed at the right currency.
v1.0.2—25 October 2026
- Added LigdiCash as a new superadmin platform payment gateway, with automatic renewal reminders and grace-period handling for subscriptions.
- Fixed subscription status reporting so past-due subscriptions are shown correctly instead of as cancelled.
v1.0.1—23 October 2026
- Added license activation – enter your purchase code once to activate your installation.
- Added one-click in-app updates – check for and install the latest version directly from Settings.
v1.0.0 — Initial release
Initial release.
Highlights:
- Multi-tenant POS SaaS platform — one install, unlimited stores, dedicated superadmin console
- Offline-capable point of sale: barcode & weighing-scale scanning, split tender, held orders, quick picks
- Per-variant stock tracking, with batch & expiry tracking and automatic FEFO picking at checkout
- Inventory management: stock transfers, adjustments & cycle counts, low-stock alerts, quick restock
- Purchasing workflow (draft → ordered → received → billed), purchase & sales returns, supplier ledger
- Customer running credit accounts, customer groups, CSV import
- Shift & cash drawer management with X/Z reports, branch-scoped staff permissions
- Built-in subscription billing through 8 payment gateways (Stripe, Razorpay, PayPal, Paddle, Paystack, Flutterwave, Xendit, Payfast)
- Block-based marketing CMS with server-rendered SEO (sitemap, robots.txt, JSON-LD)
- 7 languages including right-to-left Arabic
- Built on Laravel 13 (PHP 8.3+) and React 19 + TypeScript, with an OpenAPI-documented REST API













