# Components Index

Use this file to find scene and component guidance. Each entry lists when to use it.

## Available references

- Windowing: `references/windowing.md` — Use when choosing between `WindowGroup`, `Window`, `DocumentGroup`, or window-opening APIs.
- Settings: `references/settings.md` — Use for dedicated settings scenes, preference storage, and settings entry points.
- Commands and menus: `references/commands-menus.md` — Use for menu items, keyboard shortcuts, focused actions, and command routing.
- Split views and inspectors: `references/split-inspectors.md` — Use for sidebar-detail apps, inspectors, and selection-driven desktop layouts.
- Menu bar extras: `references/menu-bar-extra.md` — Use when the app belongs primarily in the menu bar.

## Adding entries

- Add a new reference file when a macOS-specific pattern comes up repeatedly.
- Keep each reference short, actionable, and explicit about when SwiftUI is enough versus when AppKit interop is warranted.