Skip to content

GordonBeeming/Scribe

Repository files navigation

Scribe

Build, Test & Deploy PR Verification Swift 6 Platform iOS Platform watchOS License FSL-1.1-MIT XcodeGen CloudKit

A family budget management app for iOS, iPadOS, and watchOS built with SwiftUI and Liquid Glass design.

Features

  • Recurring Budget Items — Track income and expenses with flexible frequencies (weekly, fortnightly, monthly, irregular, etc.)
  • Multi-Currency Support — Handle budgets across different currencies with AUD as default
  • Family Sharing — Share budgets with family members via CloudKit sharing
  • CloudKit Sync — Seamless data sync across devices using CKSyncEngine
  • Widgets — Home screen widgets with configurable budget views
  • watchOS Companion — View budget summaries on Apple Watch
  • Variable Spending — Track discretionary spending with category budgets
  • Amount Overrides — Track amount changes over time for recurring items

Requirements

  • iOS / iPadOS 26.0+
  • watchOS 26.0+
  • Xcode 26.2+
  • Swift 6

Getting Started

This project uses XcodeGen to generate the Xcode project.

# Install XcodeGen (if not already installed)
brew install xcodegen

# Generate the Xcode project
xcodegen generate

# Open in Xcode
open Scribe.xcodeproj

Architecture

  • SwiftUI — Declarative UI with Liquid Glass design language
  • SwiftData — Local persistence
  • CKSyncEngine — CloudKit sync with last-writer-wins conflict resolution
  • WidgetKit — Home screen widgets with AppIntent configuration
  • App Groups — Shared data between app and widget extensions

Project Structure

Target Description
Scribe Main iOS/iPadOS app
ScribeWidgetExtension Home screen widget
ScribeWatch watchOS companion app
ScribeWatchWidgetExtension watchOS widget
ScribeTests Unit tests

License

This project is licensed under the Functional Source License, Version 1.1, MIT Future License.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages