A professional Flutter + Supabase business tracker for inventory, sales, purchases, accounts, loans, reports, revenue, and profit.
Cross-platform Tracker showcase:
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
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
- 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
The latest tester APK is in this repository:
- Flutter
- Riverpod
- Supabase Auth
- Supabase Postgres
- Supabase Storage
- Shared Preferences
- Flutter Secure Storage
- Image Picker
- Flutter Local Notifications
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"]
tracker/
βββ app/ # Flutter app
βββ apk/ # Downloadable tester APKs
βββ scripts/ # Build and verification scripts
βββ supabase/ # Database config and migrations
βββ ui/ # Design references
cd app
flutter pub get
flutter runFrom the workspace root:
python3 scripts/build_versioned_apk.pyThis creates a versioned APK inside:
app/build/releases/
From the workspace root:
./scripts/install_tracker.sh androidor
./scripts/install_tracker.sh ios-simor
./scripts/install_tracker.sh ios-deviceWhat each mode does:
android: installs the newest APK inapk/to a connected Android phoneios-sim: installs the built app to the currently booted iPhone simulatorios-device: opens Xcode workspace and shows the real iPhone install steps
To test on an iPhone, use Xcode instead of the Android APK:
- Open Runner.xcworkspace in Xcode.
- Connect your iPhone to the Mac.
- In Xcode, select the
Runnertarget. - Open
Signing & Capabilitiesand choose your Apple Team. - Select your iPhone as the run target.
- Press
Run.
Important:
- open the
.xcworkspace, not the.xcodeproj - if you see a CocoaPods sandbox mismatch, run
pod installinsideapp/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
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.
Free Supabase projects pause after 7 days of inactivity. This repo includes an automated keep-alive system that pings the project every 3 days.
- Go to Settings β Secrets β Actions in your GitHub repo.
- Add a secret named
SUPABASE_ACCESS_TOKENwith your personal access token. - The workflow at
.github/workflows/keep-supabase-alive.ymlruns every 3 days automatically. - You can also trigger it manually from the Actions tab.
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>&1export SUPABASE_ACCESS_TOKEN="sbp_..."
python3 scripts/wake_supabase.pyIf the restore fails with a "maximum limits" error, you need to pause one of your other active free projects first in the Supabase Dashboard.
Ownercan access finance, reports, accounts, expenses, loans, and staff management.Staffcan 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.
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.
If you want a similar app:
- Telegram: @muay011
- Phone:
0907806267 - GitHub: black12-ag
Copyright (c) 2026 Munir Kabir. All rights reserved.
See LICENSE for usage restrictions.