Files
doormile_customer_app/design/screens/README.md
Thiru-tenext 8427824951 A launch that opens in brand, and a sheet that stops resizing
── The splash, in three beats ──

Crimson edge to edge with the truck running across it in white; the invert;
then the mark.

The red starts before Flutter does. Four surfaces painted white before any
Dart runs — launch_background at both API levels, windowSplashScreenBackground
on Android 12+ in light and dark, and the iOS launch storyboard — and leaving
any one of them white makes the launch a white flash followed by a red one.
That flash is the only part of a launch a customer consciously notices.

The invert is one gesture rather than a fade. A white truck on a background
turning white is an invisible truck, so the ground lightens as the truck
darkens, off one controller, and the screen turns itself inside out with the
truck still on it. Fading it would have left the screen empty for the moment
before the mark.

The truck's colour is no longer its own: it is painted through srcIn, so the
file's palette is discarded and only alpha survives. A replacement Lottie now
needs no preparation, and tool/lottie_brand.py is off this path.

`splash.json` is a seamless 3.9s loop — frame 0 is frame 60, the truck never
arrives or departs — so there is no completion to hand over on. _truckBeat is
a decision about how long a launch may hold somebody, not a property of the
file. The comment claiming six seconds was wrong on both counts.

── Three things the splash was getting wrong quietly ──

It showed the wrong logo: doormile-icon.png, the previous mark, to a customer
who had just tapped the new one. tool/icons.py now cuts doormile-mark.png from
the same master alpha as the launcher icon, so they cannot drift again.

The fallback loader was invisible on red. _RoadLoader painted in DmColors.brand
on what used to be a white screen; on crimson that is crimson on crimson, and
it drew nothing at all on exactly the devices that had fallen back to it.

The mark appeared and left in the same frame — _minimum was the sum of the
beats exactly, so the clock ran out as the entrance finished. Hence _markHold.

── The truck was not in the middle ──

Not a layout bug: both beats sit in a Center and always did. The artwork is
drawn low and to the right inside its own 500x500 composition, so a centred
widget rendered an off-centre picture — 30pt right, 36pt down.

splash_centring_test.dart renders a frame at phone size and density, finds the
ink and fails if either beat drifts. It is the only form of test that could
have caught this, and the one that will catch it again when the Lottie is
replaced, which is when the correction goes stale. Two things it taught:
one enormous pump does not let the splash's async start-up chain advance, and
capturing at pixelRatio 1 rasterizes the speed lines too faintly to detect,
which truncates the bounding box and moves the measured centre by 12pt.

── The destination sheet stops resizing ──

Tapping ONE TOUCH opened a tall sheet that snapped shorter a few frames later.
DmAsyncList renders four skeleton rows while it loads — 302pt — and the states
that replace them are nearer 200; the sheet was Flexible, so it was as tall as
whichever state its content happened to be in, and the modal is still
animating up while that swap happens.

The list now lives in a box of one height. That also removes a second resize:
the sheet grew from 48% of the screen to 74% when a state was picked. Both
steps now measure 64% and it never changes size again.

And DmAsyncList takes initialItems, fed by AppState.cachedCities: FutureBuilder
reports `waiting` on its first build even for an already-complete future, so a
warm cache still flashed a skeleton over data it already had.

Three skeleton rows here rather than four — sheet_stability_test caught that
302pt overflows the smallest box the clamp can produce.
2026-09-28 12:54:03 +05:30

50 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Screens
Every screen in the app, at 390×844 @3x, with the real fonts.
These are the golden files from `test/snapshots/`, copied here under readable
names so the set can be browsed, shared or dropped into a deck without anyone
having to know what a golden is. **`test/snapshots/` is the source of truth** —
this folder is a copy, and a stale copy is worse than none, so refresh it
whenever the design moves:
```bash
flutter test test/design_snapshot_test.dart --run-skipped --update-goldens
tool/screens.sh
```
They are rendered by the test harness rather than captured from a handset, so
they are identical on any machine and need no device attached. Two consequences
worth knowing: **map tiles are blank**, because the harness has no network and
CARTO is fetched live; and the data is `DevDoormileApi`'s, so the names,
addresses and references are invented.
| File | Screen | |
| --- | --- | --- |
| [`00-splash-truck.png`](00-splash-truck.png) | **Splash · first beat** | What the app does, in white on the brand crimson the launcher icon opens from. |
| [`00b-splash-invert.png`](00b-splash-invert.png) | **Splash · second beat** | The invert, caught halfway: the ground lightening as the truck darkens, both on one curve. |
| [`00c-splash-mark.png`](00c-splash-mark.png) | **Splash · third beat** | Whose app it is. The same mark the launcher icon is cut from. |
| [`01-sign-in.png`](01-sign-in.png) | **Sign in** | One question, one field, one button. |
| [`02-sign-up.png`](02-sign-up.png) | **Create account** | The same shell, three fields. |
| [`03-verify-code.png`](03-verify-code.png) | **Verify the code** | One field behind four boxes that only draw. |
| [`04-home.png`](04-home.png) | **Home** | Welcome, the pickup address, BOOK, and the live booking. |
| [`05-pickup-search.png`](05-pickup-search.png) | **Collect from** | Changing the pickup address from the Home header. |
| [`06-orders-active.png`](06-orders-active.png) | **Orders · Active** | State, date, route, packages, reference. |
| [`07-orders-completed.png`](07-orders-completed.png) | **Orders · Completed** | Delivered orders and what they cost. |
| [`08-account.png`](08-account.png) | **Account** | Grouped rows, and the build this handset is running. |
| [`09-tracking.png`](09-tracking.png) | **Live tracking** | The live card, the map, the Miler, the journey rail. |
| [`10-cancel-pickup.png`](10-cancel-pickup.png) | **Cancel this pickup** | The one destructive action, behind a reason. |
| [`11-destination-states.png`](11-destination-states.png) | **Where is it going? · states** | Step one, with the state marks. |
| [`12-destination-districts.png`](12-destination-districts.png) | **Where is it going? · districts** | Step two. Multi-select where the server allows it. |
| [`13-pickup-window.png`](13-pickup-window.png) | **Pickup window** | The times, and nothing else. |
| [`14-send-a-parcel.png`](14-send-a-parcel.png) | **Send a parcel** | The route, the packages, the two commitments. |
| [`15-pickup-map.png`](15-pickup-map.png) | **Pickup point** | The map editor, and who the Miler asks for. |
| [`16-pickup-booked.png`](16-pickup-booked.png) | **Pickup booked** | White tick on green. The reference and the live search. |
| [`17-receipt.png`](17-receipt.png) | **Order details** | What was collected, weighed, photographed and paid. |
## Not here yet
**First-run Home** — the sphere's caption and the "How it works" rail only
appear for a customer with no orders, and the dev backend seeds three. It needs
a flag on `DevFlags` to capture, which is not worth adding for a picture.