Skip to content
black12-agPublic

About

🧼 Tracker A minimalist business management system for small-scale liquid soap producers.Tracker is a lightweight mobile application built with Flutter and Supabase to solve the core tracking needs of small manufacturing businesses. It focuses on simplicity, fast data entry, and clear financial visibility for the busines

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

45 Commits

Folders and files

Repository files navigation

Tracker Logo

Tracker

A professional Flutter + Supabase business tracker for inventory, sales, purchases, accounts, loans, reports, revenue, and profit.

Download Latest APK

UI Preview

Cross-platform Tracker showcase:

Tracker cross-platform UI showcase

Latest Release

Current tester build: v1.0.0+12

Highlights in this release:

  • multi-tenant workspaces β€” each business owner gets an isolated workspace, staff scoped to it
  • redesigned list pages (sales, purchases, inventory, employees, accounts) β€” clean row layout replacing generic tiles
  • redesigned dashboard β€” weighted financial strip with revenue, profit, and overdue in one glance
  • expanded settings page with profile, security, and account sections
  • admin activity logs page (owner-only) β€” paginated feed of all workspace actions with filter chips
  • new app icon β€” minimalist navy and mint brand mark
  • security hardening β€” workspace-scoped RLS on activity logs, rate limiting, auth session guard

Overview

Tracker is a mobile business app built for real small-business daily operations.

It is designed for:

  • inventory and stock tracking
  • sales and purchase order flows
  • partner and customer management
  • owner and staff access control
  • account balances, transfers, loans, and expenses
  • backend-driven revenue, overdue balances, and profit summaries
  • offline-friendly use with sync when internet comes back

Features

  • Premium animated splash screen
  • Multi-tenant workspaces β€” isolated data per business, owner + staff roles
  • Inventory items with image upload
  • Sales order and purchase order flows
  • Partners, employees, loans, expenses, receive, shipment, and reports
  • Smart customer balance tracking with due dates and reminder status
  • Revenue, account totals, overdue balances, and profit visibility for the owner
  • Admin activity logs page β€” paginated audit trail with event filter chips (owner-only)
  • Owner phone alias login support
  • Offline queue and auto-sync
  • Supabase backend with Auth, Postgres, and Storage with row-level security
  • Local device notifications for overdue balances and pending actions

Download

The latest tester APK is in this repository:

Tech Stack

  • Flutter
  • Riverpod
  • Supabase Auth
  • Supabase Postgres
  • Supabase Storage
  • Shared Preferences
  • Flutter Secure Storage
  • Image Picker
  • Flutter Local Notifications

App Flow

flowchart TD
    A["Cold Open"] --> B["Premium Logo Splash"]
    B --> C["Login"]
    C --> D["Home"]

    D --> E["Sales"]
    D --> F["Purchased"]
    D --> G["Inventory"]
    D --> H["Account"]
    D --> I["Drawer Modules"]

    I --> J["Partners"]
    I --> K["Employees"]
    I --> L["Loan Records"]
    I --> M["Expenses"]
    I --> N["Receive / Shipment"]
    I --> O["Reports"]
    I --> P["Profile / Settings"]
    I --> Q2["Admin Logs (owner only)"]

    E --> Q["Sales Orders + Customer Balances"]
    F --> R["Purchase Orders"]
    G --> S["Items + Images + Stock"]
    H --> T["Cash / Bank Accounts + Transfers"]

    Q --> U["Supabase Postgres"]
    R --> U
    S --> U
    T --> U
    J --> U
    K --> U
    L --> U
    M --> U
    N --> U
    O --> U
    S --> V["Supabase Storage"]
Loading

Project Structure

tracker/
β”œβ”€β”€ app/                # Flutter app
β”œβ”€β”€ apk/                # Downloadable tester APKs
β”œβ”€β”€ scripts/            # Build and verification scripts
β”œβ”€β”€ supabase/           # Database config and migrations
└── ui/                 # Design references

Run Locally

1. Open the Flutter app

cd app
flutter pub get
flutter run

2. Build a release APK

From the workspace root:

python3 scripts/build_versioned_apk.py

This creates a versioned APK inside:

app/build/releases/

3. Install on a device with one script

From the workspace root:

./scripts/install_tracker.sh android

or

./scripts/install_tracker.sh ios-sim

or

./scripts/install_tracker.sh ios-device

What each mode does:

  • android: installs the newest APK in apk/ to a connected Android phone
  • ios-sim: installs the built app to the currently booted iPhone simulator
  • ios-device: opens Xcode workspace and shows the real iPhone install steps

Install on iPhone

To test on an iPhone, use Xcode instead of the Android APK:

  1. Open Runner.xcworkspace in Xcode.
  2. Connect your iPhone to the Mac.
  3. In Xcode, select the Runner target.
  4. Open Signing & Capabilities and choose your Apple Team.
  5. Select your iPhone as the run target.
  6. Press Run.

Important:

  • open the .xcworkspace, not the .xcodeproj
  • if you see a CocoaPods sandbox mismatch, run pod install inside app/ios
  • if the app icon or name looks cached, delete the old app from the phone and install again

The latest verified iPhone simulator build is created from the same codebase in:

app/build/ios/iphonesimulator/Runner.app

Backend

The app is connected to Supabase for:

  • authentication
  • database storage
  • inventory image storage
  • logs and activity data
  • account and report calculations
  • smart customer balance tracking

When the device is online, the app saves to Supabase first. When the device is offline, the app keeps changes locally and syncs them later.

Supabase Keep-Alive (Free Tier)

Free Supabase projects pause after 7 days of inactivity. This repo includes an automated keep-alive system that pings the project every 3 days.

Option A β€” GitHub Actions (recommended)

  1. Go to Settings β†’ Secrets β†’ Actions in your GitHub repo.
  2. Add a secret named SUPABASE_ACCESS_TOKEN with your personal access token.
  3. The workflow at .github/workflows/keep-supabase-alive.yml runs every 3 days automatically.
  4. You can also trigger it manually from the Actions tab.

Option B β€” Local cron

export SUPABASE_ACCESS_TOKEN="sbp_..."
# Add to crontab (runs every 3 days at 08:00):
crontab -e
# Paste: 0 8 */3 * * cd /path/to/tracker && /usr/bin/python3 scripts/wake_supabase.py >> scripts/wake.log 2>&1

Restoring a paused project manually

export SUPABASE_ACCESS_TOKEN="sbp_..."
python3 scripts/wake_supabase.py

If the restore fails with a "maximum limits" error, you need to pause one of your other active free projects first in the Supabase Dashboard.

Notes

  • Owner can access finance, reports, accounts, expenses, loans, and staff management.
  • Staff can access shared operational data without owner-only money controls.
  • Revenue, overdue balances, and profit summaries are backend-driven.
  • Android testers should use the APK in the apk/ folder.
  • iPhone testers should install through Xcode with the workspace above.
  • The repository is kept private for controlled project access.

Suggested GitHub Description

If you want to paste a short repo description on GitHub, use:

Professional Flutter + Supabase business tracker for inventory, sales, accounts, reports, loans, and profit.

Contact

If you want a similar app:

Copyright

Copyright (c) 2026 Munir Kabir. All rights reserved.

See LICENSE for usage restrictions.

About

🧼 Tracker A minimalist business management system for small-scale liquid soap producers.Tracker is a lightweight mobile application built with Flutter and Supabase to solve the core tracking needs of small manufacturing businesses. It focuses on simplicity, fast data entry, and clear financial visibility for the busines

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages