Build Log

Known v0

June 24, 2026

Scaffolded the Known app — a memory portrait system for dementia families — from research kit to running Next.js app with guided capture, Known Card, and brand treatment.

KnownNew AppProduct

new app scaffolded

guided capture questions

research kit improvements

files committed

Timeline

Start

Research kit review

Reviewed Known_Research_Kit_v0 from prior session — two improvements identified

30m

Research kit improved

Micro version promoted to top of Known Card template; pre-conversation memory dump step added

App decision made

Anvil Check: capture form on ForgeKit website vs. Known as its own app — Known wins

App scaffolded

known/ wired into monorepo, DB schema pushed to Neon, all routes written

Brand applied

KnownColorBrand.png colors extracted, Unsplash hero images, amber overlay treatment

UX iteration

Two rounds of feedback — empty states, relationship label, continue panel, starter prompts

What shipped

known/ Next.js app scaffolded — port 3004, no auth (personal use v0)

DB schema: portraits + portrait_entries tables, pushed to Neon

Home page: full-bleed hero, continue-portrait panel, entry counts, human language

Portrait detail: Known Card always visible (even empty), guided empty state with starter prompts

Guided capture session: 23 questions from research kit, source tracking, privacy toggle, add-to-card per answer

Known Card page: dark editorial treatment, print button, 30-second micro version

New portrait form

API routes: portraits POST, portrait_entries POST

Brand: charcoal/amber/cream palette from KnownColorBrand.png, Recoleta heading font

Unsplash hero images with amber overlay treatment across all pages

Research kit: micro version promoted to top of Known Card; pre-conversation memory dump step added

known/ wired into monorepo workspaces, dev/build scripts added

“For Known, empty should not feel empty. It should feel like the first page of a portrait.”
— Zeb, UX feedback on the portrait detail empty state