Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

new-mac-app

/new-mac-app

Tworzy natywną aplikację macOS w SwiftUI z gotowego szablonu, z SwiftData, skryptem budowania i git, bez graficznego Xcode.

Repozytorium
dsh-rev-eng ↗
Licencja
MIT
Ostatnia zmiana repozytorium
31.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
30
Skrypty
23
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 31.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 23 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/new-app.sh, template/Package.swift, template/Sources/__APP_NAME__/App.swift, template/Sources/__APP_NAME__/ContentView.swift, template/Sources/__APP_NAME__/Models.swift, template/Sources/__APP_NAME__/SeedData.swift, template/Sources/__APP_NAME__/SelfTest.swift, template/Sources/__APP_NAME__/SettingsView.swift

Co robi i kiedy

Tworzy natywną aplikację macOS w SwiftUI z gotowego szablonu, z SwiftData, skryptem budowania i git, bez graficznego Xcode.

Oryginalny opis (EN)

Create a native macOS SwiftUI app from a working template (Swift package, SwiftData, build script, icon script, snapshot mode, git), with no Xcode GUI. Use when the user wants to start a new Mac app or scaffold a macOS project.

Jak działa

  1. What the template is
  2. Steps
  3. When to switch to an Xcode project
  4. Signing
  5. A CLI for agents
  6. When the build fails
Sekcje z nagłówków SKILL.md, w oryginale · 115 linii, 665 słów
Podgląd SKILL.md
---
name: new-mac-app
description: Create a native macOS SwiftUI app from a working template (Swift package, SwiftData, build script, icon script, snapshot mode, git), with no Xcode GUI. Use when the user wants to start a new Mac app or scaffold a macOS project.
---

# New Mac app

The template builds and runs as is. The first build proves the toolchain
works before you write feature code.

## What the template is

A Swift package with one executable target, plus a script that wraps the
binary in a real `.app` bundle. An agent can read and edit every file.

```text
<AppName>/
  Package.swift          macOS 26, Swift 6.2 tools, main-actor default isolation
  Info.plist.in          bundle id, name, icon, minimum macOS
  Icon/AppIcon.icon      the app icon: Icon Composer file, JSON plus SVG layers
  build.sh               swift build -> .app bundle -> codesign -> ~/Applications
  AGENTS.md              build, check, and design rules for agents
  Sources/<AppName>/
    App.swift            window, menus, Settings, database location
    Models.swift         SwiftData models, sidebar pages, AppModel
    ContentView.swift    NavigationSplitView: sidebar, list, detail
    Snapshot.swift       APP_SNAPSHOT mode: PNG and layout file per page and Settings tab, light and dark
    UI/Theme.swift       accent colors, saved choice, accent tokens
    SettingsView.swift   Settings window: one tab per topic, sized to content
    UI/AppearanceSettings.swift  Settings: accent picker (mode follows the Mac)
    UI/WindowBehavior.swift  no focus ring on open, fit to content
    UI/Grid.swift        the 4 pt spacing scale, layout probes, grid overlay
  tools/
    grid-lint.sh         flags spacing numbers off the 4 pt grid
    check-layout.swift   checks the layout files from snapshot mode
    make_icon.sh         Icon/AppIcon.icon -> Resources/Assets.car + AppIcon.icns (actool)
    icon_review.sh       renders every icon look into one PNG (ictool)
    icon_sheet.swift     joins the renders for icon_review.sh
```

## Steps

1. Check the toolchain:

   ```bash
   swift --version            # Swift 6.2 or later
   sw_vers -productVersion    # 26.0 or later
   ```

   On macOS 15, set `.macOS(.v15)` in `Package.swift` and
   `LSMinimumSystemVersion` to 15 in `Info.plist.in`, and skip Liquid Glass APIs.

2. Pick the name (one UpperCamelCase word) and bundle id (reverse DNS). If
   `docs/BRIEF.md` exists, use its name.

3. Run the script with the parent folder. It copies the template, fills in
   the name and bundle id, runs `git init`, and commits. It keeps a folder
   that holds only a brief.

   ```bash
   "scripts/new-app.sh" Tasks com.yourname.tasks ~/Developer
   ```

   In a Dropbox or iCloud Drive folder the script can take minutes: run it
   in the background.

4. Build the app and its icon, then open it:

   ```bash
   cd ~/Developer/Tasks && ./build.sh --open
   ```

5. Run the checks the template ships with, then look at the snapshots
   (`build-and-verify` skill):

   ```bash
   swift test --scratch-path ~/Library/Developer/Tasks/test-build   # Kit unit tests
   tools/selftest.sh                                                # PASS per check, exit 0
   tools/snap.sh                                                    # sample data, light and dark PNGs
   ```

