ruckus

name	ruckus
description	Use when building, testing, or linting the Ruckus iOS app, regenerating the Tuist project, running tests, or adding new Swift files. Covers xcodebuild, tuist, make, swiftlint, and test workflows.
user-invocable	false

Ruckus Build, Test, Lint & Tuist

Build

Build from the command line:

xcodebuild -workspace Ruckus.xcworkspace -scheme Ruckus -destination 'generic/platform=iOS' build

To check for warnings, use clean build — incremental builds skip unchanged files and won't re-emit their warnings:

xcodebuild clean build -workspace Ruckus.xcworkspace -scheme Ruckus -destination 'generic/platform=iOS'

A pre-build script in Project.swift runs make automatically before compiling. This regenerates Backend.swift and res/core.zo from Racket source. No need to run make manually before building.

Tests

Run tests with xcodebuild using the workspace (not the project):

xcodebuild test -workspace Ruckus.xcworkspace -scheme Ruckus \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro'

To run a specific test class:

xcodebuild test -workspace Ruckus.xcworkspace -scheme Ruckus \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro' \
  -only-testing RuckusTests/ClassName

The workspace is required because it includes external dependencies (Noise, Runestone, TreeSitter). The project alone can't resolve them.

Tuist

After modifying Project.swift, run:

tuist generate --no-open

When adding or removing Swift files, regenerate the project so Xcode picks them up. Tuist auto-globs all .swift files — no need to edit Project.swift for new files.

Linting

Always run after modifying Swift files:

swiftlint lint

Fix any violations before finishing.

Swift Configuration

• iOS 26.0+ deployment target
• Swift 6.0 (strict concurrency by default)

Key Files

• Ruckus/racket — Vendored Racket libraries and environment config for runtime execution
• Ruckus/Backend.swift — Auto-generated Swift RPC client (do not edit)
• Ruckus/Backend/Backend+shared.swift — Shared Backend singleton
• Project.swift — Tuist project definition
• Tuist/Package.swift — Swift package dependencies (Noise from ../../Noise/, OpenSSL)