Skip to content

KlyrhonMiko/koin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

121 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸͺ™ Koin

Sleek. Modern. Personal. Your finances, simplified.

Koin is a sophisticated personal finance tracker built with Flutter, designed to offer a premium and effortless experience for managing your money. With interactive visualizations, multi-account support, and intuitive savings goals, Koin helps you take control of your financial future.


πŸ“₯ Download & Releases

Get the latest version of Koin directly from the GitHub Releases page.

Download APK

Tip

For Android users: Download the koin.apk file, open it on your device, and follow the prompts to install. You may need to enable "Install from Unknown Sources" in your settings.


✨ Key Features

  • πŸ’° Multi-Account Management: Effortlessly track and manage multiple accounts, including cash, bank accounts, and savings.
  • πŸ“Š Dynamic & Interactive Dashboard: Gain insights with beautiful, interactive charts and real-time summaries. Tap income/expense cards for quick transaction entry.
  • ✨ Premium Visual Experience: Enjoy a sophisticated, highly animated splash screen with professional glow and particle effects.
  • πŸ” Smart Financial Analysis: Dedicated analysis view featuring expense breakdowns, category rankings, and flexible time-frame filtering (Week/Month/All Time).
  • πŸš€ Activity-First Approach: The app defaults to the Analysis view, putting your financial health center stage for immediate awareness.
  • 🎯 Savings Tracker: Set, visualize, and achieve your financial goals with a dedicated tracking system.
  • πŸ“‚ Categorized Transactions: Organize your expenses and income with customizable categories for better clarity.
  • 🎨 Personalized Themes: Switch between Dark and Light modes and choose from a set of vibrant accent colors to make the app yours.
  • πŸ”’ Private & Secure: Your data stays on your device using local SQLite storage for maximum privacy.

πŸ› οΈ Tech Stack

πŸ“Έ Preview

Stay tuned for high-resolution screenshots showing off the beautiful UI.

πŸš€ Getting Started

Prerequisites

Installation (Development)

To run the project locally for development, follow these steps:

  1. Clone the repository:

    git clone https://github.com/KlyrhonMiko/koin.git
    cd koin
  2. Install dependencies:

    flutter pub get
  3. Run the application:

    flutter run

πŸ“‚ Project Structure

lib/
β”œβ”€β”€ core/             # Core utilities, themes, and shared providers
β”‚   β”œβ”€β”€ models/       # Shared data models
β”‚   β”œβ”€β”€ providers/    # Global Riverpod providers
β”‚   └── theme.dart    # Central theme configuration
β”œβ”€β”€ features/         # Feature-specific modules
β”‚   β”œβ”€β”€ accounts/     # Account management logic and UI
β”‚   β”œβ”€β”€ activity/     # Activity hub (Analysis & Transactions)
β”‚   β”œβ”€β”€ analysis/     # Financial analysis and charts
β”‚   β”œβ”€β”€ budgets/      # Budgeting and limits
β”‚   β”œβ”€β”€ categories/   # Category management
β”‚   β”œβ”€β”€ dashboard/    # Main overview and interactive cards
β”‚   β”œβ”€β”€ savings/      # Savings goals tracker
β”‚   β”œβ”€β”€ settings/     # App configurations and preferences
β”‚   └── transactions/ # Transaction history and creation
└── main.dart         # Entry point and global configuration

🀝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Built with ❀️ by KlyrhonMiko

About

πŸͺ™ A sleek, modern personal finance tracker built with Flutter, featuring interactive visualizations, multi-account management, and intuitive savings goals.

Topics

Resources

Stars

Watchers

Forks

Contributors