Documentation
Everything you need to deploy, configure, and contribute to PiggyBack — your personal finance autopilot for Up Bank.
Quick Start
Features
Up Bank Sync
Auto-import accounts, transactions, categories via webhooks
Couples Partnership
Shared finances with income-weighted expense splitting
Zero-Based Budgeting
Category budgets with real-time spending tracking
Savings Goals
Visual progress linked to Up Bank saver accounts
Recurring Expenses
Auto-detection of subscriptions and bills
Investment Portfolio
Stocks, ETFs, crypto, property with live prices
Watchlist
Track investments you don't own yet
Target Allocations
Portfolio allocation targets with rebalancing recommendations
FIRE Planning
Australian two-bucket calculator with lean/regular/fat/coast variants
AI Assistant
Chat-based insights powered by Google, OpenAI, or Anthropic
Net Worth Tracking
Real-time snapshots with historical charts
Customizable UI
Multiple themes, accent colors, and layout configurations
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, Turbopack) |
| UI | React 19, Tailwind CSS 4, shadcn/ui |
| Database | Supabase (PostgreSQL with Row Level Security) |
| Banking API | Up Bank API |
| Price APIs | Yahoo Finance (stocks/ETFs), CoinGecko (crypto) |
| AI | Vercel AI SDK with multi-provider support |
| Testing | Vitest (722+ tests across 43 test files) |
| Charts | Recharts |
| Animations | Framer Motion |
| Deployment | Vercel |