Jugaad
Jugaad Tool MITIntermediateShops & POSFree

laravel-pos

A Laravel-based web POS for managing products, sales, customers, suppliers and purchases with automatic purchase stock updates.

Stars
508
Forks
293
Last update
23 Oct 2026

Overview

Laravel POS provides a desktop and tablet sales interface with barcode scanning, product search and order records. It also manages customer and supplier details, tracks purchases and shows sales summaries. Several checkout features remain unfinished in the README checklist.

Who it's for

Small retailers evaluating a self-hosted POSShop owners working with a Laravel developerPHP and Laravel developers learning POS development

Tech stack

PHPLaravelComposerNode.jsnpm

Features and benefits

Key features

  • Dashboard showing total revenue, today's sales and the top-selling product
  • Product management with pagination, search, category filters, prices, stock and images
  • Responsive desktop and tablet POS with barcode scanning, name search and cart quantities
  • Sales/order listing with date filters and detailed order/invoice pages
  • Customer records with name, phone, email and address
  • Supplier records with editable contact information
  • Purchase entry with supplier, date, invoice number, item quantities and costs
  • Automatic product stock updates when purchases are recorded
  • Purchase listing with supplier/date filters and printable 80mm purchase receipts
  • Store name and currency settings

Why it helps in Pakistan

  • Find products through barcode scanning, name search or category filters.
  • Reduce manual stock entry when recording incoming purchases.
  • Review daily sales and top-selling products from the dashboard.
  • Keep customer, supplier and purchase records in one application.
  • Adapt the MIT-licensed code for a shop's requirements.

Pakistan use cases

  • 01

    A Lahore grocery shop can find products by barcode or name and assemble sales carts.

  • 02

    A Karachi stationery shop can record supplier purchases and automatically update product stock.

  • 03

    An Islamabad accessories retailer can review daily sales and filter past orders by date.

  • 04

    A Pakistani Laravel developer can use the project as a starting point for a custom retail POS, while addressing unfinished checkout features.

Requirements

Hardware
Check the official docs
Operating system
Check the official docs
Skills
Command-line dependency installationLaravel environment and database configuration
Accounts needed
Database credentials must be configured in .env.The database seeder creates an initial administrator account.

Setup guide

Commands are copied from the project's README and official docs.

  1. 1

    Check prerequisites

    Check the official docs for Laravel server requirements and OS-specific preparation. Install Composer before installing project dependencies.

    Not fully covered in the README. Check the official docs before running this step.

  2. 2

    Clone the project

    Run git clone https://github.com/angkosal/laravel-pos.git [YourDirectoryName], choosing your directory name, then run cd YourDirectoryName.
  3. 3

    Install PHP dependencies

    Run composer install.
  4. 4

    Configure the application

    Copy or rename .env.example to .env. Run php artisan key:generate, then set your database credentials and APP_URL in .env.
  5. 5

    Initialize the database

    Run php artisan migrate, then php artisan db:seed. The seeder initializes settings and creates the administrator account with email admin@gmail.com and password admin123.
  6. 6

    Install and build frontend dependencies

    Run npm install. Use npm run dev for development or npm run build for production.
  7. 7

    Link storage

    Run php artisan storage:link.
  8. 8

    Start the local server

    Run php artisan serve and visit localhost:8000 in your browser. Sign in with the seeded administrator credentials. The README also mentions Laravel Homestead as an alternative.

What it costs

SoftwareFree to self-host under the MIT licence.
HostingHosting costs depend on the server needed to meet Laravel's requirements; RAM and CPU sizing are not stated. Check the official docs and current hosting prices.

FAQ

Can I print customer sales receipts?

Printing or downloading sale receipts is unchecked in the repository's feature list. Printable 80mm purchase receipts are marked complete.

Does it support discounts, refunds and multiple payment methods?

Multiple payment methods, item discounts, invoice discounts, returns and refunds are all marked unfinished.

Does recording purchases update stock?

Yes. The completed purchase features include automatic product stock updates and purchase filters by supplier and date.

Are kitchen printers, a kitchen display and QR menus included?

Those features appear in a separate Khmernokor POS promotion within the README. They are not established as features of this open-source repository.

Is it free to modify for a Pakistani shop?

The repository is MIT-licensed. Store name and currency settings are marked complete, but tax configuration remains unfinished and Pakistan-specific compliance is not documented.

Troubleshooting

The initial administrator account is missing.

Confirm database credentials in .env and that the documented migration and seeding steps completed. The seeder creates admin@gmail.com with password admin123; see the official docs before rerunning database operations on an existing installation.

The application reports a missing application key.

Ensure .env exists and run the documented php artisan key:generate setup command; see the official docs.

Frontend assets are missing or not built.

Check that npm install completed, then use npm run dev for development or npm run build for production; see the official docs.

The local application does not open.

Check server output, Laravel requirements and whether port 8000 is available. Confirm php artisan serve is running and open localhost:8000; see the official docs.

Get it set up for you

Don't want to install it yourself? A Jugaad maker can set up laravel-pos for your business. Payment is held in Safe Deal until it works.

No maker offers a setup gig for this yet. Post a request and makers will quote.

Post a setup request Paid through Safe Deal

Built by angkosal and contributors on GitHub. All credit goes to the authors. GitHub stats refresh daily. Jugaad does not host, copy or sell this code.

Is this your project?