A cross-platform personal finance management application built with .NET MAUI and C#. Track expenses, monitor spending habits, and maintain budget control across Android, iOS, macOS, and Windows platforms.
- Features
- Screenshots
- Tech Stack
- Getting Started
- Project Structure
- Key Learnings
- Future Enhancements
- Contact
- Secure signup and login system
- Password management and account settings
- User session management
- Log expenses and income with categorization
- Transaction categories include:
- Housing and Utilities
- Food and Drinks
- Travel
- Income
- Other Expenses
- Date-based transaction tracking
- Complete transaction history view
- Dashboard: Real-time overview of financial activity
- Line chart visualization of income vs. expenses
- Recent transaction feed
- Monthly spending summary
- Overview Page: Visual spending analysis
- Donut chart breakdown by category
- Top spending category identification
- Color-coded category legend
- Budget Management: Set and track monthly spending caps
- Interactive charts using Microcharts library
- Line charts for trend analysis
- Donut charts for category distribution
- Real-time data updates
- Clean, modern landing page with branding
- Intuitive login and signup flows
- At-a-glance financial summary
- Visual expense tracking
- Quick access to recent transactions
- Comprehensive transaction history
- Easy expense logging interface
- Detailed spending breakdowns
Framework & Language:
- .NET 8.0
- C#
- .NET MAUI (Multi-platform App UI)
Database:
- SQLite with SQLite-net-pcl
- Asynchronous database operations
Data Visualization:
- Microcharts.Maui
- SkiaSharp for custom graphics
Platforms:
- Android (API 21+)
- iOS (11.0+)
- macOS Catalyst (13.1+)
- Windows (10.0.17763.0+)
Key Dependencies:
- Microsoft.Maui.Controls (8.0.21)
- sqlite-net-pcl (1.9.172)
- Microcharts.Maui (1.0.0)
- SkiaSharp.Views.Maui.Controls (3.0.0)- Visual Studio 2022 (v17.8+) with .NET MAUI workload
- .NET 8.0 SDK
- For mobile development:
- Android SDK (for Android deployment)
- Xcode (for iOS/macOS deployment)
-
Clone the repository
git clone https://github.com/yourusername/otus-finance.git cd otus-finance -
Restore NuGet packages
dotnet restore
-
Build the solution
dotnet build
-
Run the application
- Open
OtusFinance.slnin Visual Studio - Select your target platform (Android, iOS, Windows, etc.)
- Press F5 or click the Run button
- Open
- Launch the application
- Click "Signup" on the landing page
- Create an account with username and password
- Log in with your credentials
- Set your monthly spending cap in Settings
- Start logging transactions!
OtusFinance/
โโโ Database/
โ โโโ LocalDB.cs # SQLite database operations
โโโ Models/
โ โโโ User.cs # User data model
โ โโโ Transactions.cs # Transaction data model
โโโ Pages/
โ โโโ LandingPage.xaml/.cs # Entry point
โ โโโ LoginPage.xaml/.cs # Authentication
โ โโโ SignupPage.xaml/.cs # User registration
โ โโโ DashboardPage.xaml/.cs # Main dashboard
โ โโโ AccountReport.xaml/.cs # Transaction logging
โ โโโ OverviewPage.xaml/.cs # Spending analytics
โ โโโ AccountSettings.xaml/.cs # User settings
โโโ Resources/
โ โโโ Images/ # App images and icons
โ โโโ Styles/ # XAML styling resources
โ โโโ Fonts/ # Custom fonts
โโโ Platforms/ # Platform-specific code
Cross-Platform Development:
- Built a single codebase that runs on 4+ platforms
- Implemented platform-specific features and optimizations
- Managed responsive UI across different screen sizes
Database Management:
- Designed normalized database schema
- Implemented async/await patterns for data operations
- Created CRUD operations with proper error handling
- Managed data persistence across sessions
UI/UX Design:
- Created an intuitive, modern interface using XAML
- Implemented navigation flows with Shell architecture
- Designed consistent visual language across pages
- Added data visualization components
State Management:
- Managed application state with static UserData class
- Implemented data binding with MVVM concepts
- Handled lifecycle events and page navigation
Problem-Solving:
- Debugged database connection issues
- Optimized chart rendering performance
- Implemented input validation and error handling
- Export transactions to CSV/PDF
- Budget alerts and notifications
- Recurring transaction support
- Multi-currency support
- Biometric authentication
- Cloud sync across devices
- Receipt photo attachments
- Advanced filtering and search
- Spending predictions using ML
- Dark mode refinements
- Implement MVVM architecture with CommunityToolkit.Mvvm
- Add unit and integration tests
- Implement data encryption
- Add localization support
- Optimize database queries with indexing
- Implement data backup/restore
This project is open source and available under the MIT License.
- OTUS branding and logo design
- Microcharts library for visualization components
- .NET MAUI community for documentation and support
Built with ๐ using .NET MAUI
