Sparely is a personal finance and savings app for Android. Log what you spend, set money aside in savings vaults, keep bills and budgets in check, and decide whether a purchase fits before you make it. Everything stays on your phone: no account, no ads, no cloud.
🤖 Developed with AI: this project was developed with the help of AI coding agents.
- Open the latest release on your phone.
- Under Assets, tap the
.apkfile to download it. - Open it and allow your browser or file manager to install apps when Android asks.
Needs Android 8.0 or newer. Your data lives only on your phone, so export a backup (Settings → Data) before uninstalling.
Screenshots are coming soon.
Spending
- 💸 Fast expense entry: big amount field with a calculator (
12.50+8.99), categories, stores with logos, notes and itemized receipts - 🔔 Purchase detection (optional): when Google Wallet, your bank or card app, or PayPal reports a purchase, Sparely offers to log it with one tap, using the payment method you set for that app
- 🧾 History: search, filters by period, category and store, refunds and per-store totals
- 💳 Payment methods and credit cards: track card balances, limits and statement payments
Saving
- 🏦 Smart vaults: goal-based savings with automatic deposits and progress
- 💰 Savings accounts: interest, deposits and withdrawals
- 🎯 Smart allocation: a share of what you spend or earn goes to your savings automatically
Planning
- 📅 Recurring bills and subscriptions, including bills whose amount changes, which you confirm each time
- 📊 Budgets by category
- 🛍️ "Can I afford it?" and a wishlist: a verdict for a purchase, and a cooling-off period for wishes
- ❤️ Financial health score and insights into your spending patterns
Everywhere
- 🧠 On-device AI (optional, supported phones): plain-language summaries and answers that never leave the phone (details)
- 🗣️ Assistant access (optional, Android 16+): ask Gemini about your spending or to log an expense (details)
- 📱 Home screen widget
- 🔒 App lock with fingerprint or face unlock
- 💾 Backups of absolutely everything, by hand or on a schedule
- 🇨🇦 English and French, with Sparely's own colors or your wallpaper's (Material You)
Sparely has no account and no server. Everything you enter is stored only on your phone. The only optional network use is fetching store logos from Brandfetch, with your own key. Purchase detection reads only the notifications of the apps you pick, on the phone. See PRIVACY.md.
- UI Layer: Jetpack Compose with Material 3
- Database: Room with SQLite for local persistence
- Async Operations: Kotlin Coroutines & Flow
- Dependency Injection: Manual DI via AppContainer pattern
- State Management: ViewModel + StateFlow
- Background Tasks: WorkManager for scheduled operations
- Android Studio (Hedgehog 2023.1.1 or later)
- JDK 11 or higher
- Android SDK (API 26+)
-
Clone the repository
git clone https://github.com/loic-daigle/Sparely.git cd Sparely -
Open in Android Studio
- Open Android Studio
- Select "Open an Existing Project"
- Navigate to the cloned directory
-
Sync Gradle
- Android Studio should automatically sync Gradle
- If not, click "Sync Project with Gradle Files"
-
Run the app
- Connect an Android device or start an emulator (API 26+)
- Click the "Run" button or press
Shift + F10
To enable store logo fetching:
- Get a free API key from brandfetch.com
- In the app: Settings → Brandfetch Client ID
- Enter your API key
| Category | Technology |
|---|---|
| Language | Kotlin |
| UI Framework | Jetpack Compose |
| Database | Room (SQLite) |
| Design System | Material Design 3 |
| Image Loading | Coil |
| JSON Serialization | Gson |
| Background Work | WorkManager |
| Async | Coroutines + Flow |
| Navigation | Navigation Compose |
Export your data:
- Go to Settings
- Tap "Export Data"
- Choose a location to save the JSON file
Import data:
- Go to Settings
- Tap "Import Data"
- Select your backup JSON file
The backup includes all expenses, vaults, budgets, stores, recurring expenses, and settings.
- On-device AI (Gemini Nano): supported phones, setup on the Pixel 9a, code and tests
- AI assistant access (AppFunctions): what assistants can read and do, safeguards, code and tests
- Screenshots: which screenshots the README uses and how to update them
scripts/generate_icons.pyandscripts/generate_banner.py: launcher icons and the README banner
We welcome contributions! Please read our Contributing Guidelines and Code of Conduct before submitting pull requests.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- This is an early release - some features may have bugs
- See Issues for known problems
- Material Symbols icons from Google
- Brandfetch API for store logos
- The Android and Kotlin communities
- AI Coding Assistants for development support
Note: This app is for personal finance tracking and educational purposes. Always consult with financial professionals for important financial decisions.
