Bitkit iOS (Native)

Caution

⚠️This is NOT the repository of the live Bitkit app in the app stores! ⚠️Work-in-progress The live Bitkit app repository is here: github.com/synonymdev/bitkit

---

About

This repository contains a new native iOS app which is not ready for production.

How to build

1. Open Bitkit.xcodeproj in XCode
2. Build

Building for E2E tests

To produce an E2E build (uses the local Electrum backend), pass the E2E_BUILD compilation flag:

xcodebuild -workspace Bitkit.xcodeproj/project.xcworkspace \
  -scheme Bitkit \
  -configuration Debug \
  SWIFT_ACTIVE_COMPILATION_CONDITIONS='$(inherited) E2E_BUILD' \
  build

Localization

Localization files are synced from Transifex. Use bitkit-transifex-sync to sync the translations.

This checks for missing translations and validates that all translation keys used in the Swift code exist in the .strings files. (This check is also automated in GitHub Actions)

node scripts/validate-translations.js

Development

Formatting

This project uses SwiftFormat for code formatting. Configuration is in .swiftformat.

Install SwiftFormat:

brew install swiftformat

IDE Extensions:

• VSCode extension
• Xcode extension

Format code:

swiftformat .

Git Hooks

The project includes git hooks to automatically check code formatting before commits.

Set up git hooks:

1. Install git-format-staged: npm install -g git-format-staged
2. Run: ./scripts/setup-hooks.sh

This installs a pre-commit hook that lints Swift files with SwiftFormat.

Xcode Previews

Due to the Rust dependencies in the project, Xcode previews are only compatible with iOS 17 and below.