Features Overview

Comprehensive guide to all features in Thrust.

Core Features

💰 Accounts

Manage all your financial accounts in one place. Account Types:

Cash - Physical money, wallets
Bank Account - Checking, savings accounts
Credit Card - Credit cards with limits
Debt - Loans, mortgages
Savings - Deposits, savings accounts
Investments - Brokerage accounts
Real Estate - Property, land

Features:

Multi-currency support (150+ currencies)
Balance tracking and history
Account transfers
Balance adjustments
Archive/restore accounts
Custom icons and colors

Implementation:

Model: Models/Account.swift
Views: Features/Accounts/
Manager: Managers/AccountManager.swift

📝 Transactions

Track all your income and expenses. Transaction Types:

Expense - Money spent
Income - Money received
Transfer - Between accounts

Features:

Quick add with smart parsing
Categories and subcategories
Tags for organization
Attachments (receipts, photos)
Location tracking
Split transactions
Recurring transactions
Bulk operations
Search and filters

Smart Features:

AI-powered categorization
Natural language input
Voice input
Duplicate detection
Auto-categorization rules

Implementation:

Model: Models/Transaction.swift
Views: Features/Transactions/
Editor: Features/Transactions/UniversalTransactionEditor.swift
Search: Services/Search/TransactionSearchService.swift

📊 Budgets

Control your spending with flexible budgets. Budget Types:

Category Budget - Limit for specific category
Multi-Category Budget - Combined limit
Account Budget - Spending limit per account
Total Budget - Overall spending limit

Features:

Monthly, weekly, or custom periods
Rollover unused amounts
Budget alerts and notifications
Progress tracking
Historical comparison
Budget suggestions based on spending

Advanced:

Envelope budgeting
Zero-based budgeting
50/30/20 rule templates
Custom budget periods
Family budget sharing

Implementation:

Model: Models/Budget.swift
Views: Modules/Budget/
Engine: Engines/BudgetEngine.swift

🎯 Goals

Save for what matters with smart goals. Goal Types:

Savings Goal - Save specific amount
Debt Payoff - Pay off debt
Investment Goal - Reach investment target

Features:

Target amount and deadline
Manual contributions
Automatic savings rules
Progress tracking
Milestone celebrations
Goal templates

Automation:

Round-up savings
Percentage of income
Fixed amount per period
Leftover budget savings
Smart savings suggestions

Implementation:

Model: Models/Goal.swift
Views: Goals/
Engine: Engines/SavingsAutomationEngine.swift
Manager: Goals/GoalManager.swift

🤖 AI CFO

Your personal AI financial advisor. Capabilities:

Natural language queries
Transaction parsing from text
Financial insights
Spending analysis
Budget recommendations
Goal suggestions
Bill reminders

Examples:

"Add $50 for coffee at Starbucks"
"How much did I spend on food this month?"
"Can I afford a $500 purchase?"
"Show my spending trends"
"Create a budget for groceries"

Features:

Voice input support
Context-aware responses
Rich text formatting
Interactive charts
Action buttons
Conversation history

Privacy:

100% on-device processing
No data sent to servers
Uses Apple’s Core ML
Conversation history encrypted

Implementation:

Service: FoundationModels/LeapCFOService.swift (70KB!)
View: FoundationModels/CFOChatView.swift
Actions: FoundationModels/CFOActions/
Parser: FoundationModels/IntelligentInputParser.swift

Analytics & Reports

📈 Dashboard

Your financial overview at a glance. Widgets:

Total balance
Net worth
Safe to spend
Monthly spending
Budget progress
Upcoming bills
Recent transactions
Action cards (Health-style)

Customization:

Reorder widgets
Show/hide sections
Custom date ranges
Account filters

Implementation:

View: Features/Dashboard/DashboardView.swift
ViewModel: Features/Dashboard/DashboardViewModel.swift
Charts: Features/Dashboard/BalanceChart/

📊 Reports

Detailed financial analysis. Report Types: Net Worth Report:

Assets vs liabilities
Historical trends
Asset allocation
Growth rate

Cash Flow Report:

Income vs expenses
Monthly comparison
Category breakdown
Trends and patterns

Spending Report:

Category analysis
Merchant analysis
Time-based trends
Comparison periods

Income Report:

Income sources
Growth trends
Regularity analysis

Custom Reports:

Date range selection
Account filters
Category filters
Export to PDF/CSV

Implementation:

Views: Features/Reports/
Engines: Engines/AnalyticsEngine.swift
Export: Services/ExportService.swift

📉 Trends

Visualize your financial data. Charts:

Balance over time
Spending by category
Income vs expenses
Budget performance
Net worth growth
Category trends

