Skip to content

Add category folder page to the launcher spine - #328

Merged
BarMal merged 2 commits into
masterfrom
feature/category-folder-page
Jun 13, 2026
Merged

BarMal merged 2 commits into
masterfrom
feature/category-folder-page

Conversation

@BarMal

@BarMal BarMal commented Jun 13, 2026

Copy link
Copy Markdown
Owner

Summary

  • A dedicated "Categories" page appears in the spine (between the app library and pinned page) when grouping is enabled and at least one app has a category assignment
  • Each enabled category renders as a tappable card showing category name and app count
  • Tapping a category card expands via the focus overlay to display a scrollable app stack filtered to that category's apps
  • Page disappears automatically when grouping is toggled off or all assignments are cleared

Implementation notes

  • CalmTheme.CATEGORY_FOLDER_KEY and ChapterPage.categoryFolder() follow the same pattern as all other page types
  • LauncherUiPreferences gains appGroupingEnabled + hasAnyCategoryAssignments (both false by default, so existing tests are unaffected) so ChapterPagePlanner can gate the page without needing settings access
  • CardStackStateKey.categoryFolder() gives stable scroll-position keys keyed to category ids + app counts

Test plan

  • Auto-categorise some apps, enable grouping → Categories page appears in the spine
  • Categories page shows one card per enabled category with correct app counts
  • Tapping a category card opens the focus overlay with that category's apps as a scrollable stack
  • Tapping an app in the expanded overlay opens the app
  • Disabling grouping or clearing assignments removes the page

https://claude.ai/code/session_014SVjLmSTdqY3hSCrK59YFV


Generated by Claude Code

claude added 2 commits June 13, 2026 16:16
Settings → Apps and icons → Categories gains a "Manage categories"
action that opens a dialog listing all categories with Enable/Disable,
Up/Down, and Remove (custom-only) buttons, plus an "Add category"
button for custom entries.

LauncherSettings grows addCustomCategory, setCategoryEnabled,
moveCategory, and removeCategory; removeCategory cleans up any
app-category assignments that referenced the deleted category.

https://claude.ai/code/session_014SVjLmSTdqY3hSCrK59YFV
When app grouping is enabled and at least one app has been assigned to
a category, a dedicated "Categories" page appears in the spine between
the app library and the pinned page. It shows one card per category
(name + app count); tapping a card expands it via the focus overlay to
display a scrollable app stack filtered to that category.

New key CATEGORY_FOLDER_KEY in CalmTheme; new ChapterPage.categoryFolder()
factory; LauncherUiPreferences gains appGroupingEnabled and
hasAnyCategoryAssignments so ChapterPagePlanner can decide presence
without extra parameters; CardStackStateKey gains categoryFolder() for
stable scroll-position keys.

https://claude.ai/code/session_014SVjLmSTdqY3hSCrK59YFV
@BarMal
BarMal merged commit 2761cf1 into master Jun 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants