Getting Started

Everything you need to go from a blank slate to a full 12-month forecast — and understand every number on the way.

Contents

  1. What is Cashflow Compass?
  2. Your First 10 Minutes
  3. Accounts
  4. Transactions & Frequencies
  5. The Forecast Grid
  6. Charts
  7. Insight Cards
  8. Excel & JSON Export / Import
  9. Pro Tips

1 What is Cashflow Compass?

Cashflow Compass is a personal budgeting and forecasting tool that answers one question: given what you earn and spend today, what does your financial picture look like over the next 36 months?

Unlike a spreadsheet you maintain manually, the app models every recurring transaction — your bi-weekly paycheck, monthly rent, annual insurance renewal — and projects them forward automatically. You set things up once and the forecast, charts, and insights update in real time.

How it works
All data is stored in your browser's LocalStorage — nothing is sent anywhere. You can export the full state to an Excel workbook or JSON file at any time as a portable backup, and re-import it later to pick up exactly where you left off.

What it's great for

What it doesn't do (yet)

2 Your First 10 Minutes

Follow these five steps and you'll have a working forecast in under 10 minutes.

1

Add at least one account

Go to the Accounts section and add a checking account with its current balance and today's date as the "as of" date. This is the starting point every projection builds from. Add savings, credit cards, or investments if you want the full net worth picture.

2

Add your income first

In Transactions, add your paycheck as an Income transaction. If you're paid bi-weekly, select Bi-weekly — the app will automatically model the two "3-paycheck months" per year. Enter the amount as your net take-home pay after taxes, since everything else is post-tax too.

3

Add your fixed expenses

Rent/mortgage, car payment, phone bill, internet, insurance — these are the same every month (or year). Add them as Expense transactions under the appropriate category. For rent with a known renewal, set an Annual Escalation % to model the increase automatically.

4

Add your variable expenses

Groceries, gas, dining out, entertainment — use your real average monthly spend, not a wishful number. You can always adjust later. These fill in the Variable and Discretionary categories in the forecast grid.

5

Choose your horizon and review

Use the dropdown at the top right to pick End of Year, 12, 18, 24, or 36 months. Scroll down to the forecast grid — red cells flag months where the balance goes negative. Check the Insight cards for your savings rate, biggest spending category, and projected end balance.

Tip — Start with the sample data
If the app is empty, the welcome banner offers a Load sample data button. It sets up two accounts and 13 realistic transactions so you can see the full forecast immediately. Edit or delete any transaction to replace it with your own numbers.

3 Accounts

Accounts serve one purpose: they set the starting balance that the forecast builds from. Every month, the projected net cash flow is added to the running balance, and you can see exactly when and why you might dip into (or out of) savings.

