~ knotless Search/
↑↓ move↵ open⇧↵ all results

geesawra.industries/old-fella

Old people's social media app

0
1
main
77 lines · 3.5 KB Raw History
# 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](../ARCHITECTURE.md) for feature boundaries and shared UI components.

Install `just` once with Homebrew:

```sh
brew install just
```

Install the project tools:

```sh
just install-deps
```

The project uses XcodeGen to generate the Xcode project from `project.yml`. The commands below generate the project before they run.

```sh
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:

```sh
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`:

```sh
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.

```sh
just test OldFellaUITests/OldFellaUITests/testFeedLoadsNextPageOnlyAfterExplicitTap
```

For performance measurements, read [Scrolling performance](Scrolling-performance.md).

Apple describes image input for Apple Intelligence in [Analyzing images with multimodal prompting](https://developer.apple.com/documentation/foundationmodels/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.