Skip to content

feat: visual refactor to match hi-fi prototype + hero banner - #27

Merged
damarals merged 21 commits into
mainfrom
feat/visual-refactor-foundation
May 7, 2026
Merged

damarals merged 21 commits into
mainfrom
feat/visual-refactor-foundation

Conversation

@damarals

@damarals damarals commented May 7, 2026

Copy link
Copy Markdown
Owner

Summary

Brings the implementation in line with the hi-fi prototype unpacked into docs/design/, plus a hero banner for the README.

Foundation (mechanical changes):

  • Replaced muted brand palette with the prototype's saturated values (lime #58CC02 Duolingo green, navy ramp anchored on #0F172A, etc.); added 11 missing tokens (navy950/800/600/400/50, limeL, goldD/L, pinkL, cyanD, redD)
  • Inverted font roles: Nunito for display+body, Fraunces reserved for years only, JetBrains Mono added for ISRCs/file names/log lines
  • Loaded Nunito 800/900 + Fraunces 600/700/900 + JetBrains Mono 500/700
  • New SVG components from real brand assets: BrandMark, Wordmark (text-only TO/CARTA bicolor), Vinyl
  • New PushButton primitive with the signature pushable shadow (5px lift collapsing to 1px on press)
  • Added boxShadow.push-{lime,pink,gold,red} and shadow-card Tailwind utilities

Library + Generate + Resolving screens rebuilt from the prototype: gradient hero ScanCTA with bleeding BrandMark, prototype DeckCard layout, mono URL input, "What happens next" steps surface, spinning glowing BrandMark on Resolving with gold progress bar and live log.

Review + Card detail + Export + Scanner + Playback + Import all redesigned to the prototype: ScreenHeader pattern, InlineAlert, IconButton, IndeterminateBar new primitives. Visualizations now use the BrandMark itself (Vinyl) and brand-coded gradients (Rings).

Card detail front/back faithful to ADR-0014 + docs/_card-design-preview.html:

  • Front: white, 36mm QR centered with 8mm top padding, "tocarta" Fraunces 600 5mm 0.5mm below QR. No corner glyph, no ISRC tail, no scan caption, no play pill.
  • Back: era-colored, year (Fraunces 600 21mm) → artist (Nunito Bold 4mm) → title (Nunito Regular 3.5mm at 85% opacity), centered with 4mm padding. No decorative rings.

README hero banner (1660×474) at .github/banner.png rendered from .github/banner-mockup.html via Playwright. Big "tocarta" wordmark with vinyl substituting the "o" of "to", tilted phone preview of the Library home, four era-colored cards (1958 Johnny B. Goode · 1971 Stairway to Heaven · 1985 Take On Me · 2013 Get Lucky) fanned around the phone. README updated with banner + CI/license/last-commit badges + tagline, matching the convention of the other Daniel Amaral repos (olheiro, letras, wizard).

Test plan

  • npm test — 140 pass
  • npm run typecheck clean
  • npm run lint clean (no-restricted-imports rule on expo-av still gates non-player imports)
  • Manual web preview: npx expo start --web — confirms screens render with new palette/typography (CORS still blocks Deezer/MusicBrainz; expected, manual via APK)
  • Manual device test once APK is built

damarals added 21 commits May 7, 2026 20:43
Replace the brand palette with the prototype values in docs/design/tocarta.css
(Duolingo-flavored lime/pink/gold and a 9-step navy ramp), introduce serif and
mono font roles (Fraunces reserved for year numbers, JetBrains Mono for
technical microcopy), and swap display from Fraunces to Nunito. Era colors
remain as ADR-0014 specifies.

Tailwind picks up the new tokens automatically and gains push-button shadow
utilities mirroring --vd-btn-lift / --vd-btn-press from the prototype. Semantic
CSS variables in global.css now map navy900/navy50/lime/pink/gold to the new
hexes. The PDF renderer snapshot updates to track tokens.colors.navy900.
Add the heavier Nunito weights (800 ExtraBold, 900 Black) and JetBrains Mono
500/700 the prototype relies on for big display headers and ISRC microcopy.
Drop Nunito_700Bold-only loading and switch the default header font from
Fraunces to Nunito so it matches the new display role.
Replace the ASCII placeholders with SVG translations of the prototype assets
in docs/design/assets/. BrandMark renders the spinning vinyl (lime stroke,
navy disc, navy700 grooves, pink center, sheen arc) with optional spin and
multi-color glow halo (cross-platform: iOS shadow, Android elevation +
colored halo). Wordmark renders the bicolor TO/CARTA next to the mark in the
'split' default plus 'full' and 'mark-only' variants. Vinyl exposes the
small decorative ornament for accents like the ScanCTA background.

The library/* paths re-export from components/brand/* so existing screens
keep importing from @/components/library/{BrandMark,Wordmark} until the
screen-side refactor migrates the paths.
Tocarta's signature CTA — a 5px solid colored shadow that collapses to 1px
on press while the button itself slides 3px down so the surface meets the
shadow. Five variants (primary/secondary/danger/warn use a lime/pink/red/gold
shadow; ghost is a flat outlined button) and three sizes (sm/md/lg) cover the
prototype's call sites. The rnr/shadcn Button at components/ui/button.tsx
stays for utility surfaces; PushButton is the brand-flavored option.
@damarals
damarals merged commit 6972f53 into main May 7, 2026
1 check passed
@damarals
damarals deleted the feat/visual-refactor-foundation branch May 7, 2026 20:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant