new-mac-app

1# New Mac app
2 
3The template builds and runs as is. The first build proves the toolchain
4works before you write feature code.
5 
6## What the template is
7 
8A Swift package with one executable target, plus a script that wraps the
9binary in a real `.app` bundle. An agent can read and edit every file.
10 
11```text
12<AppName>/
13  Package.swift          macOS 26, Swift 6.2 tools, main-actor default isolation
14  Info.plist.in          bundle id, name, icon, minimum macOS
15  Icon/AppIcon.icon      the app icon: Icon Composer file, JSON plus SVG layers
16  build.sh               swift build -> .app bundle -> codesign -> ~/Applications
17  CLAUDE.md              build, check, and design rules for agents
18  Sources/<AppName>/
19    App.swift            window, menus, Settings, database location
20    Models.swift         SwiftData models, sidebar pages, AppModel
21    ContentView.swift    NavigationSplitView: sidebar, list, detail
22    Snapshot.swift       APP_SNAPSHOT mode: PNG and layout file per page and Settings tab, light and dark
23    UI/Theme.swift       accent colors, saved choice, accent tokens
24    SettingsView.swift   Settings window: one tab per topic, sized to content
25    UI/AppearanceSettings.swift  Settings: accent picker (mode follows the Mac)
26    UI/WindowBehavior.swift  no focus ring on open, fit to content
27    UI/Grid.swift        the 4 pt spacing scale, layout probes, grid overlay
28  tools/
29    grid-lint.sh         flags spacing numbers off the 4 pt grid
30…