Posify POS

Posify POS is a complete, single-application Point of Sale system built on Laravel 12. It covers every aspect of a retail or food business:

Everything runs as one Laravel application — no separate frontend server required, and the admin and POS work in a phone browser. An optional Flutter staff app is included as source in posify-app.zip if you want a native companion for the shop floor; it is not needed to run the POS. Follow this documentation to install and configure Posify POS on your server.

Posify POS is a monolithic Laravel application — one codebase, one deployment. Livewire handles reactive UI components server-side, so no separate JS build server is needed in production.

Verify your hosting environment before installation.

Deploy Posify POS on your VPS. You can use the web installer (no SSH needed for setup) or install manually via SSH.

1

Download from Envato

Log in to CodeCanyon → Downloads → Posify POS → Download All Files & Documentation. Extract the ZIP.

2

Upload Project to Server

Option A — SCP / FTP

scp posify-pos.zip user@YOUR_VPS_IP:/var/www/
ssh user@YOUR_VPS_IP
cd /var/www && unzip posify-pos.zip -d posify-pos

Option B — Git

sudo mkdir -p /var/www/posify-pos
cd /var/www/posify-pos
sudo git clone https://github.com/your-repo/posify-pos.git .

3

Configure .env & Choose Install Method

Option A — Web Installer

Copy .env.example → .env, then visit the installer in your browser and follow the on-screen steps — no SSH needed for the rest of the setup:

https://yourdomain.com/install

Installer Steps Preview

Step 1 — System Requirements

Step 2 — Purchase & Database

Step 3 — Admin Account

Step 4 — Installation Complete

Option B — Manual (SSH)

Copy and edit .env via SSH, then run artisan commands:

cd /var/www/posify-pos
cp .env.example .env
nano .env   # set APP_URL, DB_* values

composer install --optimize-autoloader --no-dev
php artisan key:generate
php artisan migrate --force
php artisan db:seed --force
php artisan storage:link
php artisan optimize

4

Set Folder Permissions

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

✓

Test the Installation

Open your browser and visit the admin panel — you should see the login page.

https://yourdomain.com

Key settings available from Admin → Settings after installation.

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_FROM_ADDRESS=no-reply@yourdomain.com
MAIL_FROM_NAME="Posify POS"

Posify POS ships with QUEUE_CONNECTION=sync in .env — emails and notifications are sent immediately during the request, so everything works out of the box with no worker process and no extra setup.

QUEUE_CONNECTION=database

php artisan config:clear

sudo apt install -y supervisor
sudo nano /etc/supervisor/conf.d/posify-worker.conf

