💸ExpenseTracker

An iOS expense tracker that scans fiscal receipts, verifies them via FNS, automatically categorizes purchases and visualizes spending

📦 Technologies

Swift SwiftUI AVFoundation Python FastAPI SQLite DistilBERT Xcode XCTest

---

🦄 Features

• Manual income and expense tracking
• QR scanning for fiscal receipts
• Receipt verification through the FNS API
• Automatic product normalization and categorization
• Filters and sorting by date, amount and category
• Spending charts by category and period
• Local storage with backend synchronization
• User authentication and profile editing

---

🎯 How to use

1. Create an account or sign in
2. Add an income or expense manually
3. Scan a fiscal receipt QR code with the camera
4. Review and edit the recognized receipt items
5. Filter transactions and explore spending charts
6. Open the profile screen to update account details

---

📚 What I Learned

During this project I practiced building a full-stack iOS application that connects receipt scanning, financial data and a Python backend

• 📱 SwiftUI application:

  • Architecture: Separated views, view models, services and data models
  • State management: Kept transaction lists, filters and profile data in sync across screens

• 🧾 Receipt processing:

  • QR scanning: Built a camera scanner with AVFoundation
  • FNS integration: Sent fiscal receipt data to the backend and handled verification responses

• 🧠 Automatic categorization:

  • Normalization: Cleaned receipt item names before classification
  • Categories: Mapped recognized products to expense categories and subcategories

• 📊 Expense analytics:

  • Filtering: Added sorting and category filters for transaction history
  • Charts: Visualized income and expenses by category and period

• 🔗 Client-server communication:

  • FastAPI: Built authentication, receipt and transaction endpoints
  • Synchronization: Connected local JSON storage with the backend API

---

🚦 Running the Project

Backend

1. Open the backend directory
2. Copy .env.example to .env and add your FNS credentials
3. Run ./start.sh
4. The API will be available at http://localhost:8000

iOS app

1. Open ExpenseTracker.xcodeproj in Xcode
2. Wait for Swift packages to resolve
3. Start the backend
4. Select a simulator or device and press Run (⌘R)

---

📁 Project structure

ExpenseTracker/
├── ExpenseTracker/
│   ├── Core/                      # App shell, models, auth and profile
│   ├── Components/                # Reusable SwiftUI components
│   ├── ReceiptScanner/            # QR scanning and receipt confirmation
│   ├── Services/                  # Network, FNS and API services
│   ├── ViewModels/                # Transaction list and form logic
│   ├── Views/                     # Expenses, filters and charts
│   └── Assets.xcassets/
├── backend/
│   ├── api/                       # FNS client
│   ├── models/                    # Category mappings and model config
│   ├── services/                  # QR processing and categorization
│   ├── database.py                # SQLite data layer
│   └── main.py                    # FastAPI application
├── ExpenseTrackerTests/
├── ExpenseTrackerUITests/
└── ExpenseTracker.xcodeproj/

---

🎞️ Preview