Add support for folders in Watch app

[joelhawksley]

Summary

It's pretty unwieldy to navigate a long list of items in the current Watch app. By adding the ability to group items into folders, you can now create a mini dashboard of sorts that is significantly easier to use.

For full disclosure, this was my first time writing Swift and otherwise working with Xcode. I had a lot of help from Claude Opus but did what I could to self-review and test.

Screenshots

demo.mov

Link to pull request in Documentation repository

TODO: I will write docs assuming the UI flow is approved.

Any other notes

Related issue: #1422

[Copilot]

Pull request overview

This pull request adds folder support to the Home Assistant Watch app, allowing users to organize their watch items into collapsible folders for better navigation. This addresses issue #1422 which requested folder organization for the watch app.

Changes:

• Adds a new folder type to MagicItem.ItemType with nested items support via the items property
• Implements iOS UI for creating, editing, and managing folders in the Watch configuration view
• Implements watchOS UI for navigating into folders and displaying folder contents
• Updates the communication service to properly handle folder items and their children
• Adds comprehensive unit tests for folder management functionality

Reviewed changes

Copilot reviewed 13 out of 15 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
Sources/Shared/MagicItem/MagicItem.swift	Adds folder type and items property to support nested folder structure
Sources/Shared/MagicItem/MagicItemProvider.swift	Adds folder info provider with folder icon and default name
Sources/App/Settings/AppleWatch/HomeCustomization/WatchConfigurationViewModel.swift	Implements folder management methods (add, update, delete, move items)
Sources/App/Settings/AppleWatch/HomeCustomization/WatchConfigurationView.swift	Adds UI for creating folders with name input sheet
Sources/App/Settings/AppleWatch/HomeCustomization/FolderDetailView.swift	Implements folder content editing view with item management
Sources/App/Settings/AppleWatch/HomeCustomization/FolderEditView.swift	Implements folder customization view for icon, colors, and name
Sources/Extensions/Watch/Home/WatchHomeView.swift	Adds folder navigation with back button and folder row display
Sources/Extensions/Watch/Home/MagicItemRow/WatchFolderRow.swift	Implements Watch folder row UI component with chevron indicator
Sources/Extensions/Watch/Home/MagicItemRow/WatchMagicViewRow.swift	Refactors icon color handling for consistency
Sources/Watch/WatchCommunicatorService.swift	Updates to send folder and nested item info to Watch, handles folder press events
Tests/App/Watch/WatchConfig.test.swift	Adds comprehensive unit tests for folder operations
FolderDetailView.swift	Duplicate file in project root (should be removed)
HomeAssistant.xcworkspace/contents.xcworkspacedata	Adds workspace file reference (likely unintended)
Podfile.lock	Updates HAKit checksum and CocoaPods version (likely unintended)
HomeAssistant.xcodeproj/project.pbxproj	Adds new files to Xcode project

Files not reviewed (1)

• HomeAssistant.xcworkspace/contents.xcworkspacedata: Language not supported

Comments suppressed due to low confidence (2)

FolderDetailView.swift:64

• The project uses SFSafeSymbols for type-safe SF Symbol references. Use systemSymbol parameter instead of systemName with string literals to comply with the coding guidelines and avoid runtime errors from invalid symbol names.

                Image(systemName: "line.3.horizontal")

FolderDetailView.swift:77

• The project uses SFSafeSymbols for type-safe SF Symbol references. Use systemSymbol parameter instead of systemName with string literals to comply with the coding guidelines and avoid runtime errors from invalid symbol names.

                    Image(systemName: "line.3.horizontal")

[bgoncal]

Looking good! I'll be able to review it on Monday, meanwhile feel free to evaluate Copilots comments and address if necessary.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 15 changed files in this pull request and generated 8 comments.

Comments suppressed due to low confidence (1)

Sources/App/Settings/AppleWatch/HomeCustomization/WatchConfigurationView.swift:257

• This passes a hard-coded fallback folder name ("Folder"). Prefer L10n.Watch.Configuration.Folder.defaultName for localization consistency. Also, consider not passing folderName as a separate constant—after editing a folder name in FolderEditView, FolderDetailView’s navigation title won’t update because it uses this captured value.

            NavigationLink {
                FolderDetailView(
                    folderId: item.id,
                    folderName: item.displayText ?? "Folder",
                    viewModel: viewModel
                )

[joelhawksley]

Converting to draft while I fix a bug I found.

[Copilot]

Pull request overview

Copilot reviewed 16 out of 16 changed files in this pull request and generated no new comments.

[bgoncal]

Looking forward to use it on my watch! For some reason I cannot push to your branch anymore, so just fix the linting issues and let's merge it :D

[joelhawksley]

@bgoncal lints fixed!

[joelhawksley]

@bgoncal no worries! Fixed, I think.

[bgoncal]

@joelhawksley I will have to revert your PR, I just noticed that between the massive changes in the .pbxproj file, you set to "auto sign", and this is not correct and also breaks the CI.

Can you revert the changes for this file and then add just what you need (files etc)?

[joelhawksley]

#4396 here you go!