BTLB

synchronise your library account on your iOS device

Build the App

Initial setup:

Setup

Create the file (Secrets.xcconfig) that contains your secrets.

mv Secrets.sample.xcconfig Secrets.xcconfig

The AI recommender uses an OpenRouter API key This file is ignored by Git to prevent secrets from being committed. Another ignored file is

Classes/Generated/BuildConfig.swift

This file gets generated by a Build Phase Script using input from the Secrets.xcconfig.

Build the paper library

# Navigate to the paper directory and install the Rust toolchain
cd Packages/shared/paper
make prepare-apple

Whenever the Rust paper library is updated:

cd Packages/shared/paper/paper

# then either build the `Paper` Swift Package to use the Rust `paper` library from iOS during development
make apple

# or include release version of `paper` in the `Paper` Swift Package
make apple-release

App Icon

Generate new icon set

bundle exec icongen generate app-icon/appicon-v3-alt-black.pdf Assets.xcassets --type=iphone,ipad

App Store Snapshots

brew install fastlane

fastlane snapshot