Welcome to Zeus Finance
Zeus is a modern expense tracking application built with a local-first architecture. Track your wallets, categorize transactions, and manage your finances — all with seamless offline support and automatic synchronization.Why Zeus?
Local-First
Your data lives on your device first. Work offline, sync when connected.
Cross-Platform
Flutter mobile app with Rust backend. iOS and Android support.
Real-time Sync
Automatic background synchronization keeps everything in sync.
Open Source
Fully open source. Self-host the backend or contribute to the project.
Quick Links
Flutter App
Build and run the mobile application
Server API
Deploy and configure the backend
Core Concepts
Understand wallets, categories, and transactions
Architecture Overview
Zeus follows a local-first architecture pattern:Key Features
- Offline-First: Create, read, update, and delete operations work without network
- Automatic Sync: Changes sync automatically when connectivity is restored
- Soft Deletes: Data is preserved until successfully synced, then hard-deleted
- Conflict Resolution: Server IDs track sync state; local UUIDs ensure data integrity
- Type-Safe: Rust backend with Flutter’s type-safe cache layer
Getting Started
Choose your path:Run the Mobile App
Follow the Flutter installation guide to set up your development environment and run the app.
Deploy the Server
Set up the Rust backend with Docker or run locally.
Tech Stack
| Layer | Technology | Purpose |
|---|---|---|
| Mobile | Flutter | Cross-platform UI |
| Mobile Cache | SQLite + sqflite | Local-first storage |
| Backend | Rust + Axum | High-performance API |
| Database | PostgreSQL | Persistent server storage |
| State Management | BLoC pattern | Predictable state |
Contributing
We welcome contributions! Check out our GitHub repository to get started.Zeus is currently in active development. APIs and features may change.