Quick StartInstallationCommon SetupWeb PlatformMobile App
Version 1.0.0Web + App

Quick Start

From an empty server to a working FieldOps platform and a Flutter app build.

Item: FieldOps | Multi-Vendor Service Management Platform With Flutter Mobile App  ·  Stack: Laravel 13 · PHP 8.3+ · MySQL 8 · Flutter 3.47 (Dart 3.13)

The Fast Path

Who does what? Steps 1, 3 and 5 need someone with server access (upload, database, cron, worker) or a Flutter developer (the app). Everything else, including branding, payment gateways, messaging, AI keys, plans and languages, is done in the browser without code. Full table: Start Here: Who Does What.

Install the web app first, with the guide for your hosting: VPS guide or cPanel guide. Then connect your services and build the app.

1. Install the web app

A complete step-by-step guide for a VPS and another for cPanel, including the 5-step installer.

Open →
2. First run

Sign in, add your branding and set up your company.

Open →
3. Connect services

Mail, a payment gateway with its webhook, and optionally SMS, WhatsApp, push and Claude.

Open →
4. Build the app

Flutter with --dart-define=API_BASE_URL=https://your-domain.

Open →

What Is in the Package

FolderContents
Main_Files/WebSourceCodeThe Laravel 13 web app: platform console, company workspace, customer portal, public website, REST API v1, installer, migrations, seeders, deploy/ (nginx, PHP, Supervisor, cron, deploy script) and the tests
Main_Files/AppSourceCodeThe Flutter app (Android and iOS from one codebase) with its README.md
documentationThis documentation: Quick Start, Common Setup, Web Platform and Mobile App

Plain, readable PHP and Dart: no encoded files. The compiled CSS/JS are in public/build, so Node.js is only needed when you rebuild them. The package has no vendor/ folder; the install guides include the one command that creates it.

1. Install the Web App

Choose the guide for your hosting and follow it from top to bottom. Each guide covers everything: upload, PHP libraries, database, HTTPS, the web installer and background jobs.

VPS guide

An Ubuntu 24.04 server with SSH. Copy and paste commands.

Open →
cPanel guide

Shared hosting with cPanel. Mostly clicks.

Open →

2. First Run

  1. Sign in

    Open /login with the owner account from the installer. You land in the company workspace; the platform console is at /admin.

  2. Brand it
    System → Platform settings: name, logos, favicon, website design, panel theme, currency, time zone.
  3. Set up the company
    Settings → Workspace settings, Branches, Users & access (add technicians), Price book.
  4. Readiness report
    php artisan fieldops:check-production lists what is still missing.
Company workspace dashboard
Company workspace dashboard
Platform console dashboard
Platform console dashboard

3. Cron & Queue

Your install guide already sets these up (VPS Step 6 or cPanel Step 7). After a few minutes System → Platform health shows the scheduler heartbeat and the queue. For instant live chat also run Reverb (Common Setup → Reverb). Full details: Cron, Queue Worker.

4. Mail, Payments & Messaging

  1. Mail

    Enter your SMTP details in System → Platform settings (Mail).

  2. Customer payments
    Website & online → Online payments: add SSLCommerz, Stripe, bKash, PayPal, Razorpay, Paystack or Flutterwave in sandbox mode (or bank transfer / manual) and register the webhook URL at the gateway, for example https://app.example.com/payments/stripe/webhook/{company-id} (all URLs and events).
  3. Vendor subscription payments

    Only with the marketplace on: Billing & revenue → Payment gateways, webhook owner platform.

  4. SMS, WhatsApp, push
    Automation → Customer notifications → Channels, then Send test (SMS, WhatsApp & Push).
  5. AI (optional)
    Integrations → AI settings: paste an Anthropic API key and press Test (AI Assistant).
  6. Test

    Book a service on your website, convert it to a work order, assign a technician, complete it in the app and pay the invoice with a sandbox card.

5. Build the App

The Flutter app is in Main_Files/AppSourceCode. It needs only the URL of your web install:

cd AppSourceCode
flutter pub get
flutter run --dart-define=API_BASE_URL=https://app.example.com

Before publishing, change the application id (com.fieldops.app), the app name and icons, add your Firebase files for push, and sign the release with your own keystore and Apple team. Everything is in Mobile App.

The app’s name, logo and brand colour follow your Platform settings at runtime (GET /api/v1/branding), so a rebrand in the console also shows in the app.

6. Go-Live Checklist

Required versus optional items are explained in Ready to Go Live?.

  • APP_ENV=production, APP_DEBUG=false, APP_DEMO=false, APP_URL is your https:// address.
  • HTTPS with a valid certificate; SESSION_SECURE_COOKIE=true.
  • Cron installed; Platform health shows the scheduler heartbeat.
  • Queue worker running on notifications,webhooks,default.
  • Mail is not on log; a test e-mail arrives; SPF/DKIM set.
  • php artisan fieldops:check-production shows 0 critical items.
  • Payment webhooks registered and one sandbox payment confirmed per gateway.
  • Backups enabled, one restore tested, a copy kept off the server; APP_KEY stored safely.
  • Strong passwords and two-factor authentication on admin accounts.

Ongoing Costs

The item price covers the source code. Running the platform has costs you pay to the providers directly: hosting and domain, an e-mail service, payment gateway fees, an SMS provider, WhatsApp Cloud API conversations, Anthropic API usage when you provide the platform AI key, optionally your own OSRM server, and Apple Developer / Google Play Console accounts for the app. Firebase Cloud Messaging and OpenStreetMap maps need no paid account. Full table: Third-Party Services & Costs.