Comma — Documentation

Comma is a privacy-first earnings tracker for gig workers. It tracks shifts, mileage, expenses, and taxes — everything stays on your phone unless you choose to back it up.

Built for DoorDash, Uber Eats, SkipTheDishes, Instacart, Amazon Flex, and a dozen more platforms.

Get Comma

• Android — download the latest APK from GitHub Releases. Sideload it by allowing “Install unknown apps” (a Play Store listing is planned).
• Web — open comma-psi.vercel.app in any modern browser and install it as an app. See Web App (PWA).
• Source — Comma is open source on GitHub: raiz-toff/CommaApp (phone app + docs) and raiz-toff/comma (web app).

What makes Comma different

• No account required. No email, no password, no server. Your data lives in a SQLite database on your device.
• GPS mileage tracking. A native background service records your route, separates active delivery miles from dead miles, and calculates your deductible mileage automatically.
• Tax-aware. Country-specific tax rules for the US, Canada, UK, and Nepal. Standard mileage rate or actual expenses — your choice.
• Optional cloud backup. Connect your own Google Drive to encrypt and store a backup. No third-party servers ever see your data.

Guides

Getting started

• Introduction — What Comma is and how it works
• Quick Start — Install, onboard, log your first shift
• Core Concepts — Shifts, platforms, active vs dead miles, and more
• FAQ — Common questions about the web and phone apps
• Troubleshooting — Fix common issues on web and phone

Features

• Shift Tracking — Live GPS shifts and manual log entries
• Mileage Tracking — How the GPS engine works
• Expenses — Log and categorize business expenses
• Tax Center — Self-employment tax estimates
• Goals & Gamification — Weekly goals, XP, badges, streaks
• Vehicles — Manage multiple vehicles and maintenance logs
• Analytics & Reports — Charts, trends, and exportable reports
• Supported Platforms — All gig platforms Comma supports
• Web App (PWA) — Using Comma in the browser

Backup & Sync

• Overview — Local-first philosophy
• Google Drive Backup — Set up and use encrypted backup
• Cloud Sync — Multi-device sync design
• Encryption — How your data is protected

Architecture

• Overview — Tech stack and design principles
• Database — SQLite schema reference
• State Management — Zustand and React Query
• Navigation — Screen and routing structure
• GPS Engine — Native background location service

Development

• Setup — Run the app locally
• Project Structure — Complete file tree
• Environment Variables — .env configuration
• Native Module — The comma-tracker Kotlin/Swift module
• Contributing — Code style, PRs, conventions

License

MIT. Open source, no paywall.