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*