An iPhone app for recording runs and sharing them as photo-backed, pace-colored route cards.
Paceprint draws every Run as a Route colored by Pace: green where you ran faster than your Average pace, red where you slowed down. Turn any Run into a 9:16 Story card over your own photo and share it anywhere.
- Record: live distance, Moving time and Current pace, with the screen locked too. A live map runs on Active run. Pauses never count toward time or Pace.
- Review: Splits per km or mile, a pace chart, a pace-colored Route map and a Place name for every Run.
- Remember: Runs stay on the iPhone (SwiftData). Home shows this week's distance, History shows all-time totals, and both have Route thumbnails.
- Share: Story cards with your photo (filters included) or a dark map, the Route in Pace colors and the headline numbers.
- Apple Health: finished Runs are saved as running workouts with route, distance and active calories. Body weight is read to estimate calories.
- Private by design: no Paceprint servers, no accounts, no ads. Map tiles come from Mapbox, and its telemetry is off unless the user turns it on.
- Xcode 26 or later (Swift 6)
- iOS 18.0 or later (ADR 0002)
- A Mapbox account for a public access token (
pk.…)
-
Clone the repo
git clone https://github.com/yhvn/Paceprint.git cd Paceprint -
Add your Mapbox token. The build stops with an error until you do.
cp Config/Secrets.example.xcconfig Config/Secrets.xcconfig
Set
MAPBOX_ACCESS_TOKENinConfig/Secrets.xcconfigto your public token from https://account.mapbox.com/access-tokens/. Git ignores this file. -
Open and run
open Paceprint.xcodeproj
Choose the
Paceprintscheme and a simulator or device, then run. Swift Package Manager resolvesmapbox-maps-ioson first open.To run on your own device, set your team under Signing & Capabilities. Personal (free) teams work too.
Tip: to simulate a Run in the simulator, use Features → Location → City Run, or load the GPX fixture in
PaceprintTests/Fixtures/from Xcode's Debug → Simulate Location.
Paceprint/ App target: SwiftUI screens, SwiftData models, system adapters
Location/ Location sources: live GPS, GPX replay for tests
Recording/ Run recorder (start / pause / stop)
Health/ HealthKit workout sync
Photos/ Run photos and photo filters
Places/ Place names (CLGeocoder)
Sharing/ Story card rendering and share sheet
Settings/ Units, body weight, preferences
PaceprintCore/ Swift package of pure Run rules (no SwiftUI/SwiftData/CoreLocation/HealthKit)
PaceprintTests/ App-hosted tests
Config/ xcconfig build settings and secrets template
docs/
adr/ Architecture decision records
app-store/ Listing draft and icon sources
design/ Original design prototype
GLOSSARY.md Domain language: Run, Route, Split, Pace, Pause, Story card, …
PaceprintCore holds every rule that can be computed without the system: noise filtering, distance, Pauses → Moving time, Pace, Splits, Pace colors, calories, Place name choice, Route encoding and week/month grouping. The compiler keeps system code out of it, and its tests run on the Mac in seconds (ADR 0003).
# Pure rules: fast, no simulator
cd PaceprintCore && swift test
# App tests: needs a simulator
xcodebuild test -project Paceprint.xcodeproj -scheme Paceprint \
-destination 'platform=iOS Simulator,name=iPhone 17'| ADR | Decision |
|---|---|
| 0001 | SwiftData for Runs, each Route stored as one encoded blob |
| 0002 | iOS 18 minimum, not iOS 17 |
| 0003 | Pure Run rules live in the PaceprintCore package |
| 0004 | The product is named Paceprint, not Paceline |
| 0005 | Mapbox for maps, Apple for place names |
- Use the words in
GLOSSARY.mdin code, UI copy and issues: Run, not workout. Pace, not speed. - Issues live in GitHub Issues and use the triage labels in
docs/agents/triage-labels.md. - Record significant decisions as a new ADR in
docs/adr/.
- Privacy policy: https://yhvn.github.io/paceprint-site/privacy.html
- Support: https://yhvn.github.io/paceprint-site/support.html