Features:

Interactive charts
Zoom and pan
Multiple time periods
Comparison mode
Export charts

Implementation:

Components: Components/Charts/
View: Features/Reports/FinancialTrendsView.swift

Investments

📈 Stocks

Track your stock portfolio. Features:

Add holdings manually
Real-time price updates
P&L calculations
Portfolio analytics
Stock news
Financial data
Dividend tracking

Data Sources:

Yahoo Finance API
Real-time quotes
Historical data
Company information

Implementation:

Views: Features/Investments/Stocks/
Service: Features/Investments/Stocks/StocksAPIService.swift
Model: Models/StockHolding.swift

🪙 Cryptocurrency

Monitor your crypto portfolio. Supported Blockchains:

Ethereum (ERC-20 tokens)
Binance Smart Chain (BEP-20)
Polygon (MATIC)
Solana (SPL tokens)
Bitcoin
TON
TRON (TRC-20)
Cosmos
Polkadot

Features:

Wallet address tracking
Automatic balance updates
Token detection
NFT support
Price tracking
P&L calculations
Portfolio analytics

Data Sources:

Moralis API (EVM chains)
Native blockchain APIs
CoinGecko (prices)

Implementation:

Views: Features/Investments/Crypto/
Services: Features/Investments/Crypto/Services/
Manager: Features/Investments/Crypto/CryptoWalletManager.swift
Model: Models/CryptoWallet.swift

Privacy & Security

🔒 Privacy Modes

Ghost Mode:

All data on-device only
No cloud sync
No network requests
Maximum privacy
Default mode

Connected Mode:

Optional iCloud sync
Bank integration (EU)
Real-time prices
AI categorization
User choice

Implementation:

Manager: Managers/PrivacyManager.swift
Settings: Features/Settings/Security/

🔐 Security

Authentication:

Face ID / Touch ID
Passcode fallback
Auto-lock
Privacy curtain

Data Protection:

Encrypted storage
Secure enclave
Keychain for sensitive data
No third-party tracking

Backup:

iCloud backup (optional)
Local export
Encrypted backups
Easy restore

Implementation:

Manager: Managers/SecurityManager.swift
Views: Features/Settings/Security/

Automation

🔄 Recurring Transactions

Automate regular payments. Features:

Custom schedules
Auto-create transactions
Skip/modify instances
End date support
Notification reminders

Schedules:

Daily, weekly, monthly, yearly
Custom intervals
Specific days
Business days only

Implementation:

Model: Models/RecurringPayment.swift
Manager: Managers/RecurringPaymentManager.swift

🎯 Automation Rules

Smart transaction automation. Rule Types:

Auto-categorization
Auto-tagging
Auto-budgeting
Auto-savings

Conditions:

Description contains
Amount range
Merchant
Account
Date/time

Actions:

Set category
Add tags
Assign to budget
Transfer to savings
Send notification

Implementation:

Model: Models/AutomationRule.swift
Engine: Engines/AutomationEngine.swift

Customization

🎨 Appearance

Themes:

Light mode
Dark mode
Auto (system)
Custom accent colors

App Icons:

Multiple icon options
Tinted icons
Dark mode icons
Custom icons

Tab Bar:

Reorder tabs
Show/hide tabs
Custom labels
Icon customization

Implementation:

Settings: Features/Settings/Appearance/
Design: Design/AppColors.swift

🌍 Localization

Supported Languages:

English
Russian
German
French
Spanish
Italian
Portuguese
Dutch
Swedish
Polish
Ukrainian
Belarusian

Features:

Full UI translation
Number formatting
Date formatting
Currency formatting
RTL support (planned)

Implementation:

Strings: *.lproj/Localizable.strings
Script: Scripts/audit_localizations.py

Widgets & Extensions

📱 Home Screen Widgets

Widget Types:

Balance widget
Budget widget
Goal widget
Quick add widget
Recent transactions

Sizes:

Small
Medium
Large
Extra large (iPad)

Implementation:

Extension: ThrustLiveActivity/Widgets/

🔴 Live Activities

Dynamic Island:

Privacy mode indicator
Quick balance view
Transaction notifications

Lock Screen:

Balance display
Budget progress
Goal progress

Implementation:

Extension: ThrustLiveActivity/
Manager: ThrustLiveActivity/LiveActivityManager.swift

Gamification

🏆 Achievements

Earn achievements for financial milestones. Categories:

First steps
Consistency
Savings
Budgeting
Goals
Investments

Examples:

“First Transaction” - Add your first transaction
“Budget Master” - Stay under budget for 3 months
“Savings Streak” - Save for 30 days straight
“Goal Achiever” - Complete your first goal

