Set up Tuist project, AGENTS.md, and GitHub CI

.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Build & Test
+    runs-on: macos-26
+    steps:
+      - uses: actions/checkout@v4
+      - uses: jdx/mise-action@v3
+      - run: tuist test

.gitignore

@@ -1,13 +1,13 @@
-# Xcode
-#
-# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
+# Tuist managed
+Derived/
 
-## User settings
+# Xcode
+build/
+DerivedData/
+*.xcodeproj
+*.xcworkspace
 xcuserdata/
 
-## Obj-C/Swift specific
-*.hmap
-
 ## App packaging
 *.ipa
 *.dSYM.zip
@@ -18,45 +18,19 @@ timeline.xctimeline
 playground.xcworkspace
 
 # Swift Package Manager
-#
-# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
-# Packages/
-# Package.pins
-# Package.resolved
-# *.xcodeproj
-#
-# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
-# hence it is not needed unless you have added a package configuration file to your project
-# .swiftpm
-
 .build/
 
 # CocoaPods
-#
-# We recommend against adding the Pods directory to your .gitignore. However
-# you should judge for yourself, the pros and cons are mentioned at:
-# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
-#
-# Pods/
-#
-# Add this line if you want to avoid checking in source code from the Xcode workspace
-# *.xcworkspace
+Pods/
 
 # Carthage
-#
-# Add this line if you want to avoid checking in source code from Carthage dependencies.
-# Carthage/Checkouts
-
 Carthage/Build/
 
 # fastlane
-#
-# It is recommended to not store the screenshots in the git repo.
-# Instead, use fastlane to re-generate the screenshots whenever they are needed.
-# For more information about the recommended setup visit:
-# https://docs.fastlane.tools/best-practices/source-control/#source-control
-
 fastlane/report.xml
 fastlane/Preview.html
 fastlane/screenshots/**/*.png
 fastlane/test_output
+
+# System
+.DS_Store

.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+tuist = "4.40.0"

AGENTS.md

@@ -0,0 +1,42 @@
+# Stuff – Repository Shape
+
+## Build system
+
+| Tool  | Version | Pinned via   |
+|-------|---------|--------------|
+| Tuist | 4.40.0  | `.mise.toml` |
+
+Tuist manifests live at the repo root (`Project.swift`, `Tuist.swift`).
+Run `./ide` (or `./ide -i` to also install dependencies) to regenerate the
+Xcode project.
+
+## Targets
+
+_No apps or modules yet._ Add targets to `Project.swift` using `macApp()` or `framework()` helpers.
+
+## Deployment
+
+| Platform                     | Minimum OS  |
+|------------------------------|-------------|
+| iPhone, iPad, Mac Catalyst   | iOS 26.0    |
+| macOS (native)               | macOS 26.0  |
+
+## Directory layout
+
+```
+<TargetName>/
+  Sources/    – production code
+  Tests/      – unit tests (Swift Testing, not XCTest)
+  Resources/  – asset catalogs, etc. (apps only)
+```
+
+## Conventions
+
+- **Swift Testing** (`import Testing`) for all unit tests – do not use XCTest.
+- Generated `.xcodeproj` and `Derived/` are git-ignored; never commit them.
+- Bundle IDs follow `com.stuff.<suffix>`.
+
+## Plans
+
+Implementation plans go in `Plans/` and are named
+`<NNN>-<YYYY-MM-DD>-<slug>.md`.

Project.swift

@@ -0,0 +1,70 @@
+import ProjectDescription
+
+let macDestinations: Destinations = [.mac]
+let macDeployment: DeploymentTargets = .macOS("26.0")
+
+func framework(
+    _ name: String,
+    bundleIdSuffix: String,
+    dependencies: [TargetDependency] = []
+) -> [Target] {
+    [
+        .target(
+            name: name,
+            destinations: macDestinations,
+            product: .framework,
+            bundleId: "com.stuff.\(bundleIdSuffix)",
+            deploymentTargets: macDeployment,
+            sources: ["\(name)/Sources/**"],
+            dependencies: dependencies
+        ),
+        .target(
+            name: "\(name)Tests",
+            destinations: macDestinations,
+            product: .unitTests,
+            bundleId: "com.stuff.\(bundleIdSuffix).tests",
+            deploymentTargets: macDeployment,
+            sources: ["\(name)/Tests/**"],
+            dependencies: [.target(name: name)]
+        ),
+    ]
+}
+
+func macApp(
+    _ name: String,
+    bundleIdSuffix: String,
+    infoPlist: [String: Plist.Value] = [:],
+    dependencies: [TargetDependency] = []
+) -> [Target] {
+    [
+        .target(
+            name: name,
+            destinations: macDestinations,
+            product: .app,
+            bundleId: "com.stuff.\(bundleIdSuffix)",
+            deploymentTargets: macDeployment,
+            infoPlist: .extendingDefault(with: infoPlist),
+            sources: ["\(name)/Sources/**"],
+            resources: ["\(name)/Resources/**"],
+            dependencies: dependencies
+        ),
+        .target(
+            name: "\(name)Tests",
+            destinations: macDestinations,
+            product: .unitTests,
+            bundleId: "com.stuff.\(bundleIdSuffix).tests",
+            deploymentTargets: macDeployment,
+            sources: ["\(name)/Tests/**"],
+            dependencies: [.target(name: name)]
+        ),
+    ]
+}
+
+let project = Project(
+    name: "Stuff",
+    options: .options(
+        defaultKnownRegions: ["en"],
+        developmentRegion: "en"
+    ),
+    targets: []
+)

README.md

@@ -1,2 +1,36 @@
 # Stuff
-Random apps and stuff 
+
+Random apps and stuff.
+
+## Requirements
+
+- Xcode 26+
+- [mise](https://mise.jdx.dev) (manages Tuist version)
+- iOS 26.0+
+
+## Getting started
+
+```bash
+# Install mise (if needed)
+brew install mise
+
+# Generate the Xcode project
+./ide
+
+# Or install dependencies first, then generate
+./ide -i
+```
+
+## Project structure
+
+```
+Project.swift       Tuist project manifest
+Tuist.swift         Tuist configuration
+.mise.toml          Pins Tuist 4.40.0
+ide                 Dev script – regenerates Xcode project
+AGENTS.md           Repository shape for AI agents
+```
+
+## License
+
+Apache 2.0 – see [LICENSE](LICENSE).

Tuist.swift

@@ -0,0 +1,3 @@
+import ProjectDescription
+
+let config = Config()

ide

@@ -0,0 +1,20 @@
+#!/bin/bash
+set -euo pipefail
+
+INSTALL=false
+
+for arg in "$@"; do
+    case "$arg" in
+        -i|--install)
+            INSTALL=true
+            ;;
+    esac
+done
+
+if [ "$INSTALL" = true ]; then
+    echo "==> tuist install"
+    mise exec -- tuist install
+fi
+
+echo "==> tuist generate"
+mise exec -- tuist generate