Development
Requirements
- A Mac with Xcode and the iOS simulator runtime installed.
- Homebrew and
just. - An iPhone with iOS 27 or later for a device build.
- An existing Bluesky account and an app password for sign-in.
Setup and commands
Read the source structure for feature boundaries and shared UI components.
Install just once with Homebrew:
brew install just
Install the project tools:
just install-deps
The project uses XcodeGen to generate the Xcode project from project.yml. The commands below generate the project before they run.
just build # Build for the simulator
just sim # Build and run in the simulator
just device # Build and run on a connected iPhone
just device-release # Install Old Fella Dev on a connected iPhone
just test # Run unit and UI tests in the simulator
just test-agent # Run tests without explicitly opening Device Hub
just lint # Run SwiftLint
Device builds need a signing team and provisioning that work with your Apple account. The project currently specifies a development team in project.yml.
Run just devices to list connected devices. Pass a device UID to just device or just device-release to select one. Run just device-release all to install Old Fella Dev on every connected device.
Old Fella Dev installs alongside the TestFlight app. Register industries.geesawra.oldfella.dev and industries.geesawra.oldfella.dev.share on your signing team. Assign group.industries.geesawra.oldfella.dev to both App IDs. Each app has its own sign-in and local settings.
The simulator commands use an iPhone 18 Pro with iOS 27.2 by default. Set OLDFELLA_SIMULATOR_DEVICE and OLDFELLA_SIMULATOR_OS to use another installed simulator. For example:
OLDFELLA_SIMULATOR_DEVICE="iPhone 18 Pro" OLDFELLA_SIMULATOR_OS=27.2 just test
UI tests use predictable service responses. They do not need live Bluesky credentials or network access. Most UI tests start with a signed-in mock account. Sign-in tests start at the sign-in screen.
just test-agent runs the same tests as just test without explicitly opening Device Hub. Apple tooling can still open windows or affect a running simulator.
To run tests on a connected iPhone, set OLDFELLA_TEST_DEVICE_UID to its UID from just devices:
OLDFELLA_TEST_DEVICE_UID=YOUR_DEVICE_UID just test-agent OldFellaTests/NavigationTitleFontTests
Device tests need an unlocked iPhone with Developer Mode enabled. The command uses the iPhone without starting a simulator.
To run one test, pass its identifier to just test or just test-agent. Each command accepts one identifier, not arbitrary xcodebuild arguments.
just test OldFellaUITests/OldFellaUITests/testFeedLoadsNextPageOnlyAfterExplicitTap
For performance measurements, read Scrolling performance.
Apple describes image input for Apple Intelligence in Analyzing images with multimodal prompting.
Build version
A Git tag such as v1.2.3 sets the version of the app and share extension to 1.2.3. A local build uses the nearest release tag in its Git history. If Git finds no release tag, the version is 1.0.0.
just device-release builds from the current checkout. Settings shows the version and the first seven characters of the Git commit. Commit your changes before building if you need the listed commit to describe all the installed code.