56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
|
# Onboarding concept cards
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Status: Current
|
|||
|
|
Owner: _null
|
|||
|
|
Last reviewed: 2026-08-18
|
|||
|
|
Governs: docs/design/dist/** — the onboarding concept set and what it is for
|
|||
|
|
Review trigger: Any concept set added or replaced here; the onboarding artwork
|
|||
|
|
in issue #29 landing in the app
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> **These are references, not assets.** Nothing in this folder ships in the APK.
|
|||
|
|
> They are the decided *direction* for onboarding, drawn from
|
|||
|
|
> [`../BRAND_GUIDE.md`](../BRAND_GUIDE.md) §22's master prompt, and the vectors
|
|||
|
|
> that eventually ship are drawn *from* them.
|
|||
|
|
|
|||
|
|
Seven cards, one per onboarding step, numbered to match the steps in
|
|||
|
|
`app/src/main/kotlin/dev/privacyllc/period/feature/onboarding/OnboardingScreen.kt`:
|
|||
|
|
|
|||
|
|
| File | Step | Composable |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| `onboarding-01-welcome.webp` | 1 | `Welcome` |
|
|||
|
|
| `onboarding-02-last-period-start.webp` | 2 | `LastPeriod` |
|
|||
|
|
| `onboarding-03-period-end.webp` | 3 | `PeriodEnd` |
|
|||
|
|
| `onboarding-04-previous-history.webp` | 4 | `PreviousHistory` |
|
|||
|
|
| `onboarding-05-privacy-promise.webp` | 5 | `PrivacyPromise` |
|
|||
|
|
| `onboarding-06-reminder-privacy.webp` | 6 | `NotificationPrivacyStep` |
|
|||
|
|
| `onboarding-07-first-forecast.webp` | 7 | `FirstForecast` |
|
|||
|
|
|
|||
|
|
## Why they are not the shipping assets
|
|||
|
|
|
|||
|
|
Recorded here so nobody drops them into `res/drawable` and calls #29 done. The
|
|||
|
|
full argument, with evidence, is in the comment on that issue.
|
|||
|
|
|
|||
|
|
- **They are raster.** The set is 340 KB as WebP; it was 12 MB as PNG, against a
|
|||
|
|
1.9 MB release APK. §42 asks for Compose vector paths or `VectorDrawable`.
|
|||
|
|
- **The titles and subtitles are painted into the pixels**, and the app already
|
|||
|
|
renders all seven itself through `Heading(...)`. Used as-is, every title
|
|||
|
|
appears twice — and baked text cannot be translated, cannot scale with the
|
|||
|
|
user's font size, and is invisible to TalkBack.
|
|||
|
|
- **They are light mode only.** `BRAND_GUIDE.md` §22 names the dark palette, and
|
|||
|
|
[`../README.md`](../README.md) requires a light/dark preview pair per screen.
|
|||
|
|
A vector set recolours from theme tokens; a raster set has to be drawn twice.
|
|||
|
|
- **Card 7 shows a fertile window and ovulation**, which the first-forecast
|
|||
|
|
screen deliberately does not — on a fresh install it shows confidence Low and
|
|||
|
|
Today reads "Not enough history to estimate". That conflict is a product
|
|||
|
|
decision to settle before anything is drawn, not a detail to fix in the art.
|
|||
|
|
|
|||
|
|
## Provenance and format
|
|||
|
|
|
|||
|
|
Generated from `BRAND_GUIDE.md` §22's master prompt, which is the workflow that
|
|||
|
|
section exists to describe. Converted from the delivered PNGs to WebP at their
|
|||
|
|
original 1086×1448 — same resolution, about a fortieth of the bytes, and the
|
|||
|
|
same format [`../../data/img/`](../../data/img/) already uses for the marks
|
|||
|
|
privacyllc.dev renders.
|