💰 FinanceFlow

Modern iOS personal finance app with advanced analytics and AI insights

Features • Installation • Architecture • Contributing

---

---

✨ Features

📊 Core Functionality

• Transaction Management - Quick addition of income and expenses with categories
• Multiple Accounts - Manage multiple bank accounts
• Budgets - Set category limits with notifications
• Goals - Track financial goals with progress
• Transaction Calendar - Visualize expenses by day
• Search & Filtering - Powerful transaction search with filters

📈 Analytics & Statistics

• Detailed Statistics - Income/expense charts, categories, trends
• Heatmap - Visualize expenses by day of week and month
• Forecasting - AI-powered expense forecast for next month
• Period Comparison - Compare current and previous periods
• Data Export - CSV, PDF, Excel, tax reports

🤖 AI & Automation

• AI Analytics - Smart insights and financial recommendations
• Auto-categorization - Automatic category detection from description
• Voice Input - Add transactions via voice through Siri
• Recurring Transactions - Automatic creation of regular payments
• Templates - Quick addition of frequently used transactions

🎨 Personalization

• Themes - 5 built-in themes (Ocean, Forest, Sunset, Purple, Midnight) + color customization
• Categories - Create custom categories with icons and colors
• Tags - Flexible tagging system for transaction organization
• Multi-currency - Support for various currencies with real-time conversion
• Localization - Russian and English languages

🔒 Security

• Biometric Protection - Face ID / Touch ID
• PIN Code - Alternative protection method
• Data Encryption - Secure storage of financial information

📱 Integrations

• Home Screen Widget - Balance widget on home screen
• Siri Shortcuts - Manage finances through Siri
• iCloud Sync - Data synchronization via CloudKit
• Bank Import - Import transactions from CSV files
• Receipts - Attach receipt photos to transactions

🎮 Gamification

• Achievements - Achievement system for financial goals
• Progress - Visualize progress for goals and budgets

---

🚀 Installation

Requirements

• iOS 18.0+
• Xcode 15.0+
• Swift 5.0+

Setup

1. Clone the repository

   git clone https://github.com/rafaelwww07-ios/FinanceFlow.git
   cd FinanceFlow

2. Open the project in Xcode

   open FinanceFlow.xcodeproj

3. Configure signing

   • Select the FinanceFlow target
   • Go to Signing & Capabilities
   • Select your development team

4. Configure App Group (for widgets)

   • Add App Group: group.com.financeflow.app
   • Repeat for FinanceFlowWidget and FinanceFlowIntents

5. Run the app

   • Select the FinanceFlow scheme
   • Choose a simulator or device
   • Press Run (▶️) or Cmd + R

Extension Setup

For detailed instructions on setting up Widget Extension and App Intents Extension, see SETUP_INSTRUCTIONS.md

---

🏗️ Architecture

The app is built using MVVM (Model-View-ViewModel) architecture with:

• SwiftUI - Modern UI framework
• Core Data - Local data storage
• CloudKit - iCloud synchronization
• Combine - Reactive programming
• WidgetKit - Home screen widgets
• App Intents - Siri integration

Project Structure

FinanceFlow/
├── FinanceFlow/              # Main application
│   ├── Views/                # SwiftUI views
│   ├── ViewModels/           # ViewModels for MVVM
│   ├── Models/               # Data models
│   ├── Services/             # Business logic and services
│   ├── CoreData/            # Core Data models and controllers
│   └── Helpers/             # Helper utilities
├── FinanceFlowWidget/        # Widget Extension
├── FinanceFlowIntents/       # App Intents Extension
└── README.md

---

🎯 Key Capabilities

Transaction Management

• ✅ Add income and expenses
• ✅ Edit and delete
• ✅ Duplicate transactions
• ✅ Bulk editing
• ✅ Recurring transactions
• ✅ Transaction templates

Analytics

• ✅ Income/expense charts
• ✅ Category pie charts
• ✅ Expense heatmap
• ✅ Expense forecasting
• ✅ Period comparison
• ✅ Export to CSV, PDF, Excel

Budgets & Goals

• ✅ Category budgets (week/month/year)
• ✅ Budget exceeded notifications
• ✅ Financial goals with progress
• ✅ Progress visualization

Integrations

• ✅ Home Screen Widget
• ✅ Siri Shortcuts
• ✅ iCloud Sync
• ✅ CSV Import
• ✅ Voice Input

---

🔧 Configuration

App Group

To enable widgets and Siri Shortcuts, configure App Group:

• ID: group.com.financeflow.app
• Configure in Apple Developer Console

CloudKit

For iCloud synchronization:

• Container: iCloud.com.financeflow.app
• Configure in Apple Developer Console

---

📝 License

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

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

---

📚 Additional Documentation

• SETUP_INSTRUCTIONS.md - Detailed extension setup instructions
• QUICK_SETUP.md - Quick extension setup guide
• README_EXTENSIONS.md - Extensions documentation
• PUBLISHING.md - App Store publishing guide

👨‍💻 Author

Rafael Mukhametov

• GitHub: @rafaelwww07-ios
• Email: rafaelwww07@mail.ru

---

🙏 Acknowledgments

• SwiftUI Charts for data visualization
• WidgetKit for widget creation
• App Intents for Siri integration
• Core Data for local storage

---

📱 App Store

The app is ready for App Store publication. Make sure:

• All necessary permissions are configured
• App Store screenshots are added
• App Group and CloudKit are configured in Developer Console
• All features are tested on real devices

---

Made with ❤️ using SwiftUI

⭐ If you like this project, give it a star!