FinTrack

FinTrack is a UIKit iOS app for recording income and expenses, monitoring a running balance, and organising transactions by category.

Project status: Complete as a learning project and currently paused. The repository remains buildable and documented, but no active feature development is planned.

Transaction data is held in memory for the current app session and is not persisted between launches.

Features

• Record income and expense transactions
• Track the current balance and latest transaction date
• Categorise transactions with built-in or custom categories
• Review and clear the in-session transaction log
• Choose a language and currency preference in the settings interface

Screenshots

Requirements

• macOS with Xcode 26 or later
• iOS 26 or later

Run Locally

1. Clone the repository:

   git clone https://github.com/ihormelashchenko/FinTrack.git
   cd FinTrack

2. Open FinTrack/FinTrack.xcodeproj in Xcode.

3. Select the FinTrack scheme and an iPhone simulator or connected device.

4. Build and run the app.

The project has no third-party dependencies.

Verify the Project

xcodebuild \
  -project FinTrack/FinTrack.xcodeproj \
  -scheme FinTrack \
  -configuration Debug \
  -destination 'generic/platform=iOS Simulator' \
  CODE_SIGNING_ALLOWED=NO \
  build

GitHub Actions runs the same build for pushes to main and for pull requests.

Project structure

FinTrack/
├── FinTrack.xcodeproj/
└── FinTrack/
    ├── Assets.xcassets/
    ├── Base.lproj/
    ├── Settings/
    ├── Transaction/
    └── ViewControllers/

There is currently no automated test target; verification is performed by compiling the shared FinTrack scheme.

Author

Created by Ihor Melashchenko.