Setup Order

Follow the three stages in order. Each app needs the backend's API to be live and reachable over HTTPS first.

Stage 1 · Web Backend (Laravel)

Install the Laravel source from the WebSourceCode folder onto your server. Full details are in the Web (Admin & POS) guide — the steps below link straight to each one.

1. Check server requirements

   PHP 8.3+, MySQL 8.0+, Composer, Node.js. The web installer verifies each item on its first screen.

2. Create the database

   Make a MySQL database + user (cPanel wizard) and keep the name, user and password ready.

3. Upload files & set environment

   Upload WebSourceCode, point the web root at public/, create .env and set writable permissions.

4. Run the installer

   Open your domain, fill in the database details and create your first admin account — it migrates and seeds automatically.

5. Log in to the admin panel

   Sign in at the randomized admin login slug, then set store name, currency, logo and payment gateways in Settings.

6. Optional add-ons — Real-time chat, Push (Firebase), S3 storage

   Turn these on when you need them. Push is also required if you want the mobile apps to send notifications — the full Firebase procedure is in Common Setup.

Stage 2 · POS App (Flutter)

Build the counter app from the PosAppSourceCode folder. Full details are in the POS App guide.

1. Set up Flutter

   Install Flutter (stable) + Android Studio / Xcode, then run flutter doctor and fix any issues.

2. Point it at your backend

   Run flutter pub get, then set kBaseUrl and kAppApiKey in lib/core/env/prod_env.dart (release) — base URL https://yourdomain.com/api/v10, key from Settings → API Security.

3. Add Firebase (for push)

   Drop in google-services.json / GoogleService-Info.plist; iOS also needs the APNs key uploaded to Firebase. Full steps in Common Setup.

4. Rebrand — name, id & icon

   Change the app name and package/bundle id to your own, then generate icons with dart run flutter_launcher_icons.

5. Build & release

   Create a keystore + key.properties for Android; set your Team & bundle id in Xcode for iOS. Build the .aab / .ipa and publish.

6. Open a register and sell

   Log in as a cashier, confirm the branch, open a cash register on one of its counters, then scan or search products and take payment.

Go-Live Checklist

A quick pass before you open the doors to real customers:

• Site served over valid HTTPS and the web root points at public/.
• php artisan key:generate ran and APP_KEY is set (the installer does this).
• Store name, currency, timezone, logo/favicon set in Settings.
• Payment gateways switched to live keys (test keys only process test payments). Using Stripe or PayPal? Also set the charge currency, paste the Stripe webhook URL & signing secret, and make sure every currency has an exchange rate — a missing rate blocks international payments.
• Scheduler cron added (schedule:run) if you use scheduled push campaigns, backups or nightly currency-rate updates.
• Legal pages reviewed under Website → Pages — Privacy, Terms and Return & Refund ship with placeholder text.
• Mail/SMTP configured so OTP and notification emails send.
• Both apps point at the production API URL and were rebuilt after any config change.
• Firebase push tested on a real Android and iOS device (iOS needs the APNs key).
• Real-time chat (Reverb) kept running under Supervisor if you use live chat.