Offline
- Flights and squawks saved offline are tagged with their user and only sent
while that user is signed in; storage is made persistent; Background Sync
sends them with the app closed (Chromium); unsent count on the app badge
- Report Squawk works offline (photos included, one-time key like flights)
- The Fleet page and, for each of your aircraft, the Overview, W&B, Log
Flight and Report Squawk pages and photo are saved ahead of time, so the
app opens and works without signal; copies say when they were saved
- Sign-out clears saved forms, pages and photos (asks first if items wait)
- Offline page rendered by Rails (localized, follows the theme, no inline
script); service worker version follows the build
Install and notify
- Web Push (web-push gem, VAPID keys from env or storage/vapid_keys.json):
grounding squawks, newly overdue items (daily, once each), signing
requests; per-device on/off and test in Profile -> This device; only
browser push service endpoints accepted
- Manifest shortcuts (Log Flight, Report Squawk via /go/...), lang and
localized description; install help on Profile; reload notice after a
release
Also
- Dockerfile: libssl-dev in the build stage (openssl gem); lockfile checksums
- Leftover English and %{_} interpolation names from the localization pass
- Guide and README updated
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.8 KiB
Getting started
Signing in
Depending on how the app is set up, you can sign in with:
- Email and password. Your administrator creates your account. Use Forgot password? to reset it if email is set up; otherwise ask the administrator.
- Email me a sign-in link. Enter your email and use the link sent to you. It works once, for a short time.
- Single sign-on (for example Sign in with Authentik), if your organization uses it.
If you've set up an authenticator app (see Your profile), signing in with a password or an emailed link then asks for its 6-digit code.
After 10 failed tries in a row (wrong passwords or codes), an account is locked for 15 minutes and its owner is emailed. Wait, or ask the administrator to unlock it.
The very first visit to a new installation asks for the administrator account instead.
Roles
What you can do depends on your role on each aircraft:
| Pilot | Owner | Admin | |
|---|---|---|---|
| See everything on the aircraft | ✓ | ✓ | ✓ |
| Log flights, update hours, report squawks, add notes, oil and fuel | ✓ | ✓ | ✓ |
| Defer a squawk as inoperative | ✓ | ✓ | ✓ |
| Sign logbook entries (with your own certificate) | ✓ | ✓ | ✓ |
| Edit squawks and notes, resolve squawks | ✓ | ✓ | |
| Components, logbook, inspections, ADs, documents, major records, W&B | ✓ | ✓ | |
| Edit the aircraft, manage people and share links | ✓ | ✓ | |
| Users, settings, procedures and audits for the whole app | ✓ |
Anyone can add an aircraft and becomes its owner. You only see aircraft you have a role on; admins see all of them.
Finding your way around
- Fleet (top left) lists your aircraft with their airworthiness.
- Each aircraft has tabs: Overview, Components, Squawks, Flights, Oil & Fuel, Logbook, Inspections, ADs, Documents, Major Records, W&B, Notes, Activity.
- Log Flight and Report Squawk are at the top of every aircraft page. Next to them, More has the status report and, for owners, Access & sharing, editing the aircraft, and its downloads.
- Each section shows its main action as a button (such as + New Entry). Less frequent ones, such as imports, exports and printing, are under that section's More button.
- Search (the box in the top bar, or ☰ → Search on a phone) looks through the logbook, squawks, notes, ADs, documents (including the text of their pages), components, flights and major records of your aircraft at once.
- Your name (or ☰ on a phone) leads to your Profile, this Help, and for admins the Admin pages.
On a phone
The app works on phones. The tabs collapse into a Section menu, and wide tables scroll sideways.
Install it like an app from Profile → This device (or in Safari: Share → Add to Home Screen). Installed, it:
- opens from the home screen, with Log Flight and Report Squawk shortcuts on a long press of its icon;
- logs flights and reports squawks without signal and sends them when the connection is back (see Flights and Squawks); the number waiting shows on the icon;
- opens without signal: while you're online it saves the Fleet page and, for each of your aircraft (up to 10), the Overview, W&B, Log Flight and Report Squawk pages and its photo, refreshed at most hourly. So at the plane you can check airworthiness and loading, and log or report as usual. A copy shown offline says when it was saved;
- can show notifications (Profile → This device).
When a new version is installed on the server, a notice offers Reload. Signing out clears the forms and pages the device kept; flights or squawks not yet sent stay and are sent the next time you sign in on that device. They're only ever sent under the account that saved them.
The sun/moon button switches between light and dark themes.