Finally is a free, open-source iOS task manager that connects to your Notion workspace. It syncs tasks from your Notion databases, supports Todoist-style inline creation, per-task reminders, recurring tasks, widgets, and dark mode.
Branch: main is the public integration branch — fork it, branch off it, and open PRs against it.
- Notion OAuth — connect any workspace where you're a member
- Two-way sync with your Tasks and Projects databases
- Inbox, Today, Upcoming, Kanban, and project browse views
- Inline task creation with chip-based fields (due date, target date, priority, tags, project, recurrence)
- Per-task local push reminders (anchored or exact-date)
- Home screen widget
- iOS 17+ with SwiftUI and SwiftData
See specs/001-notion-task-app/spec.md for the full product spec.
| Path | Description |
|---|---|
Finally/ |
iOS app (SwiftUI + SwiftData) |
FinallyWidget/ |
Home screen widget extension |
FinallyTests/ |
Unit, integration, and E2E tests |
vercel-notion-auth/ |
Serverless OAuth relay (HTTPS callback + token exchange) |
specs/001-notion-task-app/ |
Feature specs and task checklist |
PRIVACY.md |
Privacy policy |
TERMS.md |
Terms of use |
Requires macOS with Xcode 15+.
git clone https://github.com/kaungzinye/finally.git
cd finally
# Compile check (no simulator needed)
xcodebuild build -project Finally.xcodeproj -scheme Finally \
-destination 'generic/platform=iOS' CODE_SIGNING_ALLOWED=NO -quiet
# Unit test compile check
xcodebuild build-for-testing -project Finally.xcodeproj -scheme FinallyTests \
-destination 'generic/platform=iOS' CODE_SIGNING_ALLOWED=NO -quietFull setup (Notion integration, database schema, OAuth): specs/001-notion-task-app/quickstart.md.
If you change project.yml, regenerate the Xcode project:
xcodegen generatecd vercel-notion-auth
npm install
vercel dev # local dev at http://localhost:3000Deploy and env var setup: vercel-notion-auth/DEPLOY.md.
All contributions target main. See CONTRIBUTING.md.
- Bug reports — bug report template
- Feature ideas — feature request template
- Security issues — SECURITY.md (do not open public issues)
MIT — see LICENSE.