# Phase 2: Calendar Display - Discussion Log

> **Audit trail only.** Do not use as input to planning, research, or execution agents.
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.

**Date:** 2026-06-04
**Phase:** 2-Calendar Display
**Areas discussed:** Visual model / theming, Default view & per-device, Color & shared-vs-personal, Event detail density

---

## Visual model → Theming architecture

Initial framing (pick one aesthetic) was reformulated after the user clarified they want a
**modular** approach: start clean, but be able to switch to a Skylight/tablet "display" theme
later as family members are added — the real end goal being a **legible tablet wall-display**.

| Option                                | Description                                                                                                     | Selected |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -------- |
| Token layer + clean theme only        | Design tokens (CSS vars + theme object); ship only clean; future display theme = token swap; no switcher UI yet | ✓        |
| Token layer + two themes + toggle now | Build clean + first-cut display theme + runtime toggle now                                                      |          |
| Hardcode clean, refactor later        | No abstraction; retrofit theming at v2                                                                          |          |

**User's choice:** Token layer + clean theme only.
**Notes:** Claude flagged that building two themes + a switcher now is v2 gold-plating (wall-display
is deferred in PROJECT.md); the disciplined "modular" is a token layer with one clean theme. Also
agreed the clean theme must stay legible/informational at tablet distance (D-03), and the color
model must scale past two members.

## Default view & per-device

| Option                             | Description                                            | Selected |
| ---------------------------------- | ------------------------------------------------------ | -------- |
| Phone→Agenda, Tablet/Desktop→Month | Device-adaptive default; remember last-used per device | ✓        |
| Month everywhere                   | Consistent grid; cramped on phone                      |          |
| Agenda everywhere                  | List-first; underuses tablet/desktop                   |          |

**User's choice:** Phone→Agenda, Tablet/Desktop→Month.

## Color & shared-vs-personal

| Option                                  | Description                                                    | Selected |
| --------------------------------------- | -------------------------------------------------------------- | -------- |
| Per-member fill + reserved shared color | Phase-1 member colors; shared calendar gets one distinct color | ✓        |
| Per-member fill + shared marked by icon | Icon instead of reserved color                                 |          |
| Per-calendar color                      | Hue per Fastmail collection, member secondary                  |          |

**User's choice:** Per-member fill + reserved shared color.
**Notes:** Per-member show/hide filter deferred until >2 members; a color legend is shown.

## Event detail density

| Option                        | Description                                                                                                 | Selected |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------- | -------- |
| Informational + tap-to-expand | Bars w/ title (month), time+title (week/day), +location (agenda); read-only popover reused for Phase 3 edit | ✓        |
| Minimal                       | Dots + agenda titles, no popover                                                                            |          |
| Maximal inline                | time+title+location everywhere                                                                              |          |

**User's choice:** Informational + tap-to-expand.

## Claude's Discretion

- Rendering library choice (must be token-styleable, headless-friendly, all 4 views, server-expanded occurrences, good iOS touch) — researcher decides.
- Week start day — default Sunday (US locale), exposed as a token.
- Skeleton/loading + empty states — build, polished for the "slick" constraint.

## Deferred Ideas

- Tablet/wall-display kiosk mode + Skylight display theme + runtime theme-switcher — v2.
- Per-member show/hide filter — when membership > 2.
- Secondary timezone toggle — v1.x.
- Single-occurrence recurring edits — v1.x.