Account typeHow the balance is treated
CheckingStarting balance added to net worth — the primary account for most forecasts
SavingsAdded to net worth — good for modeling an emergency fund or sinking fund
Credit CardSubtracted from net worth (it's a liability) — enter the balance as a positive number
InvestmentAdded to net worth — useful for seeing total picture including a brokerage account
CashAdded to net worth — for cash on hand you want to include

The "As of" date

This tells the app when that balance was accurate. Use today's date if you just checked your account. The forecast counts forward from your transaction start dates, so the as-of date anchors the starting point correctly even if you set things up mid-month.

Note — Multiple accounts
You can add as many accounts as you like. The forecast combines all of them into a single running net balance. If you want to track a savings account separately, add a Transfer transaction from checking to savings each month — it won't count as an expense or income, just a movement between accounts.

4 Transactions & Frequencies

Transactions are the heart of the app. Each one represents a real recurring (or one-time) cash flow — a paycheck, a subscription, a car insurance renewal. The app supports nine frequency types so you can model virtually any real-world payment schedule.

One-time
Hits on a single date. Good for car repairs, a large purchase, a tax payment, or a bonus.
Weekly
Every 7 days from the start date. ~52 occurrences per year.
Bi-weekly ⭐
Every 14 days — exactly 26 paychecks per year. Correctly models the 2 "3-paycheck months" most people don't plan for.
Semi-monthly
Twice a month on the 1st and 15th. 24 occurrences per year. Common for some salaried roles.
Monthly
Same day each month. The most common frequency — rent, utilities, subscriptions, loan payments.
Quarterly
Every 3 months. Good for estimated taxes, quarterly dividends, or HOA fees.
Semi-annual
Twice a year. Some insurance policies and property tax bills land this way.
Annual
Once a year. Car insurance, Amazon Prime, domain renewals, annual memberships.
Custom
Every N days, weeks, or months. For anything that doesn't fit a standard cadence.

Bi-weekly and the 3-paycheck month

Most salaried workers paid bi-weekly notice that two months a year have three pay deposits instead of two. With 26 paychecks spread over 12 months, two months end up with an "extra" paycheck — a significant windfall if you plan for it. Cashflow Compass detects these months automatically and flags them in the Insights panel so you can decide in advance what to do with the extra cash.

Tip — Enter net (take-home) pay
Enter your paycheck amount as what lands in your bank account after all pre-tax deductions (401k, health insurance, federal and state withholding). Since all expenses in the app are post-tax, mixing gross income with post-tax expenses will make the forecast look falsely negative.

Annual escalation %

For transactions that grow over time — rent renewals, cost-of-living raises, utility creep — set an escalation percentage. The amount automatically increases by that % each year from the start date. A 5% escalation on a $900 rent makes it $945 in year 2, $992 in year 3, and so on.

Pause / resume

Use the pause toggle on any transaction to temporarily suspend it without deleting it. This is useful for gym memberships you've cancelled (but plan to restart), freelance income that stopped, or seasonal expenses that are off right now.

Tags and notes

Tags let you group transactions that cut across categories — for example, work-reimbursable, kid, or shared. Notes are free-text reminders attached to a transaction ("Lease renews in August", "Cancel before trial ends").

End date

Set an end date on any transaction to stop it from appearing in the forecast after a certain point. Perfect for a fixed-term loan payoff, a sublease, or a promotional subscription price that expires.

5 The Forecast Grid

The forecast grid is a month-by-month projection table. Rows are your transactions grouped by category kind; columns are the months in your chosen horizon.

Row groupWhat it contains
IncomeAll income transactions — paychecks, side income, rental income
FixedPredictable, recurring expenses. Monthly subscriptions appear first (largest first), then annual ones, then everything else
VariableExpenses that recur but fluctuate — groceries, gas, utilities
DiscretionaryLifestyle spending — dining out, entertainment, travel
SavingsSavings contributions and sinking funds — vacation fund, emergency fund top-up
DebtLoan and credit card payments
TaxEstimated tax payments and tax-related expenses

Summary rows

Below all the transactions, four summary rows appear for every month:

Watch out
A red End-of-Month Balance means your projected balance goes negative — you'd need to dip into savings or credit to cover that month. Look for the transaction causing the spike (often an annual expense) and either plan a buffer or adjust the timing.

Choosing your horizon

The global horizon dropdown in the top-right changes the forecast length for the grid and all charts simultaneously. Options are End of Year (remaining months in the current calendar year), 12, 18, 24, and 36 months. Each chart can also be set to its own independent horizon — see the Charts section.

6 Charts

Six charts visualize your forecast from different angles. Every chart has its own horizon dropdown — you can keep most on the global setting and override one or two for a deeper look without affecting the rest of the page.

📊 Monthly Income vs Expenses

Side-by-side bars for each month's total income and total expenses, with a net cash-flow line overlay. The quickest way to spot months where spending overtakes income.

Look for: bars where expenses exceed income height
📈 Running Balance

Area chart of your projected account balance month by month. Shows the trajectory of your financial position — are you building a cushion or drawing one down?

Look for: dips toward or below zero
🍩 Spend by Category

Doughnut chart breaking down total expenses by category over the horizon. Instantly answers "where is my money going?" in percentage terms.

Look for: categories that surprise you by their share
📉 Category Trend

Stacked area chart showing how each category's spend evolves over time. Useful for seeing the effect of annual escalations and seasonal expenses building up.

Look for: categories growing faster than income
🏆 Top 10 Costs

Horizontal bar chart of the 10 largest individual line items annualized over the horizon. Hover any bar for the exact dollar amount. Good for identifying the highest-leverage cuts.

Look for: items you'd forgotten about or underestimated
💰 Income Sources

Doughnut breakdown of income by category — useful if you have multiple income streams (salary, freelance, rental, dividends) and want to see your income diversification at a glance.

Look for: heavy reliance on a single source
Tip — Per-chart horizons
Set the Running Balance chart to 36 months to see the long arc, while keeping the Income vs Expenses chart on 12 months for month-to-month detail. Each chart remembers its override independently.

7 Insight Cards

The Insights panel auto-generates eight cards from your forecast data. They update instantly when you change transactions or the horizon.

1

Average Savings Rate

The percentage of your total income that isn't consumed by expenses over the horizon. A rate of 20%+ is considered healthy. Below 10% means most income is committed to expenses before it arrives. If this number is negative, expenses exceed income on average.

2

Biggest Category

The single expense category that consumes the largest share of your total spending over the horizon, shown as a percentage. Housing dominating at 40%+ is normal in high-cost areas; if Dining Out is your biggest category, that's a cue worth noticing.

3

Annual Subscription Cost

The annualized total of everything in the Subscriptions category — streaming services, software, memberships. The monthly-equivalent is shown beneath. Subscription creep is real; this card makes the full annual number visible in one place.

4

Emergency Fund Coverage

How many months of expenses your starting balance would cover at the current average burn rate. The conventional target is 3–6 months. Green = 6+ months, blue = 3–6, yellow = 1–3, red = less than 1.

5

Days in the Red

A count of forecast days where the projected balance goes negative, plus the lowest point reached. Zero is the target. If any days appear, find the month in the grid where the balance turns red and look for the spike — usually a large annual expense landing without a buffer.

6

3-Paycheck Months

For bi-weekly income streams, shows which calendar months will have three pay deposits instead of two. This happens twice a year and represents a meaningful windfall — equal to one full extra paycheck. The card flags the specific months so you can plan ahead: extra savings, debt paydown, or a budgeted splurge.

7

What if you cut [Biggest Category] by 20%?

A quick what-if simulation: if you reduced spending in your largest expense category by 20%, how much would you save over the full horizon? This puts a dollar figure on the potential impact of the most high-leverage change you could make.

8

Projected End Balance

Where your running balance lands at the final month of the chosen horizon, plus the delta from your starting balance. Green means you finish ahead; yellow means you end below where you started. This is the single number that summarizes whether your current trajectory is sustainable.

8 Excel & JSON Export / Import

Your data lives in your browser's LocalStorage — it persists between visits on the same browser and device. But LocalStorage can be cleared. Export regularly to keep a portable backup.

Excel (⬇ Excel / ⬆ Excel)

The Excel workbook contains five sheets:

SheetContents
AccountsAll account records — name, type, balance, as-of date
CategoriesAll categories — name, kind, color
TransactionsEvery transaction with all fields — frequency, escalation, tags, notes, paused state
SettingsApp settings — currency, horizon, theme, schema version
ForecastThe rendered projection grid (read-only export reference)
Important — Replace-all import
Importing a file — Excel or JSON — completely replaces everything in your browser with the contents of the file. A confirmation dialog warns you before anything is overwritten. This is intentional: the file is the source of truth. Always export before importing if you want to preserve current data.

To edit amounts in Excel and re-import: export → open the Transactions sheet → change any amount, frequency, or date → save → import the file back. Every change ripples through the forecast and charts immediately.

JSON ({ JSON } / ⇪ JSON)

A lighter alternative to Excel — a single .json file containing all your state. Useful for quickly transferring data between browsers or devices, or sharing a budget template with someone else. Same replace-all import semantics apply.

Tip — Regular backups
Export to Excel at the end of any session where you've made significant changes. Keep the file in a cloud-synced folder (iCloud, Google Drive, Dropbox) and you'll always have a recoverable copy regardless of browser cache clearing.

9 Pro Tips

📅

Plan around 3-paycheck months

When the Insights panel flags a 3-paycheck month, add a one-time transaction in that month — an extra savings deposit, a debt payment, or a planned purchase — so the windfall has a destination before it arrives.

📈

Use escalation on rent and raises

Add an annual escalation % to your rent (5–10% is typical in many markets) and to your paycheck (2–4% COL raise). Over 24–36 months the compounding effect on your forecast becomes very visible.

🔁

Duplicate to create variants

Use the duplicate button on any transaction to quickly create a copy. Useful for modeling a second job, a spouse's income, or a what-if scenario — add it, check the forecast, then delete or pause it.

⏸️

Pause instead of delete

If a subscription is on hold, a project income ended, or a seasonal expense is off, pause the transaction rather than deleting it. It disappears from the forecast but is there to resume with one click when circumstances change.

🏷️

Tag cross-cutting expenses

Use tags like kid, work, or shared on transactions that don't fit neatly into one category. Tags are searchable in the transaction list, making it easy to filter to just the items that matter for a given conversation.

🔚

Set end dates on temporary expenses

Loan payoffs, introductory subscription prices, a sublease — give them an end date so the forecast automatically stops counting them after that point. The impact on your future balance appears immediately.

📊

Use 36-month Running Balance

Set the Running Balance chart to 36 months even if your main horizon is 12. The long-arc view reveals whether your savings are genuinely growing or just holding steady, which the short view can obscure.

💾

Edit in Excel, re-import

If you prefer editing in a spreadsheet, export to Excel, make bulk changes to amounts, dates, or frequencies in the Transactions sheet, and re-import. All changes ripple through the app instantly. It's the fastest way to do a full budget overhaul.

🌙

Dark mode

Toggle dark mode with the moon button in the header. The preference is saved in LocalStorage and remembered across sessions. This guide page respects your current theme too.