Mobile Field Service GitHub

Home · Docs

Developers

Start here. Then the rest of the docs make sense.

Demo the phone with no cluster. Capella free tier is enough to sync. Architecture, schemas, and replication are reference after that.

Path

Getting started

See the example field jobs → run the app in demo → Capella account → Terraform or Ansible → point wss. Modes are developer config, not one phone for all three jobs.

Open getting started

Three modes

Assets · Jon Hale

["assets"]

Today = work orders. Map on. Writes: workorders*, assets (link only), inventory txs, notes, messages.

Walkthrough

Customer · Maya Chen

["customer"]

Today = jobs + orders. After the WO, a new ord: (maybe a new cus:). Catalog prices; no card payment.

Walkthrough

Sales · Priya Shah

["sales"]

Today = orders (no Walk-up job). Map plots customers and order sites. Writes: orders, field customers, inventory txs. Pull: products, rates, taxes.

Walkthrough

// field.users — mode switch is data, not a new binary
{
  "type": "user",
  "employeeId": "E-4412",
  "email": "jon.hale@example.com",
  "workModes": ["assets"]
}

Guides

Getting startedDemo, Capella free tier, deploy, point the replicator. Day in the lifeIndex of the three walkthroughs. ArchitectureDatabase tree, copy-on-write, queries, freeze. DeploymentCapella cluster + App Services. Terraform or Ansible. SchemasJSON Schema 2020-12 per collection. AuthEmail, session, Keychain, 401. ReplicationAllow-list, filters, simple vs oneshot. SettingsEnv, Profile, debug, Keychain. LoggingEvents, redaction, no secrets. UI styleTheme, touch targets, no emoji icons. ReleaseVersion, cadence, what to bump. Release notesPhase 12 mode-aware Search, Map, Today. RoadmapShipped slices; vector still off. FAQOffline, copy-on-write, sync HUD, schemas.