Quick Start Guide¶
Get started with TrueLedger in 5 minutes!
First Launch¶
When you first launch TrueLedger, you'll see the Intro Screen with a brief overview of the app's features.
- Tap GET STARTED or SKIP to go directly to the dashboard.
- Grant notification permissions (optional) to receive reminders for bills and budgets
๐งช Demo Data / Seeding¶
To easily experience TrueLedger with a rich set of populated data, you can instantly inject demo entries (transactions, budgets, loans, investments, and more):
- Navigate to Settings.
- Tap on Seed Data to automatically populate your dashboard. You can clear this anytime by tapping Clear All Data.
Dashboard Overview¶
The Dashboard is your financial command center:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฐ Monthly Summary โ
โ Income: $5,000 | Expenses: $3,200 โ
โ Savings: $1,800 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ Smart Insights (AI) โ
โ "Great job! You're saving 36%..." โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฏ Budgets & Goals โ
โ Groceries: $450 / $500 โ
โ Vacation Fund: $2,000 / $5,000 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Adding Your First Transaction¶
Income¶
- Tap "Add Income" on the dashboard
- Enter:
- Source: e.g., "Salary"
- Amount: e.g., 5000
- Date: Select the date
- Tap Save
Expense¶
- Tap "Add Expense" on the dashboard
- Enter:
- Category: e.g., "Groceries"
- Amount: e.g., 150
- Date: Select the date
- Note (optional): e.g., "Weekly shopping"
- Tags (optional): e.g., "food, essentials"
- Tap Save
Setting Up a Budget¶
- Navigate to Settings โ Budgets
- Tap "Add Budget"
- Enter:
- Category: e.g., "Dining Out"
- Monthly Limit: e.g., 300
- Tap Save
The dashboard will now show your budget progress!
Creating a Saving Goal¶
- Navigate to Settings โ Saving Goals
- Tap "Add Goal"
- Enter:
- Name: e.g., "Emergency Fund"
- Target Amount: e.g., 10000
- Current Amount: e.g., 2000
- Tap Save
Track your progress on the dashboard!
Viewing Analytics¶
Tap the Analysis tab to see:
- Spending Trends: Monthly spending over time
- Category Breakdown: Where your money goes
- Income vs Expenses: Compare earnings and spending
- Budget Performance: How well you're sticking to budgets
AI-Powered Insights¶
The dashboard displays Smart Insights powered by AI:
- ๐ Wealth Projections: Predicts net worth growth based on current savings velocity.
- ๐ก True Cost Analysis: Translates heavy spending categories into "hours of life worked" based on your effective hourly wage.
- โ ๏ธ Overspending & Burn Rate: Detects abnormal spending surges and calculates how many days your liquid assets will last if income stops.
- ๐ง Subscription Leakage: Identifies zombie subscriptions consuming disproportionate amounts of income.
Customization¶
Change Theme¶
- Go to Settings
- Tap Theme
- Choose:
- System Default
- Light Mode
- Dark Mode
Change Currency¶
- Go to Settings
- Tap Currency
- Select your preferred currency symbol
Set Up PIN Lock¶
- Go to Settings
- Tap Security
- Enable PIN Lock
- Set your 4-digit PIN
Backup & Restore¶
Export Data¶
- Go to Settings โ Data Management
- Tap Export Data
- Choose a location to save the JSON file
Import Data¶
- Go to Settings โ Data Management
- Tap Import Data
- Select your backup JSON file
Important
Importing data will replace all existing data. Make sure to export first!
Tips for Success¶
- Track Daily: Add expenses as they happen for accurate insights
- Review Weekly: Check your analytics every week
- Set Realistic Budgets: Start with achievable limits
- Use Tags: Organize expenses with tags for better analysis
- Check AI Insights: Review recommendations regularly
Next Steps¶
- Configuration Guide - Advanced settings
- Features Overview - Detailed feature guides
- Analytics Deep Dive - Master the analysis tools
Need Help?¶
- Check the Troubleshooting Guide
- Visit GitHub Issues
- Read the Architecture Documentation