Build Log

Known Phase 2: Share + Circle-lite

June 28, 2026

Private caregiver card link, helper note form, and recent notes panel — the first real Known Circle.

KnownUXAuthCircle

schema columns added

new routes built

access tiers shipped

Timeline

Start

Ideation + shaping pass

Public vs private framing corrected — 'private caregiver link' not 'public card'

1hr

Schema + middleware + server actions

4 columns pushed to Neon, proxy.ts updated, sharing.ts actions written

2hr

Feature 1: private caregiver card

/care-card/[shareToken] route, SharePanel on authenticated card page

3hr

Feature 2: helper note link

/add-note/[helperToken], HelperNoteForm, POST /api/helper-note, HelperPanel on portrait page

3.5hr

Feature 3 + tsc clean

Recent notes tag display, tsc --noEmit passed, committed

What shipped

Schema: shareToken, sharingEnabled, helperToken, helperEnabled on portraits — pushed to Neon

proxy.ts: /care-card and /add-note added as public routes (no Clerk auth required)

lib/actions/sharing.ts: enableSharing, disableSharing, enableHelper, disableHelper server actions

/care-card/[shareToken]: read-only caregiver card — noindex, warm theme, 'Before you visit' brief, print button, 'shared privately by family' footer

SharePanel: toggle sharing on/off, copy private link, explanatory copy — wired into authenticated /card page

POST /api/helper-note: validates helperToken, writes handoff_note entry, never touches permanent memories

/add-note/[helperToken]: helper note form — tag chips (General/Helped/Avoid/Ate/Mood/Follow-up), note body, optional name, done confirmation

HelperPanel: toggle helper link on/off, copy link — wired into portrait page

Recent notes panel: tag label chip now shows for helper-submitted notes alongside contributor name and time