rzen
6a93cedaa6
The Mac App Store requires a globally unique CFBundleName, which follows PRODUCT_NAME — 'Notes' is taken (by Notes). The module name stays 'Notes' via PRODUCT_MODULE_NAME so code and tests are untouched; TEST_HOST is pinned explicitly since xcodegen derives it from the target name.
Contextful
Context-aware note taking for iOS and macOS. Product name Contextful; project working name "Notes", bundle id dev.rzen.indie.Notes.
The idea: every note silently captures the context it was taken in — where you were, what time it was — and that context is used to recall notes later. Walk back into the coffee shop and the note with the barista's name bubbles to the top of the list.
Key features
- Quick text notes — jot something down in two taps; first line doubles as the title
- Automatic context capture — location, place name (reverse-geocoded), time zone, and device are stamped onto every note, best-effort and privacy-friendly (all data stays in your iCloud)
- "Right here, right now" recall — a ranked shelf of notes whose capture context matches your current place and time, above the regular newest-first list
- Tags — manual organization alongside the automatic context; browse notes by tag
- Search — full-text over note text, tags, and captured place names
- iCloud sync — notes live as JSON files in your iCloud Drive (visible in Files.app) and sync across iPhone and Mac; the local database is just a rebuildable cache
- iOS + macOS — same app, same data, both platforms
- Backups — one-tap local backup and restore of all notes (IndieBackup); backup files can be shared and imported across devices
- About screen — version info, changelog, and license in Settings (iOS) and the About window (macOS) via IndieAbout
Planned: voice notes with transcription, richer context signals, smarter ranking.
Architecture
- SwiftUI, iOS 26+ / macOS 26+, Swift 6 strict concurrency, XcodeGen (
xcodegen generate) - Storage per the icloud-sync-engine pattern: iCloud Drive JSON documents are the sole source of truth (via the IndieSync package); a SwiftData cache is populated exclusively by metadata-observer events and can be wiped/rebuilt at any time
- Context capture in
Services/ContextService.swift(CoreLocation + MapKit reverse geocoding); ranking inServices/Relevance.swift
Build
xcodegen generate
xcodebuild build -project Notes.xcodeproj -scheme Notes \
-destination 'platform=iOS Simulator,name=iPhone 17 Pro'
Requires APPLE_TEAM_ID in the environment for code signing.