Skip to main content

Welcome to ShelfWise

A complete multi-tenant inventory management platform with integrated POS, e-commerce storefront, payroll system, and supplier management.

Get startedExplore features
Multi-tenant
Isolated data per organization
Complete POS
Barcode scanning & receipts
Payroll system
Tax calculation & NIBSS export

Quick start

Get ShelfWise up and running in minutes

1

Clone and install dependencies

Clone the repository and install PHP and Node.js dependencies.
git clone https://github.com/gHoSTeCHs/shelfwiser.git
cd shelfwiser
composer install
npm install
2

Configure environment

Copy the example environment file and generate your application key.
cp .env.example .env
php artisan key:generate
Update your .env file with database credentials and other configuration values.
3

Run migrations

Set up the database schema and seed initial data.
php artisan migrate --seed
4

Start the development server

Launch the application with Laravel server, queue worker, and Vite for asset compilation.
composer dev
This runs php artisan serve, php artisan queue:listen, and npm run dev concurrently.

Explore by feature

Discover what ShelfWise can do for your business

Inventory management

Track products, variants, stock movements, and set reorder alerts

Point of Sale

Complete POS with barcode scanning, cart management, and receipt printing

E-commerce storefront

Launch your online store with customizable settings and payment integration

Supplier management

Manage supplier connections, catalogs, and purchase orders

Payroll system

Process payroll with tax calculation, deductions, and NIBSS export

Multi-shop support

Manage multiple shops with individual currencies and VAT settings

Architecture overview

Built on Laravel and React with a service-oriented architecture

Service layer

Business logic organized in dedicated service classes

Multi-tenancy

Complete tenant isolation with UUID-based data separation

Inertia + React

Modern frontend with server-side routing and client-side hydration

Authorization

8-level role hierarchy with policy-based access control

Ready to build with ShelfWise?

Start exploring the documentation and set up your first multi-tenant inventory system

Get started now

Build docs developers (and LLMs) love

Get started for freeTalk to us