Skip to content

Document dev environment setup for SwiftApp (macOS/Xcode-only) #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
aj327 wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

Document dev environment setup for SwiftApp (macOS/Xcode-only) #1

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# SwiftApp

A minimal UIKit iOS demo app (a single `ViewController` with a button that updates a label). Created with Xcode in 2017 targeting iOS 10.3, Swift 3.0.

## Project layout

- `SwiftApp/` — app sources: `AppDelegate.swift`, `ViewController.swift`, storyboards (`Base.lproj/*.storyboard`), `Info.plist`, `Assets.xcassets`.
- `SwiftApp.xcodeproj/` — Xcode project (single app target `SwiftApp`, no unit/UI test target).

## Building & running (macOS + Xcode required)

This is an Apple platform app that depends on `UIKit` and Xcode's iOS toolchain/simulator. Build and run it on macOS:

- Open in Xcode: `open SwiftApp.xcodeproj`, then press Run (select an iOS Simulator).
- Or from the command line: `xcodebuild -project SwiftApp.xcodeproj -scheme SwiftApp -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 15' build`

There are no automated tests (the scheme's `Testables` list is empty), no linter configured, and no dependency manager (no CocoaPods/SPM/Carthage) in this repo.

## Cursor Cloud specific instructions

- Cursor Cloud Agent VMs are **Linux (Ubuntu)**. This is an **iOS/UIKit app that can only be built and run on macOS with Xcode** (it needs the `iphoneos`/`iphonesimulator` SDK and `UIKit`, neither of which exist on Linux). Xcode does not run on Linux.
- Consequently, on the Cloud Agent VM you **cannot build, run, lint, or test** this app. There is no Linux-installable dependency that changes this — the open-source Swift toolchain for Linux still lacks `UIKit`.
- There is nothing to install for a Linux dev environment; the update script is intentionally a no-op.
- To actually develop/verify changes, use a macOS machine with Xcode (see the build/run commands above). Cloud agents should limit themselves to static source edits and code review, and clearly flag that build/run/test verification must happen on macOS.