Files
PodTui/tasks/podtui-navigation-theming-improvements
2026-02-04 12:38:35 -05:00
..
2026-02-04 12:38:35 -05:00

PodTUI Navigation and Theming Improvements

Objective: Implement layered navigation system, fix tab crashes, and integrate sophisticated theming based on opencode

Status legend: [ ] todo, [~] in-progress, [x] done

Tasks

  • 01 — Analyze current navigation and layer system → 01-analyze-navigation-system.md
  • 02 — Fix Discover tab crash → 02-fix-discover-tab-crash.md
  • 03 — Fix My Feeds tab crash → 03-fix-feeds-tab-crash.md
  • 04 — Fix Settings/Sources sub-tab crash → 04-fix-settings-sources-crash.md
  • 05 — Design layered navigation UI system → 05-design-layered-navigation-ui.md
  • 06 — Implement left/right layer navigation controls → 06-implement-layer-navigation-controls.md
  • 07 — Implement enter/escape layer navigation controls → 07-implement-enter-escape-controls.md
  • 08 — Design active layer background color system → 08-design-active-layer-colors.md
  • 09 — Create theme context provider → 09-create-theme-context-provider.md
  • 10 — Implement DesktopTheme type and structure → 10-implement-desktop-theme-types.md
  • 11 — Implement theme resolution system → 11-implement-theme-resolution.md
  • 12 — Create CSS variable token system → 12-create-css-token-system.md
  • 13 — Implement system theme detection → 13-implement-system-theme-detection.md
  • 14 — Integrate theme provider into App component → 14-integrate-theme-provider.md
  • 15 — Update components to use theme tokens → 15-update-components-to-use-themes.md
  • 16 — Test navigation flows and layer transitions → 16-test-navigation-flows.md
  • 17 — Test tab crash fixes and edge cases → 17-test-tab-crash-fixes.md
  • 18 — Test theming system with all modes → 18-test-theming-system.md

Dependencies

  • 01 depends on
  • 02, 03, 04 depends on 01
  • 05 depends on 02, 03, 04
  • 06, 07, 08 depends on 05
  • 16 depends on 06, 07, 08
  • 09 depends on
  • 10 depends on 09
  • 11 depends on 10
  • 12 depends on 11
  • 13 depends on 12
  • 14 depends on 13
  • 15 depends on 14
  • 18 depends on 15, 16, 17

Exit criteria

  • Navigation is clearly visualized with layered backgrounds and active states
  • Left/right keys navigate between layers, enter goes down, escape goes up
  • All tabs (Discover, My Feeds, Settings) load without crashes
  • Settings/Sources sub-tab loads without crashes
  • Theming system works correctly with system/light/dark/auto modes
  • All components use theme tokens consistently
  • No hardcoded colors remain in components
  • All tests pass and crashes are resolved