Commit Graph

3 Commits

Author SHA1 Message Date
null 807b8a4600 docs: add the empty-state illustration, completing the set
EmptyStateIllustration in both themes — Today's "nothing logged yet" state, and
the one illustration the onboarding set did not cover. Without it, onboarding
would have shipped real art while Today kept a placeholder a user sees in the
same session.

Deliberately unnumbered: it is not an onboarding step. Its ring is empty because
nothing has been logged, which is the same ring the other illustrations fill with
cycle-day markers — that is what makes the empty state read as waiting rather
than broken.

Two things recorded in dist/README.md for whoever redraws these as vectors:

- The fourteen onboarding illustrations are contained cards with a rounded
  frame; these two are full-bleed with none. The frame should be consistent
  across the set or deliberately absent from all of it.
- TodayScreen.kt calls EmptyStateIllustration(color = ..., size = ...) with a
  single colour. These are full-colour drawings, so the vector version takes no
  colour parameter and that call site changes with it.

Both were checked at the 110-160 dp the illustrations are actually drawn at, by
rendering them at that size rather than assuming: the detail survives, including
the five faint dots under the ring.

WebP at delivered resolution: 312 KB for all sixteen against 6.8 MB as PNG.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 20:10:19 -05:00
null 081257f69c docs: onboarding illustrations, matched light and dark
Seven illustrations in a matched pair, replacing the single light-only concept
set added in 9d2a4b2. Named for the composables they replace, and identical in
dimensions per card so a theme switch swaps the image without moving the layout.

Three corrections happened during review and each is easy to reintroduce by
regenerating carelessly, so dist/README.md records them:

- No text painted into the pixels. The app renders all seven titles through
  Heading(...) already; art carrying its own title prints every heading twice,
  cannot be translated, cannot scale with font size, and is invisible to
  TalkBack.
- No step-number badge. LearningIllustration is also the Insights empty state,
  where a "4" means nothing, and baked numbers freeze a running order that has
  already changed once.
- 07_Forecast names no fields. One draft listed Fertile window and Ovulation,
  which the first-forecast screen deliberately withholds — on a fresh install it
  reports confidence Low and Today reads "Not enough history to estimate". A
  later draft named the right fields but painted "Confidence — Low"
  permanently, wrong for anyone with a settled cycle. Naming nothing is the only
  version that cannot contradict the live forecast.

The dark set is a real dark composition rather than the light one dimmed, on the
midnight-plum ground BRAND_GUIDE.md §22 specifies.

WebP at the delivered resolution: 204 KB for all fourteen against 3.4 MB as PNG.
Delivery .zip archives are gitignored; the superseded concept set is removed and
remains recoverable at 9d2a4b2.

#29 stays open — these are references, and the vectors that ship are drawn from
them.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 19:53:23 -05:00
null 9d2a4b2fb1 docs: add the onboarding concept cards as references, not assets
Seven cards, one per onboarding step, supplied by the owner and generated from
BRAND_GUIDE.md §22's own master prompt — which is the workflow that section
exists to describe. They settle the direction #29 asked for, including all four
steps that had no art at all.

They are NOT the shipping assets, and docs/design/dist/README.md says so at the
point somebody would otherwise drop them into res/drawable:

- raster, against a 1.9 MB release APK and §42's ask for vector paths
- titles and subtitles painted into the pixels, while the app already renders
  all seven through Heading(...) — used as-is every title appears twice, and
  baked text cannot be translated, scaled with font size, or read by TalkBack
- light mode only, with dark mode inbound and a preview-pair rule that exists
  because dark mode was silently broken for all of Batch 01
- card 7 shows a fertile window and ovulation that the first-forecast screen
  deliberately withholds; on a fresh install it shows confidence Low and Today
  reads "Not enough history to estimate"

Converted from the delivered PNGs to WebP at the original 1086x1448: same
resolution, 340 KB instead of 12 MB, and the format docs/data/img already uses.
Renamed from the generator's default filenames so the set reads as a sequence.

#29 stays open with the assessment recorded as a comment on it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 19:28:50 -05:00