[program:posify-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/posify-pos/artisan queue:work database --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=1
redirect_stderr=true
stdout_logfile=/var/www/posify-pos/storage/logs/worker.log
stopwaitsecs=3600

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start posify-worker:*

* * * * * php /home/yourusername/posify-pos/artisan queue:work --stop-when-empty

All modules available in Posify POS v1.0.0.

📊 Overview

Dashboard

Real-time overview of store performance — today's revenue, orders, top products, and low-stock alerts.

• ✓ Daily, weekly, and monthly revenue charts
• ✓ Total orders and top-selling products
• ✓ Low-stock product alerts
• ✓ Recent order activity feed

🖥️ POS

POS Terminal

Fast checkout screen with barcode scan-to-add, split payments, discounts, and instant thermal receipt printing.

• ✓ Barcode scan-to-search (USB/Bluetooth scanner)
• ✓ Cash, card, and split payment support
• ✓ 80mm / 58mm thermal receipt + A4 PDF
• ✓ Redeem customer loyalty points at checkout
• ✓ Orders sync with inventory automatically

📦 Inventory

Products & Inventory

Full product catalog with categories, brands, units, variants, and warehouse-level stock tracking.

• ✓ Products with variants, addons, and images
• ✓ Categories, brands, and units of measure
• ✓ Per-warehouse stock levels and movements
• ✓ Stock transfers between warehouses
• ✓ Printable barcode label sheets (server-side SVG)

🚚 Purchasing

Suppliers & Purchase Orders

Manage supplier relationships and purchase orders from order creation through stock receiving.

• ✓ Supplier CRUD with contact details
• ✓ Purchase orders with line items and costs
• ✓ Receive stock into inventory from POs
• ✓ Track supplier payments and balances

🏧 Register

Cash Register & Returns

Full shift management with Z-Reports and a complete returns/refund flow with restock option.

• ✓ Open/close register sessions with opening cash
• ✓ Cash in/out movements during shift
• ✓ Printable Z-Report on close
• ✓ Return items against an order (with optional restock)
• ✓ Payment status auto-updates to partial/full refund

🔐 Access

Roles & Permissions

Fine-grained role-based access control — define exactly what each staff member can see and do.

• ✓ Unlimited custom roles (cashier, manager, admin)
• ✓ Toggle individual permissions per role
• ✓ Assign multiple roles to one user
• ✓ Activity log of all admin actions

⚙️ Config

Settings & Utilities

Store settings, multi-language management, database backup/restore, and more — all from the admin panel.

• ✓ Store info, currency, tax, and receipt settings
• ✓ Loyalty points earn/redeem rates
• ✓ Multi-language with admin-editable translations
• ✓ Database backup & restore (no shell needed)

Posify ships a token-authenticated REST API under /api/v1, built on Laravel Sanctum. It is what the staff mobile app talks to, and it is available for your own integrations. No extra setup is needed — it is enabled on every install.

Getting a token

curl -X POST https://yourdomain.com/api/v1/login \
  -H "Accept: application/json" \
  -d "email=you@example.com&password=your-password"

# -> { "token": "1|abcdef...", "user": { ... } }

Send it on every subsequent request:

curl https://yourdomain.com/api/v1/products \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|abcdef..."

Endpoint groups

The full endpoint table, with every route and its description, is in README.md in the application root.

Your download includes posify-app.zip — the full Flutter source for an optional staff companion app (Android and iOS). It gives staff product and price lookup, camera barcode scanning, customer and order lookup, inventory and low-stock views, and the support desk on the shop floor.

✅ Requirements

Verify your setup with flutter doctor — every item should show a green checkmark before you start. Publishing also needs a Google Play and/or Apple Developer account.

🚀 Installation

Extract posify-app.zip, open the folder, and install dependencies:

cd posify-app
flutter pub get

Set your base URL (next section), then run it on a connected device or emulator:

flutter run
flutter run -d android    # pick a target explicitly
flutter run -d ios

🔗 Base URL setup

The app ships pointing at a placeholder and fails fast with a config error until you set your own domain. Open lib/utils/constants.dart and edit the ApiEndpoints class:

// lib/utils/constants.dart
class ApiEndpoints {
  static const String baseUrl = String.fromEnvironment(
    'API_BASE_URL',
    defaultValue: 'https://pos.your-domain.com/api/v1',  // replace this
  );

Or leave the file alone and pass it per build — this wins over the default:

flutter run --dart-define=API_BASE_URL=https://pos.your-domain.com/api/v1
flutter build apk --release --dart-define=API_BASE_URL=https://pos.your-domain.com/api/v1

To test against a backend on your own machine:

• Android emulator → http://10.0.2.2:8000/api/v1
• iOS simulator → http://127.0.0.1:8000/api/v1

Plain HTTP is allowed only for those two hosts; every other host must be HTTPS. A Herd/Valet .test domain will not work on the iOS simulator — its self-signed certificate is untrusted.

✏️ Change the app name

// android/app/src/main/AndroidManifest.xml
android:label="YourAppName"

// ios/Runner/Info.plist
<key>CFBundleName</key>
<string>YourAppName</string>

📦 Change the package name

The app ships as com.axify.posify. Change it to your own before publishing — the store rejects a package ID you do not own. Android uses the Kotlin Gradle DSL:

// android/app/build.gradle.kts
android {
    namespace = "com.yourcompany.yourapp"
    defaultConfig {
        applicationId = "com.yourcompany.yourapp"
    }
}

Then find-and-replace com.axify.posify across the project (Ctrl+Shift+R, or ⌘+Shift+R on macOS) and check these landed:

• android/app/build.gradle.kts
• android/app/src/main/AndroidManifest.xml
• android/app/src/main/kotlin/ — the folder structure must mirror the new ID
• iOS bundle identifier — set in Xcode, see below

flutter clean && flutter pub get && flutter run

🎨 Change the app icon

Replace assets/icons/posify-app-icon.png with your own square PNG — 1024×1024, no transparency (iOS rejects an alpha channel). Then regenerate every size for both platforms:

dart run flutter_launcher_icons

No external icon generator needed — flutter_launcher_icons is already set up under the flutter_launcher_icons: key in pubspec.yaml. Re-run it whenever you change the source image.

🤖 Build for Android

Step 1 — Create a signing keystore. Back up the .jks file and its passwords somewhere safe and private: lose them and you cannot ship an update to an existing listing.

keytool -genkey -v -keystore ~/upload-keystore.jks \
  -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias upload

Step 2 — Create android/key.properties by copying android/key.properties.example and filling it in:

storePassword=your_store_password
keyPassword=your_key_password
keyAlias=upload
storeFile=/absolute/path/to/upload-keystore.jks

Step 3 — Build. Use an AAB for the Play Store; an APK for direct install or sideloading:

# AAB — Google Play Store
flutter build appbundle --release
# Output: build/app/outputs/bundle/release/app-release.aab

# APK — direct install
flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk

# Split APKs — smaller download per device
flutter build apk --release --split-per-abi

🍎 Build for iOS

Step 1 — Install CocoaPods dependencies:

cd ios && pod install && cd ..

Step 2 — Open the workspace (not the .xcodeproj):

open ios/Runner.xcworkspace

Step 3 — Configure signing. Select the Runner target → Signing & Capabilities → set your Team, and change the Bundle Identifier to your own (e.g. com.yourcompany.posify).

Step 4 — Archive and distribute:

flutter build ipa

Or from Xcode: set the scheme to Any iOS Device → Product → Archive → in Organizer, Distribute App → App Store Connect.

The same instructions, plus an API endpoint reference and security notes, are in README.md inside posify-app.zip.

1. Download the new release ZIP from your CodeCanyon downloads page.
2. Put the site into maintenance mode: php artisan down
3. Replace the application files, but keep these: your .env, storage/ (uploads and logs), and public/storage if it is a real symlink.
4. Reinstall dependencies: composer install --no-dev --optimize-autoloader
5. Apply any new migrations: php artisan migrate --force
6. Clear stale caches: php artisan optimize:clear
7. Repair the uploads symlink if images 404: php artisan posify:install-assets
8. Bring it back up: php artisan up

If you run a queue worker, restart it after updating so it picks up the new code: php artisan queue:restart. See the Queue Worker section.

Posify POS bundles open-source libraries. Most use permissive MIT/BSD/Apache licenses; two are LGPL and worth knowing about:

The full list of bundled third-party libraries and their licenses is in credits.txt in the application root.