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.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
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.
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.
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.
Always run after modifying Swift files:
swiftlint lint
Fix any violations before finishing.
Ruckus/racket — Vendored Racket libraries and environment config for runtime executionRuckus/Backend.swift — Auto-generated Swift RPC client (do not edit)Ruckus/Backend/Backend+shared.swift — Shared Backend singletonProject.swift — Tuist project definitionTuist/Package.swift — Swift package dependencies (Noise from ../../Noise/, OpenSSL)No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Use after making changes to visually validate the app in the iOS Simulator. Builds, installs, launches the app, then uses screenshots and accessibility descriptions to verify the change looks and behaves correctly.
The English summary is being prepared. Showing the original description.
Prepare a release by bumping the build number, collecting user-facing changes into a changelog, and committing the result.
The English summary is being prepared. Showing the original description.
Use when working with the Racket backend, adding or modifying RPC methods, or understanding the Racket-Swift communication layer. Covers define-rpc, Backend.swift codegen, and the Noise RPC framework.
The English summary is being prepared. Showing the original description.