Stratiles is an iOS widget that turns your Strava activity history into a GitHub-style heatmap. It helps you track training consistency at a glance from your Home Screen.
- Connects to Strava using OAuth (
activity:read_allscope) - Builds calendar heatmaps from your activities
- Supports filtering by activity type (run, ride, swim, hiking, and more)
- Ships a Home Screen widget in multiple sizes
- Includes in-app stats views (weekly miles, pace trend, effort timeline, top activities)
Stratiles/- iOS app target (SwiftUI screens + app shell)StratilesWidget/- WidgetKit extension targetStratilesCore/- shared models, API client, caching, heatmap logicworker/- Cloudflare Worker used as OAuth token exchange proxydocs/- privacy policy and App Store metadata
- SwiftUI + WidgetKit (iOS 17+)
- Shared core module for business/data logic
- Strava API for activity data
- Cloudflare Workers for secure token exchange
- Open
Stratiles.xcodeprojin Xcode. - Select the
Stratilesscheme. - Build and run on an iOS 17+ simulator or device.
- Sign in with Strava from the login screen.
Notes:
- The app reads
STRAVA_CLIENT_IDfromStratiles/Info.plist. - OAuth callback URL is
stratiles://localhost/callback.
The app exchanges Strava auth codes through a Cloudflare Worker.
- Go to the worker folder:
cd worker
- Install dependencies:
bun install
- Set Cloudflare secrets:
wrangler secret put STRAVA_CLIENT_IDwrangler secret put STRAVA_CLIENT_SECRET
- Run locally:
bun run dev
- Deploy:
bun run deploy
If you deploy your own worker URL, update authWorkerBaseURL in StratilesCore/Support/SharedConstants.swift.
Contributions are welcome. For non-trivial changes, open an issue first to align on approach.
- Fork and create a branch for your work.
- Keep changes focused and small where possible.
- Build the app and widget targets before opening a PR.
- Include clear PR notes:
- What changed
- Why it changed
- How you tested it
- Link related issues in the PR description.