ONBOARDING

How Apron works

A walkthrough for each role — and for whoever is building the thing.

Operator

Ground-ops staff running daily inspections on the apron.

  1. 1
    Pick your site

    Sign in and you land on your sites. Open one to see every object with its live status, compliance and open defects.

    /app/sites
  2. 2
    Pick your object

    Click a card — e.g. Refuel4You — to see its full maintenance profile, schedule and history.

    /app/objects/refuel4you
  3. 3
    Run the checklist

    Press “Run daily check”. Step through each item: Pass it, or Flag an issue. Record values where asked.

  4. 4
    Flag what's wrong

    Flagging an item opens a note + photo field. On submit, each flagged item becomes a defect linked to that check.

  5. 5
    Submit

    Submit the inspection. The check run and any defects are saved; the object's schedule rolls forward automatically.

Planner

Maintenance planners coordinating work across the site.

  1. 1
    Review defects

    The Defects page lists every reported issue across all objects, filterable by status.

    /app/defects
  2. 2
    Raise a work order

    Create a work order — standalone or from a defect — and assign it to an internal team or a third-party provider.

    /app/work-orders
  3. 3
    Watch compliance

    The Compliance dashboard shows the overall score, per-object rollup and an overdue-first timeline of maintenance + certificate expiry.

    /app/compliance

Third-party provider

External maintenance providers servicing assigned objects.

  1. 1
    Open your work order

    Work orders assigned to you show a restricted service portal.

    /app/work-orders/wo-001
  2. 2
    Upload records

    Attach the service record, certificate (with expiry) and any calibration results.

  3. 3
    Sign off

    Add remarks, type your name and sign off. The work order is completed and the documents land on the object's audit trail.

Developer

Running and shipping Apron.

  1. 1
    Install

    npm install — Node 24, Next.js 16.

  2. 2
    Environment

    Copy the Clerk + Neon keys into .env.local (see docs/INFRA.md).

  3. 3
    Database

    npm run db:push to sync the schema, npm run db:seed to load demo data.

  4. 4
    Develop

    npm run dev for the local server, npm test for the unit tests.

  5. 5
    Ship

    Push to main — Vercel auto-deploys to apron-app.vercel.app.