Skip to content
gikwegbuPublic

About

A professional, privacy-first mobile application tailored for UK sole traders, freelancers, and limited company directors to easily handle their bookkeeping and Making Tax Digital (MTD) obligations.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TaxBud Banner



A professional, privacy-first mobile application tailored for UK sole traders, freelancers, and limited company directors to easily handle their bookkeeping and Making Tax Digital (MTD) obligations.

Flutter Badge Dart Badge Isar Badge Clean Arch Badge


🚀 Key Features

🛡️ Privacy First (100% Offline)

All your financial and business data is stored strictly locally via Isar Database. Nothing ever touches an external server unless you manually export it. Complete peace of mind and strict GDPR compliance built-in.

📸 Smart Receipt Scanner (Powered by ML Kit)

Simply point your camera at a receipt. TaxBud uses advanced on-device Machine Learning to extract the Total Amount, VAT Amount, Supplier Name, and Date. Say goodbye to manual data entry padding out your evenings!

📊 Automated VAT & Reporting

TaxBud shines when calculating your taxes:

  • Real-time 9-Box MTD Returns: Whether on Flat Rate, Cash Accounting, or Standard, your Returns fill themselves automatically.
  • Profit & Loss: Beautiful graphical visualizations of income vs expenses.
  • Smart Rate Deduction: Auto-extract VAT from Gross automatically, or add VAT to Net transparently.

🚗 Mileage Tracker

Quickly log your business miles with ease. We use the latest HMRC approved rates (45p for the first 10,000 miles, 25p thereafter) automatically, keeping your deductible claims flawless.

📄 Export to PDF

When the tax year closes out, produce beautiful, formatting-preserved PDF export reports directly from the device for your accountant.

🔐 Biometric Security

FaceID / TouchID lock integrated out of the box so your financial data doesn't get exposed if your phone is unlocked.


🎨 Aesthetics & Technical Architecture

We care about performance and a stellar UI. The app utilizes a sleek palette surrounding trustworthy HMRC Green (#00A86B) and crisp Deep Ink Blue (#1B2B4B).

  • Architecture: Meticulous Clean Architecture using Domain, Data, and Presentation layers.
  • State Mapping: Handled via stream-reactive flutter_bloc.
  • DI/IoC: Dependency Injection tightly wired using get_it and injectable.

📱 Screenshots

The app store visuals are located under storeFile/appstore and storeFile/playstore.


🛠️ Build & Installation

  1. Clone the repository:

    git clone <repository_url>
    cd tax_bud
  2. Fetch all dependencies:

    flutter pub get
  3. Generate Isar schemas and DI graphs:

    flutter pub run build_runner build --delete-conflicting-outputs
  4. Launch the application & watch it fly:

    flutter run

🧪 Testing

The codebase maintains a robust test suite covering logic parsing, VAT math rules, entity transformations, and integration workflows.

To run the unit tests:

flutter test test/business_logic_test.dart

To run the widget/smoke tests:

flutter test test/widget_test.dart

💼 Author Information

This project is proprietary and confidential.

George Ikwegbu

About

A professional, privacy-first mobile application tailored for UK sole traders, freelancers, and limited company directors to easily handle their bookkeeping and Making Tax Digital (MTD) obligations.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages