Add guidance to SwiftUI skill docs recommending a stable view tree and avoiding top-level conditional branch swapping. Updated swiftui-performance-audit/SKILL.md and swiftui-view-refactor/SKILL.md to include checklist bullets, a new section with examples demonstrating preferred (single base view, localized conditions) vs. avoid patterns, and an updated refactor step order to emphasize stable structure. This reduces root identity churn, unnecessary invalidation, and improves SwiftUI diffing and performance.
Added new reference guides for building macOS Settings windows and customizing menu bar commands in SwiftUI. Updated the components index to include links to these new resources.
Adds guidance on using `.sheet(item:)` over `.sheet(isPresented:)` for model-driven state, and recommends that sheets own their actions and handle dismissal internally. Includes code examples and best practices for sheet usage in SwiftUI.
Introduces a new reference file describing the lightweight, closure-based client pattern for SwiftUI apps. Updates the components index to include a link to this new guidance, supporting easier discovery and usage of small, testable API clients.
Updated documentation to clarify that Sparkle relies on the `CFBundleVersion` (build number) for update checks, and that `BUILD_NUMBER` must be incremented for each release. This helps ensure proper update behavior when using Sparkle.
Introduces new documentation for SwiftUI UI patterns, providing best practices and component guidance, and for macOS SwiftPM app packaging without Xcode, including scaffolding and build scripts. These additions help developers with UI composition in SwiftUI and packaging macOS apps using SwiftPM.
Updated SKILL.md and release.md to include steps for creating a git tag and publishing a GitHub release with the app zip and appcast. This provides clearer guidance for distributing releases via GitHub.
Introduce a set of templates, scripts, and documentation for scaffolding, building, packaging, signing, and notarizing SwiftPM-based macOS apps without Xcode. Includes bootstrap project skeleton, build and packaging scripts, signing/notarization helpers, and reference guides for setup, packaging, and release workflows.
Removed the old 'app-scaffolding-wiring.md' reference and added a new, more comprehensive 'app-wiring.md' guide covering TabView, NavigationStack, sheet routing, and global dependency graph setup. Updated 'components-index.md' to reference the new guide and reflect the expanded focus on dependency management.
Updated SKILL.md to reference project concurrency settings and added a new reference guide for Swift 6.2 approachable concurrency mode. The new guide covers detection, expected behavior changes, recommended fixes, and common pitfalls for projects using main-actor-by-default and default actor isolation.
Introduces recommendations for splitting large SwiftUI view files using private extensions and MARK comments to organize helpers, async functions, and subviews. This helps maintain readability and structure in files exceeding approximately 300 lines.
Added a new reference file detailing best practices for loading states and placeholders in SwiftUI, including usage of redacted placeholders and ContentUnavailableView. Updated the components index to include a link to the new loading & placeholders documentation.
Added a new reference file for title menus, including usage patterns, examples, and design guidance. Updated the components index to include a link to the new title menus reference.
Introduces the 'swiftui-ui-patterns' skill to docs/skills.json, providing best practices and example-driven guidance for building SwiftUI views and components. Adds SKILL.md and a comprehensive set of reference files covering TabView, NavigationStack, sheets, forms, controls, grids, overlays, haptics, focus handling, media, matched transitions, split views, and more.
Replaces hardcoded skills in docs/app.js with dynamic loading from a generated docs/skills.json. Adds scripts/build_docs_index.py to generate the index from SKILL.md files, and a pre-commit hook to keep the index in sync. Updates README with setup instructions for the pre-commit hook.
Introduced a new section describing the GH Issue Fix Flow, outlining its purpose, key features, and usage for resolving GitHub issues using the `gh` CLI, local edits, builds/tests, and git push.
Introduces SKILL.md outlining the end-to-end process for resolving GitHub issues using gh, local code changes, XcodeBuildMCP, and git. The guide covers intake, code location, implementation, build/test, commit/push, and reporting steps.
Added detailed recommendations and examples for splitting large SwiftUI view bodies and computed view properties into subviews or dedicated View types. Clarified when to extract subviews and how to structure them for maintainability and reuse. Adjusted section numbering to accommodate the new content.
Introduced a theme toggle button in the docs header, allowing users to switch between light and dark modes. Theme preference is saved in localStorage and applied on load. Updated CSS to support theme variables and improved code block styling for both themes.
Introduces a new documentation site under the docs/ directory, including index.html, app.js, and styles.css. The site lists and describes iOS Codex skills, provides navigation, and displays markdown-based instructions and references for each skill. Also adds a .DS_Store file.
Introduces a new section describing the SwiftUI Performance Audit feature, outlining its purpose, key features, and usage scenarios to help users diagnose and improve SwiftUI runtime performance.
Introduced SKILL.md with a comprehensive workflow for auditing and improving SwiftUI runtime performance, including code review, profiling, diagnosis, and remediation steps. Added summarized Apple and WWDC resources under the references directory to support performance analysis and best practices.
Added a new reference file summarizing SwiftUI-specific concurrency guidance from WWDC, covering actor isolation, Sendable closures, and async work structuring. Updated SKILL.md to include a link to this new reference for easier access to SwiftUI concurrency best practices.