6. If `docs/BRIEF.md` exists, rename `Item` to the brief's main type and the
   sidebar pages to the brief's pages. Nothing else: features go through
   `improve-loop`, one story at a time. Build, snapshot, commit.

## When to switch to an Xcode project

The Swift package covers most personal apps. Switch to an XcodeGen project
(`project.yml` -> generated `.xcodeproj`, built with `xcodebuild`) when the
app needs App Intents for Shortcuts and Spotlight, an asset catalog, app
extensions, or widgets. Keep `project.yml` in git and the `.xcodeproj` out
of it. Put build output outside Dropbox with `-derivedDataPath`.

## Signing

`build.sh` signs with the first "Apple Development" certificate in the
keychain, or ad hoc without one. Permissions (Accessibility, Screen
Recording, camera) are stored per signature and path. Ad hoc builds ask
again after every rebuild. A free Apple ID makes a certificate in Xcode >
Settings > Accounts > Manage Certificates. Install to the same path every
time.

## A CLI for agents

To let agents or scripts read and change the app's data, call the `skill`
tool with name `agent-cli`. The app binary becomes its own CLI and sends
each command to the running app, so the database keeps one writer and the
window updates live.

## When the build fails

- `cannot find 'X' in scope` after adding a file: SwiftPM cached the file
  list. Run `swift package clean --scratch-path ~/Library/Developer/<AppName>/build`.
- `binary is older than ...`: a file did not compile. Read the first errors.
- Concurrency errors: call the `skill` tool with name `swift-swiftui`.

Done when the app opens from `~/Applications`, the snapshots show every
page in light and dark, and the first commit exists.
Pliki w paczce (30)
  • SKILL.md 5 KB
  • scripts/new-app.sh 2 KB
  • template/.gitignore 1 KB
  • template/AGENTS.md 4 KB
  • template/Info.plist.in 1 KB
  • template/Package.swift 1 KB
  • template/build.sh 2 KB
  • template/Icon/AppIcon.icon/icon.json 1 KB
  • template/Icon/AppIcon.icon/Assets/back.svg 1 KB
  • template/Icon/AppIcon.icon/Assets/front.svg 1 KB
  • template/Sources/__APP_NAME__/App.swift 3 KB
  • template/Sources/__APP_NAME__/ContentView.swift 3 KB
  • template/Sources/__APP_NAME__/Models.swift 2 KB
  • template/Sources/__APP_NAME__/SeedData.swift 2 KB
  • template/Sources/__APP_NAME__/SelfTest.swift 3 KB
  • template/Sources/__APP_NAME__/SettingsView.swift 2 KB
  • template/Sources/__APP_NAME__/Snapshot.swift 6 KB
  • template/Sources/__APP_NAME__/UI/AppearanceSettings.swift 6 KB
  • template/Sources/__APP_NAME__/UI/Grid.swift 6 KB
  • template/Sources/__APP_NAME__/UI/Theme.swift 6 KB
  • template/Sources/__APP_NAME__/UI/WindowBehavior.swift 3 KB
  • template/Sources/__APP_NAME__Kit/ItemTitle.swift 1 KB
  • template/Tests/__APP_NAME__KitTests/ItemTitleTests.swift 1 KB
  • template/tools/check-layout.swift 5 KB
  • template/tools/grid-lint.sh 1 KB
  • template/tools/icon_review.sh 1 KB
  • template/tools/icon_sheet.swift 2 KB
  • template/tools/make_icon.sh 1 KB
  • template/tools/selftest.sh 1 KB
  • template/tools/snap.sh 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Stijnus/dsh-rev-eng100MIT
daveebbelaar/bama100MIT

Migawka bazy z 13.11.2026 · wersja paczki 61926d009a09 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100mac-app
    Buduje lub zmienia małą natywną aplikację macOS w SwiftUI z szablonu, z kontrolą migawek i własnym testem.
  • 98new-win-app
    Tworzy natywną aplikację Windows w WinUI 3 z gotowego szablonu z bazą SQLite, skryptem budowania i gitem, bez Visual Studio.
  • 100swift-app-scaffold
    Zakłada nową aplikację iOS lub macOS: Package.swift i architekturę SwiftUI z Observation, SwiftData, NavigationStack i Swift Testing.
  • 100macos-apps
    Buduje natywne aplikacje macOS w Swift ze SwiftUI i AppKit, obejmując budowanie, debugowanie, testy, optymalizację i wydanie, wyłącznie z wiersza poleceń bez Xcode.
  • 100swift-swiftui
    Podaje zasady pisania kodu Swift 6 i SwiftUI dla aplikacji macOS: współbieżność, stan, SwiftData i naprawę typowych błędów kompilatora.
  • 100swift-swiftui
    Podaje zasady pisania kodu Swift 6 i SwiftUI dla aplikacji macOS: współbieżność, stan, SwiftData i naprawę typowych błędów kompilatora.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.