Skip to content

About

This project is a financial app that tracks user spending and allows them to set monthly cap based on the money they receive and spend every month. It also shows the user an overview of their spending habits.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

ย 

History

54 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

OTUS Finance ๐Ÿฆ‰

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.

OTUS Finance Logo

๐Ÿ“‹ Table of Contents

โœจ Features

User Authentication

  • Secure signup and login system
  • Password management and account settings
  • User session management

Transaction 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

Financial Insights

  • 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

Data Visualization

  • Interactive charts using Microcharts library
  • Line charts for trend analysis
  • Donut charts for category distribution
  • Real-time data updates

๐Ÿ“ธ Screenshots

Screenshot 2024-05-06 201820 Screenshot 2024-05-06 201840 Screenshot 2024-05-06 201935 Screenshot 2024-05-06 205913 Screenshot 2024-05-06 202226 Screenshot 2024-05-06 202246

Landing & Authentication

  • Clean, modern landing page with branding
  • Intuitive login and signup flows

Dashboard

  • At-a-glance financial summary
  • Visual expense tracking
  • Quick access to recent transactions

Reports & Analytics

  • Comprehensive transaction history
  • Easy expense logging interface
  • Detailed spending breakdowns

๐Ÿ›  Tech Stack

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)

๐Ÿš€ Getting Started

Prerequisites

  • 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)

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/otus-finance.git
    cd otus-finance
  2. Restore NuGet packages

    dotnet restore
  3. Build the solution

    dotnet build
  4. Run the application

    • Open OtusFinance.sln in Visual Studio
    • Select your target platform (Android, iOS, Windows, etc.)
    • Press F5 or click the Run button

First-Time Setup

  1. Launch the application
  2. Click "Signup" on the landing page
  3. Create an account with username and password
  4. Log in with your credentials
  5. Set your monthly spending cap in Settings
  6. Start logging transactions!

๐Ÿ“ Project Structure

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

๐ŸŽ“ Key Learnings

Technical Skills Demonstrated

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

๐Ÿ”ฎ Future Enhancements

Planned Features

  • 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

Technical Improvements

  • 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

๐Ÿ“„ License

This project is open source and available under the MIT License.

๐Ÿ™ Acknowledgments

  • OTUS branding and logo design
  • Microcharts library for visualization components
  • .NET MAUI community for documentation and support

Built with ๐Ÿ’š using .NET MAUI

About

This project is a financial app that tracks user spending and allows them to set monthly cap based on the money they receive and spend every month. It also shows the user an overview of their spending habits.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages