BXS Financial — Feature Specification

Dashboard
Additions
Spec

Six new tracking areas to add to BXS Financial. Each is the direct output of a curriculum module. If it's not in the dashboard, it won't stick. This spec defines what each field tracks, how to calculate it, how often to update it, and how it should display.

Build First
Business Runway + Cash Flow Forecast — operational, immediate utility even before finishing the curriculum
Build Second
FX Conversion Log + Tax Provision Tracker — needed before your next invoice to an international client or provisional tax deadline
Build Third
Net Worth Tracker + Savings Rate — longer-horizon, but foundational once the operational fields are live
01
Module 1 Output
Total Assets
Number · ZAR
Update: Monthly
Sum of everything you own that has monetary value. Entered manually or pulled from linked accounts.
Line items to include: FNB transactional account balance, FNB savings balance, any investment account values (EasyEquities, RA), any receivables currently outstanding (money owed to you by clients), estimated equipment value (laptop, gear). Do not include speculative values — use current realisable values.
→ Module 1.1
Total Liabilities
Number · ZAR
Update: Monthly
Sum of everything you owe: any outstanding debt, credit card balances, loans.
Convert any USD-denominated debt to ZAR at the current spot rate for consistency. If you have no debt currently, this stays at zero — still include the field so the structure is there when it's relevant.
→ Module 1.1
Net Worth
Calculated
Auto: Assets − Liabilities
The number. Calculated automatically from the two inputs above. Display this prominently — it's the primary wealth metric.
Display as a large IBM Plex Mono stat with month-over-month delta. A green delta means the number grew. A red delta means it shrank. No smoothing — show the real number. Log each monthly snapshot to build a historical series you can chart over time.
→ Module 1.1
Net Worth History
Log · Monthly
Appended: Monthly
A timestamped record of net worth each month. Becomes a line chart over time — the most useful single view of financial progress.
Store: date (month/year), assets total, liabilities total, net worth. Do not overwrite — append. After 6 months you'll have a trend. After 12 months it becomes genuinely informative.
→ Module 1.1
Display Spec — How Net Worth Should Look in the Dashboard
Net Worth
R248k
↑ R12,400 this month
Updated April 2026
Assets
R312k
Liabilities
R64k
12-Month Trend
May 2025 → Apr 2026
02
Module 3 Output
Expected Income (Month)
Number · ZAR
Update: Monthly (start of month)
What you expect to receive this month — from confirmed invoices, retainer payments, and any other expected income. Not what you hope to receive. Confirmed only.
Separate from what you've already received. This field is for income you've invoiced or contracted but not yet collected. Convert any foreign currency amounts to ZAR using the current rate at time of entry and note the rate used.
→ Module 3.1
Fixed Outflows (Month)
Number · ZAR
Update: Once (then auto)
Your predictable monthly expenses: rent, insurance, subscriptions, phone, utilities. These rarely change — set them once and update only when something changes.
This is your floor. The number that goes out regardless of income. Should be broken down by category in the input, displayed as a single total on the main view.
→ Module 2.1
Variable Outflows (Month)
Number · ZAR
Update: Weekly
Everything that varies: groceries, dining, transport, professional expenses, client-related costs. The category that budgeting actually controls.
Pull this from your FNB transaction history if you can. Otherwise enter a weekly estimate every Monday as part of the review rhythm. Over 3 months this becomes a reliable average you can use for forecasting.
→ Module 2.1
Monthly Net Position
Calculated
Auto: Income − Outflows
Expected income minus expected total outflows. Positive means you have surplus. Negative means you're drawing down your buffer.
Display prominently in green or red based on sign. This is the number that triggers action: if it's negative two months in a row, something needs to change — either expenses or you need to invoice faster.
→ Module 3.1
90-Day Forecast View
Calculated · 3 months
Auto-projected
Project the current month's figures forward 90 days using confirmed future income (retainer clients) and your fixed outflows baseline. The 90-day view surfaces problems before they become crises.
For months 2 and 3 of the forecast, if no income is confirmed, default to your 3-month income average. Flag any month where projected net position is negative in orange. Flag any month where the buffer would drop below 1 month of fixed costs in red.
→ Module 3.1
03
Module 4 Output
Total Income Received (Month)
Number · ZAR
Update: Monthly
Total cash actually received in the month — both personal and business combined, converted to ZAR. Not invoiced. Received.
If you pay yourself a fixed owner's salary from the business, use only that salary amount for the personal savings rate calculation. The business's cash is not your income until you take it out.
→ Module 4.1
Amount Saved (Month)
Number · ZAR
Update: Monthly
How much moved into savings or investments this month. Includes FNB savings account transfers, TFSA contributions, RA contributions, any investment purchases.
Track this separately from the emergency fund build vs ongoing savings. Once the emergency fund is complete, this number should represent deliberate wealth-building moves only.
→ Module 4.1
Savings Rate %
Calculated · %
Auto: Saved ÷ Income
Amount saved divided by total income received. Express as a percentage. This is the KPI. Target: 20% minimum. Above 30% is excellent for a variable-income founder.
Display as a large percentage stat with a 3-month rolling average below it. The rolling average smooths out months where a big invoice distorts the number. Display a progress bar toward the 20% target.
→ Module 4.1
Emergency Fund Status
Number · Months
Update: Monthly
Current liquid savings balance divided by monthly fixed costs. Shows how many months you could run without income. Target: 3 months minimum, 6 months ideal.
Display as "X.X months" not as a ZAR amount. The months figure is more visceral and actionable than the rand amount. Once you hit 6 months, stop growing this — redirect to investment.
→ Module 4.1
Display Spec — Savings Rate Section
Savings Rate
23%
3mo avg: 19%
0%Target: 20%
Emergency Fund
4.2
months runway
0Target: 6mo
Saved This Month
R7.2k
of R31k income
04
Module 6 Output
FX Entry
Log Entry
Update: Per transaction
One row per international payment received or converted. The log is your SARS evidence and your conversion performance record.
Required fields per entry: Date received, Client name, Invoice number, Source currency (USD / EUR / NGN / other), Source amount, Conversion platform (Wise / SWIFT / FNB Forex), Rate applied (rand per unit of foreign currency), ZAR equivalent received, Fee paid (if trackable), SARB-compliant? (checkbox). Optional: notes field for anything unusual.
→ Module 6.1
Total Foreign Income YTD
Calculated
Auto-sum from log
Running total of all foreign-currency income converted to ZAR, for the current tax year. Feeds directly into your provisional tax estimate.
SA tax year runs March to February. The YTD counter should reset on 1 March each year. Show breakdown by currency: USD total, EUR total, NGN total, other. Each should show both source-currency total and ZAR equivalent.
→ Module 6.1
Average Rate (Period)
Calculated · per currency
Auto-calc from log
The weighted average exchange rate you received for each currency over the period. Compare against the SARB daily rate to see whether your conversion timing and platform choices are competitive.
Calculate as: total ZAR received ÷ total foreign currency converted. A lower rate than the market average means you're losing money on conversion — either on fees, unfavourable timing, or a poor platform.
→ Module 6.1
Display Spec — FX Log Table (sample rows)
Date Client CCY Foreign Amt Rate ZAR Equiv Platform Fee
02 Apr 2026 Hosi Technologies ZAR R45,000 FNB Direct
15 Mar 2026 Global Client A USD $2,500 18.42 R46,050 Wise R84
01 Mar 2026 Nigerian Client B USD $1,200 18.38 R22,056 Payoneer R310
05
Module 5 Output
Taxable Income YTD
Calculated
Auto from income fields
Total income received since 1 March (tax year start), minus allowable deductions entered to date. This is your current taxable income estimate.
Gross income minus: home office deduction (if applicable), RA contributions made, legitimate business expenses. Do not subtract anything you haven't formally documented — SARS requires evidence for every deduction.
→ Module 5.1
Deductions Logged
Log · Running
Update: Per deductible expense
A running log of allowable business deductions. Every deduction logged here reduces your taxable income estimate and your provisional tax liability.
Fields per deduction: Date, Category (home office / software / professional development / travel / client entertainment / other), Amount, Receipt reference, Notes. Category totals feed the taxable income calculation. This doubles as your SARS audit trail.
→ Module 5.1
Estimated Tax Liability
Calculated
Auto: updated monthly
Estimated provisional tax owed based on current taxable income, projected forward to year end, applying the SARS tax table. This is an estimate — not what you owe until your accountant confirms it.
Calculation approach: annualise your YTD taxable income (YTD income ÷ months elapsed × 12), apply SARS marginal rate brackets for individuals, subtract primary rebate (R17,235 for 2026 tax year), divide by 2 for each provisional payment. Display clearly as an estimate, not a final figure. Link to your accountant's last confirmed amount for comparison.
→ Module 5.1
Tax Provision Balance
Number · ZAR
Update: Monthly (manual top-up)
How much you've set aside specifically for tax. Should grow monthly. Compare against estimated liability — the gap is what you still need to provision.
Rule of thumb for provisioning: set aside 25–30% of every payment received into a dedicated savings bucket labelled "Tax Provision." Do not touch this money. It is not yours — it belongs to SARS. If you can open a separate FNB savings account named "Tax," do that.
→ Module 5.1
Next Provisional Deadline
Date
Static · 2 dates per year
SA provisional tax deadlines: 31 August (first payment) and 28 February (second payment). Display countdown to next deadline prominently.
Display as days remaining. When less than 60 days out, change to orange. When less than 30 days, red. Include a note field for "accountant engaged Y/N" so you can track whether you've started the process early enough.
→ Module 5.1
06
Module 3 Output
Business Account Balance
Number · ZAR
Update: Weekly
Current balance in your BXS business account. Updated weekly as part of the review rhythm. Not your personal account — business only.
Do not net out outstanding receivables. Use only the actual cash you have now. Money owed to you is not the same as money in the account — especially if your clients have a history of paying late.
→ Module 3.1
Monthly Business Burn
Number · ZAR
Update: Monthly
Your total monthly business costs — subscriptions, tools, your own owner's salary, any other fixed business outflows. The number that drains the account each month.
Should include: your owner's salary (what you pay yourself), Claude API costs, any software subscriptions for BXS tools, phone and internet if business-only, professional memberships. Do not include your personal living costs — those are on the personal side.
→ Module 3.1
Runway (Months)
Calculated
Auto: Balance ÷ Burn
How many months BXS can operate at current burn with zero new income. The most important number for a solo consultancy. Should always be above 2. Target: 3+.
Display as a large IBM Plex Mono stat. Colour states: green if 3+ months, orange if 1–3 months, red if under 1 month. A red state means stop everything and focus on generating income. Display prominently — this number should never be a surprise.
→ Module 3.1
Outstanding Receivables
Log
Update: Per invoice issued
Money owed to BXS but not yet received. Listed by client, invoice number, amount, and days since due. This is your aged debtors register.
Fields per entry: Client, Invoice number, Invoice date, Due date, Amount (ZAR), Days overdue (auto-calculated from today vs due date). Flag anything overdue in orange, anything 30+ days overdue in red. This log drives your follow-up behaviour — no more forgetting to chase invoices.
→ Module 2.2
Display Spec — Runway Section (dark card treatment)
Business Health
Runway
3.8
months · above target
Account Balance
R76k
business account
Monthly Burn
R20k
inc. owner salary
Receivables
R85k
2 invoices outstanding
Overdue
R32k
1 invoice · 14 days
Next Tax Deadline
134
days · 31 Aug 2026
15 min
Weekly Monday Check
  • Update business account balance
  • Log any FX payments received
  • Check receivables — any overdue?
  • Log variable outflows for the week
  • Note any new income confirmed
30 min
Monthly 1st Review
  • Update net worth (assets + liabilities)
  • Log total income received
  • Log amount saved / invested
  • Update tax provision balance
  • Update cash flow forecast for new month
  • Review savings rate vs target
60 min
Quarterly Deep Review
  • Review net worth trend (chart view)
  • Reconcile FX log against bank statements
  • Review deductions log — anything missing?
  • Send deductions summary to accountant
  • Adjust 90-day forecast
  • Review progress against curriculum goals
Summary Reference

All Fields at a Glance

Field Section Type Update Freq Curriculum Module
Business RunwayBusiness RunwayCalculatedWeeklyModule 3.1
Monthly Net PositionCash FlowCalculatedMonthlyModule 3.1
FX Conversion LogFX LogLogPer transactionModule 6.1
Estimated Tax LiabilityTax ProvisionCalculatedMonthlyModule 5.1
Tax Provision BalanceTax ProvisionManualMonthlyModule 5.1
Outstanding ReceivablesBusiness RunwayLogPer invoiceModule 2.2
Net WorthNet WorthCalculatedMonthlyModule 1.1
Savings Rate %Savings RateCalculatedMonthlyModule 4.1
Emergency Fund StatusSavings RateCalculatedMonthlyModule 4.1
Deductions LogTax ProvisionLogPer expenseModule 5.1
Next Provisional DeadlineTax ProvisionStatic + CalcAnnual setupModule 5.1
90-Day ForecastCash FlowCalculatedMonthlyModule 3.1