From a64df52f939c1b3bb235934fc3a2e46592c19b5e Mon Sep 17 00:00:00 2001 From: Thomas Richter Date: Thu, 29 Jan 2026 05:11:54 +0100 Subject: [PATCH] docs(02): capture phase context Phase 02: Core CRUD - Quick capture: fixed bottom, title+content, remember last type - Layout: mixed cards/compact, tasks then thoughts, hide completed - Editing: inline expand, auto-save, swipe to delete --- .planning/phases/02-core-crud/02-CONTEXT.md | 79 +++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 .planning/phases/02-core-crud/02-CONTEXT.md diff --git a/.planning/phases/02-core-crud/02-CONTEXT.md b/.planning/phases/02-core-crud/02-CONTEXT.md new file mode 100644 index 0000000..a423caa --- /dev/null +++ b/.planning/phases/02-core-crud/02-CONTEXT.md @@ -0,0 +1,79 @@ +# Phase 2: Core CRUD - Context + +**Gathered:** 2026-01-29 +**Status:** Ready for planning + + +## Phase Boundary + +Users can create, manage, and view entries with a responsive, accessible UI. This phase delivers: +- Entry list displaying tasks and thoughts +- Quick capture for fast entry creation +- Entry editing (title, content, type, completion status) +- Delete functionality +- Adding notes to existing entries +- Mobile-responsive UI with readable fonts + +Tags, images, search, and pinning are separate phases. + + + + +## Implementation Decisions + +### Quick Capture +- Fixed at bottom of page (thumb-friendly on mobile) +- Two fields visible: title and content +- After submit: clear input, scroll to and briefly highlight new entry +- Default type: remember last used (sticky preference) +- Type toggle should be visible in capture UI + +### Entry List Layout +- Mixed layout: cards on desktop, compact list on mobile +- Info shown per entry: title, content preview (truncated), type indicator (badge/icon) +- Do NOT show dates in list view (keep it clean) +- Default ordering: tasks first, then thoughts (within each group: newest first) +- Completed tasks: hidden by default with toggle to show + +### Entry Editing Flow +- Inline expand: clicking entry expands it in place to show edit fields +- No page navigation or modal for editing +- Auto-save: changes save as you type (debounced) +- Delete: swipe to delete gesture (mobile-friendly) +- Adding notes: append to content field (no separate notes section) + +### Task Completion +- Checkbox to mark complete +- Completed tasks disappear from main list (hidden by default) +- Toggle in UI to show/hide completed tasks + +### Claude's Discretion +- Exact swipe gesture implementation +- Auto-save debounce timing +- Visual design of type indicators +- Animation timing for highlight effect +- Responsive breakpoint for card vs compact switch + + + + +## Specific Ideas + +- Bottom capture bar should feel natural on mobile — like messaging app input +- Entry expansion should be smooth, not jarring +- Type indicator should be obvious at a glance (tasks actionable, thoughts reference) +- Font sizes must accommodate older eyes (minimum 16px base as per requirements) + + + + +## Deferred Ideas + +None — discussion stayed within phase scope. + + + +--- + +*Phase: 02-core-crud* +*Context gathered: 2026-01-29*