Reading the repo
Reading the repo
Assembly instructions
Laravel-based web POS system with Vue.js, Tailwind CSS, inventory management, sales processing, customer records, reports, and modular extension support.
Saved setup from 1 h ago
Will it work on macOS?
Heads-upIt also needs 48 settings in .env (9 secret).
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/Blair2004/NexoPOS.git cd NexoPOS
Node.js 24.x, PHP ^8.2.0
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install 24 brew install php composer
Fill in secrets: APP_KEY, DB_PASSWORD, REDIS_PASSWORD, MAIL_PASSWORD, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, PUSHER_APP_KEY, PUSHER_APP_SECRET
cp .env.example .env
npm ci composer install
php artisan key:generate php artisan migrate
Run each command in its own terminal.
npm run dev php artisan serve
npm test
NexoPOS is a Laravel application using Vue, Vite, Tailwind CSS, and a first-class module architecture. The root project currently targets PHP 8.2+ and Node.js 24.
composer install
cp .env.example .env
php artisan key:generate
php artisan storage:link
npm install
npm run build
Configure the database and application URL in .env, then run the normal Laravel migrations and workers required by your deployment. The exact production setup depends on whether you use queues, scheduled reports, Reverb, multi-store, printing, or other modules.
Create a new module with the built-in generator:
php artisan make:module
Custom module source normally lives under modules/ and contains its own routes, providers, migrations, resources, assets, settings, and tests. Start with the module creation guide, then see the module config guide, dashboard menu guide, and NexoPOS API documentation.
NexoPOS also documents extension points for dashboard menus and widgets, Vue components, POS cart buttons and product mutation, receipts and invoices, settings, events, and MCP integrations.
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.