SatsBuddy

Experimental iPhone companion for SATSCARD.

Download on TestFlight.

What It Does

• Scan and save SATSCARDs over NFC
• View slot details, receive addresses, and balances
• Set up the next slot or sweep funds from the active slot

Dependencies

• bdk-swift
• BitcoinUI
• CodeScanner
• KeychainAccess
• rust-cktap

Running SatsBuddy Locally

Prerequisites

• Xcode (and Xcode Command Line Tools)
• XcodeGen
• Git

You can verify the required tools are installed with:

xcodebuild -version
xcodegen --version
git --version

Install XcodeGen via Homebrew if needed:

brew install xcodegen

Repository Setup

Clone SatsBuddy, generate the Xcode project, and open it:

git clone https://github.com/reez/SatsBuddy.git
cd SatsBuddy
xcodegen generate
open SatsBuddy.xcodeproj

The .xcodeproj is not checked into version control — it is generated from project.yml and the xcconfig files in Configs/. You need to run xcodegen generate after cloning and whenever source files are added or removed.

SatsBuddy resolves CKTap from the remote rust-cktap Swift Package (v0.2.2).

SwiftUI Previews

This project links native and FFI-heavy dependencies (CKTap, BitcoinDevKit). On some Xcode versions, SwiftUI previews may crash in the default execution mode even when the app itself runs normally.

If that happens, open a SwiftUI view file and enable Editor > Canvas > Use Legacy Previews Execution.

About

Made in Nashville.