Implementation:

Manager: Managers/Gamification/AchievementManager.swift
Model: Models/Achievement.swift

⭐ XP & Levels

Level up by using the app. XP Sources:

Add transactions
Create budgets
Achieve goals
Daily login
Complete achievements

Levels:

1-100 levels
Unlock features
Earn badges
Leaderboards (optional)

Implementation:

Manager: Managers/Gamification/GamificationManager.swift

Family Features

Share finances with family members. Features:

Invite family members
Shared accounts
Shared budgets
Permission levels
Activity feed

Roles:

Admin - Full access
Member - Add transactions, view reports
Viewer - Read-only access

Implementation:

Views: Features/Settings/Family/
Manager: Managers/FamilyManager.swift

Advanced Features

🔍 Search

Powerful search across all data. Search Types:

Transactions
Accounts
Categories
Tags
Merchants

Filters:

Date range
Amount range
Account
Category
Tags
Type

Implementation:

Service: Services/Search/TransactionSearchService.swift
View: Features/Search/SearchView.swift

📤 Export

Export your data in multiple formats. Formats:

CSV
PDF
JSON
QIF (Quicken)
OFX

Export Options:

All data
Date range
Specific accounts
Specific categories

Implementation:

Service: Services/ExportService.swift
Views: Features/Settings/DataManagement/

🔔 Notifications

Stay informed about your finances. Notification Types:

Budget alerts
Bill reminders
Goal milestones
Large transactions
Low balance warnings
Recurring payment due

Customization:

Enable/disable per type
Custom thresholds
Quiet hours
Notification sounds

Implementation:

Manager: Managers/NotificationManager.swift

Technical Features

💾 Data Management

Storage:

SwiftData for persistence
CloudKit for sync (optional)
Keychain for secrets
UserDefaults for settings

Backup:

Automatic iCloud backup
Manual export
Import from backup
Data migration

Performance:

Lazy loading
Pagination
Caching
Background processing

Implementation:

Schema: Core/DataSchema.swift
Container: Core/AppModelContainer.swift
Manager: Managers/CloudKitManager.swift

🔌 Integrations

Bank Integration:

GoCardless (EU only)
PSD2 compliant
Read-only access
Auto-sync transactions

Price APIs:

Yahoo Finance (stocks)
CoinGecko (crypto)
Currency exchange rates

Blockchain APIs:

Moralis (EVM chains)
Native APIs (Bitcoin, Solana, etc.)

Implementation:

Service: Modules/Finance/GoCardlessBankService.swift
Services: Features/Investments/*/Services/

Next Steps

Architecture

Understand the app architecture

Project Structure

Navigate the codebase

API Reference

Detailed API documentation

Contributing

Contribute to Thrust

Getting started

Architecture

Integrations

​Features Overview

​Core Features

​💰 Accounts

​📝 Transactions

​📊 Budgets

​🎯 Goals

​🤖 AI CFO

​Analytics & Reports

​📈 Dashboard

​📊 Reports

​📉 Trends

​Investments

​📈 Stocks

​🪙 Cryptocurrency

​Privacy & Security

​🔒 Privacy Modes

​🔐 Security

​Automation

​🔄 Recurring Transactions

​🎯 Automation Rules

​Customization

​🎨 Appearance

​🌍 Localization

​Widgets & Extensions

​📱 Home Screen Widgets

​🔴 Live Activities

​Gamification

​🏆 Achievements

​⭐ XP & Levels

​Family Features

​👨‍👩‍👧‍👦 Family Sharing

​Advanced Features

​🔍 Search

​📤 Export

​🔔 Notifications

​Technical Features

​💾 Data Management

​🔌 Integrations

​Next Steps

Architecture

Project Structure

API Reference

Contributing

Features Overview

Core Features

💰 Accounts

📝 Transactions

📊 Budgets

🎯 Goals

🤖 AI CFO

Analytics & Reports

📈 Dashboard

📊 Reports

📉 Trends

Investments

📈 Stocks

🪙 Cryptocurrency

Privacy & Security

🔒 Privacy Modes

🔐 Security

Automation

🔄 Recurring Transactions

🎯 Automation Rules

Customization

🎨 Appearance

🌍 Localization

Widgets & Extensions

📱 Home Screen Widgets

🔴 Live Activities

Gamification

🏆 Achievements

⭐ XP & Levels

Family Features

👨‍👩‍👧‍👦 Family Sharing

Advanced Features

🔍 Search

📤 Export

🔔 Notifications

Technical Features

💾 Data Management

🔌 Integrations

Next Steps