Skip to content

Release v1.0.0 - Initial stable release

Choose a tag to compare

View all tags
@mohsin-rafique mohsin-rafique released this 13 Jan 08:45
· 13 commits to master since this release
v1.0.0
cd31844

🎉 Release v1.0.0 - Initial Stable Release

A modern, open-source personal finance management application built with Yii2 and Bootstrap 5.

✨ Highlights

  • 💰 Income Management - Track all income sources with categories
  • 💸 Expense Management - Hierarchical categories & multiple payment methods
  • 📊 Dashboard & Reports - Visual charts and financial insights
  • 👤 User Profiles - Custom avatars, banners, and settings
  • 🎨 Modern UI - Bootstrap 5 with dark/light theme toggle
  • 🔐 Secure - Full authentication system with password reset

📋 Features

Income Management

  • ✅ Record and track all income sources
  • ✅ Categorize income with custom categories
  • ✅ Attach receipts and invoices (PDF, images)
  • ✅ Search and filter functionality
  • ✅ Export to Excel

Expense Management

  • ✅ Track expenses with detailed information
  • ✅ Hierarchical categories (parent/child)
  • ✅ Multiple payment methods (Cash, Card, Bank)
  • ✅ File attachments for receipts
  • ✅ Advanced filtering and search
  • ✅ Export to Excel

Dashboard & Reports

  • ✅ Financial overview dashboard
  • ✅ Income vs Expense summary cards
  • ✅ Monthly/yearly statistics
  • ✅ Category-wise breakdown
  • ✅ Visual charts and graphs
  • ✅ Balance tracking

User Management

  • ✅ Secure authentication system
  • ✅ User profile management
  • ✅ Password reset functionality
  • ✅ Remember me option
  • ✅ Session management

Settings & Customization

  • ✅ Multi-currency support (50+ currencies)
  • ✅ Customizable currency formatting
  • ✅ Date and time format preferences
  • ✅ Company/business branding
  • ✅ Logo and favicon upload
  • ✅ Timezone configuration

Modern UI/UX

  • ✅ Clean, responsive Bootstrap 5 design
  • ✅ Dark/Light theme toggle
  • ✅ Mobile-friendly interface
  • ✅ AJAX-powered interactions (PJAX)
  • ✅ Toast notifications
  • ✅ Modal-based forms

🔧 Requirements

Requirement Version
PHP 8.1 or higher
MySQL / MariaDB 5.7+ / 10.3+
Composer 2.x
Web Server Apache / Nginx

🚀 Quick Start

# Clone the repository
git clone https://github.com/mohsin-rafique/expense-manager.git
cd expense-manager

# Install dependencies
composer install

# Configure database
cp config/db.example.php config/db.php
# Edit config/db.php with your credentials

# Run migrations
php yii migrate

# Set permissions
chmod -R 777 runtime web/assets web/uploads

# (Optional) Seed demo data
php yii seed/demo

Demo Account

After running the seeder:

📸 Screenshots

Click to view screenshots

Dashboard

Dashboard

Income Management

Income

Income Categories

Income Categories

Expense Management

Expenses

Expense Categories (Grid View)

Expense Categories Grid

Expense Categories (Tree View)

Expense Categories Tree

User Profile

Profile

🛠 Technical Stack

  • Framework: Yii2 (v2.0.53)
  • Frontend: Bootstrap 5.3
  • Icons: Bootstrap Icons
  • Charts: ApexCharts
  • Database: MySQL / MariaDB

📋 Roadmap

  • Multi-language support (i18n)
  • Data import from CSV/Excel
  • Advanced reporting with PDF export
  • Budget management module
  • Multi-user/team support
  • API Development (Yii2 REST)
  • Mobile app (React Native)

🙏 Acknowledgments

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Full Changelog: https://github.com/mohsin-rafique/expense-manager/commits/v1.0.0

⭐ Star this repository if you find it useful!

Assets 2
Loading