User Guide

Complete documentation for retireclarity retirement planning calculator.

Getting Started

retireclarity is a comprehensive retirement planning calculator that helps you model your financial future. It runs entirely in your browser with no data sent to any server.

Quick Start

  1. Enter your basic information on the Calculator page: current age, retirement age, and life expectancy.
  2. Add your account balances: cash, brokerage, tax-deferred (401k/IRA), and Roth accounts.
  3. Enter your income sources: salary, Social Security, pensions, and other income.
  4. Set your expected expenses: both flexible and fixed.
  5. Review the projections showing your year-by-year financial outlook.

Recommended Workflow

  1. Start with the Calculator to model your baseline plan
  2. Check Progress to track your actual net worth over time as you update balances
  3. Use the Roth Conversion Planner to find tax-efficient Roth conversion strategies
  4. Run Chance of Success to stress-test your plan against historical market conditions

Calculator Inputs

Understanding each input helps you create an accurate retirement model.

Personal Information

Current Age
Your age today. The projection starts from this year.
Retirement Age
When you retire — an age, or (once your date of birth is entered) the exact month. Retiring mid-year splits that year: you keep working — and drawing a paycheck — through the month before, then the retirement profile (spending, withdrawals, ACA→Medicare) takes over for the rest, each prorated to its share of the year (retire in March → 2/12 working, 10/12 retired). A whole-year or age-only retirement is treated as fully retired from January. A salary anchored to retirement automatically stops the month you retire — its end shows "last working months." Stream end ages are inclusive: "55 through 59" still pays in the year you turn 59. If you're already retired, set this to your current age. Plan rows label each year with the age you turn that year (the IRS convention); the "Age:" shown under Date of Birth is your age today.
Life Expectancy
The age to project through. A common approach is to use age 95 to ensure you don't outlive your money. The projection will show all years from your current age through this age.
Filing Status
Your tax filing status affects tax brackets, standard deduction, and Social Security taxation thresholds. Options: Single, Married Filing Jointly, Married Filing Separately, Head of Household. Selecting "Married Filing Jointly" enables couple mode with additional spouse inputs.
Couple Mode (Married Filing Jointly)
When filing jointly, you can add your spouse's information including their birth date, life expectancy, Social Security, pension, other income, and tax-deferred balance. Key couple-mode features:
  • Separate RMD timing: Each spouse's tax-deferred balance has its own RMD schedule based on their birth year
  • Combined income: Both spouses' income is included in household MAGI for IRMAA, ACA subsidies, and SS taxation
  • Extended projection: Runs through the longer of both spouses' life expectancies
  • Survivor handling: After a spouse passes their life expectancy, their income and their owned expenses stop, and filing status changes. Household expenses continue at 100% for the survivor — there is no blanket survivor discount. To model costs that end with one person (a car lease, their travel), give that expense stream an Owner
Staggered Retirement Dates
Each person has their own retirement date in the Household section. Onboarding seeds the spouse's to retire alongside you — a starting value, not a link, so moving yours afterwards leaves theirs where it is, and you can set theirs to any date you like. (Plans made before that seeding leave it blank and simply retire them with you.) Modeling (expenses, withdrawals, taxes, healthcare) begins at the household's first retirement. While one spouse still works:
  • Paycheck covering expenses: If the working spouse's paycheck covers part of your spending, add it as an income stream in Income & Expenses (e.g., tax-free "Paycheck" from first retirement until their retirement) — it shows up in every chart. Plans that used the old coverage % were converted to exactly such a stream automatically
  • Employer health coverage: The Household card shows one row per person who still has working years — “[name]'s employer plan covers: Nobody / Just them / Both of you” — so each of you sets your own. A covered person under 65 pays no marketplace premium, but only while the plan's owner is still working: it ends the month they retire, not at 65. Medicare still starts at 65 regardless. The quiet line beneath the rows reads the result back (“employer → ACA 2032–2036 → Medicare from Jun 2036”) so you can see the handover the projection actually uses — including the split year, since Medicare starts on your 65th birth MONTH and you buy marketplace coverage for the months before it
  • Salaries: Wages live as Salary income streams (Income & Expenses → Treat as: Salary, one per person). They fill tax brackets, Social Security taxation, and ACA/IRMAA MAGI in every working year — pre-retirement years included — so Roth conversion headroom and subsidies stay honest. By default a salary's tax is assumed withheld from the paycheck and the pay itself isn't added to your savings — until you enter working-years spending, which switches on the full cash-flow model (see Working Years below). Previously entered wage amounts were converted to salary streams automatically
  • Works both ways: either of you can carry a salary stream past the other's retirement, and the employer-coverage fields follow whoever still works — a working spouse's plan or a working primary's plan can cover one or both of you
State
Your state of residence for state income tax calculations. All 50 states plus DC are supported, including states with no income tax and those with special retirement income exemptions.

Accounts

Add each account by name — 401(k), 403(b), Traditional IRA, Roth IRA/401(k), brokerage, crypto, checking, savings, CD, money market. Behind the scenes each account rolls up into one of four tax buckets that drive the projection:

Cash (checking, savings, CD, money market)
Drawn first when expenses exceed income. Defaults to the Cash return in Investment Assumptions.
Taxable (brokerage, crypto)
Growth is taxed as capital gains. Enter each account's cost basis (what you paid); withdrawals above basis trigger capital gains tax.
Tax-Deferred (401k/403b/Traditional IRA)
Pre-tax accounts: withdrawals are ordinary income and Required Minimum Distributions apply from age 73 or 75 (SECURE Act 2.0). In couple mode, set the Owner on each retirement account — spouse-owned accounts start RMDs on the spouse's schedule.
Roth (Roth IRA/401k)
Tax-free growth and withdrawals; no RMDs during the owner's lifetime.
Ownership
Retirement accounts are individually owned (You or Spouse); taxable and cash accounts can also be Joint. Ownership beyond the RMD split is recorded for future modeling and doesn't change today's projections.
Return override
Each account can override its bucket's expected return (a 4.5% high-yield savings account, a speculative crypto sleeve). The projection grows the bucket at the balance-weighted blend. Overrides apply to the fixed projection only — Monte Carlo uses historical market sequences for everything.

Income Sources

Social Security
Your expected monthly Social Security benefit at your claiming age (62-70). Enter the amount shown on your Social Security statement. The calculator handles the taxation (0%, 50%, or 85% taxable based on combined income).
Pension & Other Income
Pensions, rental income, part-time work, and other regular income are modeled as income streams in the Income & Expenses section: add an income stream and set "Treat as" to Pension or Recurring income in the editor panel (recurring amounts can be entered per month or per year). Streams offset your spending needs each year, count toward Social Security taxation and Medicare surcharges, and — for pensions — get state pension tax treatment where applicable. Choose "For life" as the end for lifetime income; in couple mode, set the Owner so the income stops at the right person's death. Expenses can carry an Owner too (a spouse's car lease ends at their death; Household expenses continue for the survivor). For spouse-owned items, ages are entered as the spouse's own age — "from 60" means when they are 60.

Income & Expenses

All money in and out lives here: your living expenses, recurring flows like part-time work, rental income, a mortgage, or a travel phase, and one-off events like an inheritance, a home sale, or a major purchase. A stream can run for a single year or between two ages (or milestones, including "Plan end" — the last year of the projection).

Templates
The Add button opens a template gallery: part-time work, consulting until Medicare, a mortgage with a movable "paid off" milestone, travel years, vehicle replacement (net of trade-in, every 7 years), a §121 home downsize, long-term care for each person's final years, family gifts, big home repairs, a boat/RV bundle, and a spending phases bundle — the "retirement smile" (Blanchett): extra go-go spending early that tapers with age, sized from your own spending level and flexible in bad markets. Every template is an ordinary stream you can tune after creation, or start blank.
Living Expenses
Everyday spending is just expense streams — add as much detail as you like (housing, groceries, insurance, subscriptions, property tax) or keep a couple of broad items. A typical living-expense stream is Household-owned, inflation-adjusted, and runs from First retirement until Plan end; amounts can be entered per month or per year. Costs that start or stop at an age (a mortgage until payoff, travel years) are the same thing with different timing.
Categories
Give expenses a category (Housing, Utilities, Food, Transport, Healthcare, Insurance, Travel & Leisure, Other) to keep the Income & Spending chart readable: categorized expenses group into one flow per category, and clicking a category on the chart drills into its individual streams. A category is suggested automatically from the name as you type. Display only — projections are unaffected.
Owners & Survivors
In couple mode, an expense can belong to one person or the Household. An owned expense stops at that person's death; Household expenses continue at 100% for the survivor — there is no blanket survivor discount. Model the spending that would end with each spouse (their car, their hobbies) as owned streams to see realistic survivor scenarios.
Flexible vs Fixed
Mark an expense as Flexible if you could cut it back in tough times (travel, dining out, hobbies). Everything else is treated as fixed — maintained regardless of market conditions. There is no separate flexibility switch: if anything is marked Flexible, simulations can flex it; if nothing is, spending stays fixed.
Spending Flexibility (Guyton-Klinger)
In Monte Carlo simulations (and severe deterministic drawdowns), expense streams marked Flexible can be reduced by up to a maximum percentage when a trigger fires (portfolio below its peak threshold, a bad market year, or both). The trigger, the thresholds, and the maximum cut are tuned in Settings, and those settings drive the projections directly. A prosperity rule can also increase flexible spending when the portfolio is thriving. The portfolio trigger watches total household wealth, including a spouse's retirement accounts.
Repeat Every N Years
Recurring expenses can fire every Nth year instead of annually — a car replacement every 7 years, a new roof every 20, a big trip every other year. Set "Every" next to the Repeats checkbox; each occurrence is inflated to its own year if inflation-adjusted.
Income
Income streams like part-time work, rental income, an inheritance, or an asset sale. For each stream, you specify the amount, when it occurs (an age, a milestone, or a specific date — see Timing below — for a single occurrence, or a start and end for recurring streams), the tax treatment (ordinary, tax-free, capital gains, or home sale), and where to deposit the funds (Cash or Brokerage account).
Tax Treatment
Tax-free: Use for stepped-up basis inheritances, Roth distributions, or gifts. The amount is deposited without affecting your taxable income.
Ordinary: Use for ordinary income like bonuses, deferred compensation payouts, or sales without favorable tax treatment. This income is added to your federal and state tax base for that year.
Cap gains: Use for selling an appreciated asset (stock, investment property, a business). Enter the sale proceeds as the amount and what you originally paid as the basis; the gain (proceeds minus basis) is taxed at long-term capital gains rates in the sale year.
Home sale (§121): Like Cap gains, but for selling your primary residence. Up to $250,000 of gain (single) or $500,000 (married filing jointly) is excluded from tax under IRC §121; only gain above the exclusion is taxed at capital gains rates. The exclusion amounts are fixed by law (not inflation-indexed), and a surviving spouse who sells after switching to single filing gets the $250,000 exclusion. Qualifying requires having owned and lived in the home for 2 of the last 5 years — the calculator assumes you qualify.
Expenses
Expense streams like a mortgage until payoff or a multi-year travel phase, and one-off costs like a car purchase, home repair, or medical bill. The expense is withdrawn from your accounts in the standard depletion order: Cash first, then Brokerage, then Tax-Deferred, then Roth.
Amounts & Inflation
Enter amounts in today's dollars. By default the exact amount you enter is applied in the year(s) it occurs. Recurring streams have a +Inflation toggle: when on, the amount grows with your inflation assumption each year to maintain purchasing power; when off, it stays fixed in nominal dollars (right for a fixed mortgage payment, but a fixed amount buys less each year).
Milestones
Named markers like "Mortgage paid off" that appear as vertical lines on your projection charts. They do double duty: they show how your plan lines up with the moments that matter to you, and any income or expense can be anchored to one (see below) — move the milestone and everything anchored to it moves with it. A custom milestone's timing is a month or a year — typing one works exactly like the timing field described below, and the age you'd be then is echoed beside it. Click a milestone row to edit it in the side panel, just like income and expenses.
Timing: Milestones, Dates & Include/Exclude
Every timing field — income and expense start/end, a milestone, a real asset sale — uses the same combobox. Click it and an empty search shows your available milestones first (your or your spouse's retirement, the household's first retirement, Medicare at 65, Social Security claiming, RMD start, either life expectancy, plus your own custom milestones), then a couple of quick relative picks ("2 years after <milestone>") — "More…" expands the full relative range. Pick a milestone and the field tracks it automatically: change your retirement age and everything anchored to "You retire" follows, with no re-entry. Recurring streams can anchor their start and end to different milestones (e.g., health premiums "from first retirement until Medicare"). Delete a milestone something is anchored to and the field keeps its last resolved age with a warning pointing it out.

Typing a digit instead switches the list to specific months — type a year ("2032"), a month name ("nov"), or both ("nov 2032") — each row echoes the age you'd be at that point ("Nov 2032 · 59y4m") so you can sanity-check it against a birthday. The projection runs in whole calendar years but honors the month you pick: the date lands in its own calendar year, and a flow that starts or ends mid-year is prorated for that year — a salary ending in June counts for half the year, a pension starting in September for a third (4 of 12 months).

On an END timing field anchored to a milestone, an Include / Exclude toggle appears: Include ends the stream in the milestone's own year (through it); Exclude ends the year before — the convention retirement-linked ends use by default, since the retirement year itself is fully retired (see Retirement Age above). Picking a fresh milestone defaults to Include so the resolved line under the field always matches what you typed; flip it any time.

Real Assets

Value Outside the Portfolio
Your home or rental property is tracked by value and appreciation rate (blank = tracks inflation). The value appears on the Accounts chart as a "Real assets" band — the stack top is your net worth — but the projection can't spend it: it stays outside the withdrawal order until you sell.
Linked Cash Flows
Mortgage, property tax, insurance, and rent income live underneath the asset as ordinary streams (quick-add buttons pre-fill them). They behave exactly like other Income & Expenses streams — they're just organized under the property they belong to.
Rental Operating Costs (Schedule E)
Costs linked to a rental — property tax, insurance, maintenance, HOA — deduct against its rent income for taxes (the cash still leaves). A mortgage deducts only its interest: set the "Tax-deductible portion" on the mortgage stream (an estimate like 60% is fine; the quick-add pre-fills it). Deductions are capped at each year's rent — net rental income never goes below zero. Costs on your own home never deduct (there's no Schedule E for a primary residence).
Rental Depreciation
For rentals, enter the year you started renting and an estimated land value: the building (cost basis minus land) depreciates straight-line over 27.5 years, a non-cash deduction that shrinks the taxes on your rent — the cash itself still flows. The deduction is capped at each year's rent income (no passive-loss carryforward) and, when you sell, the accumulated depreciation is recaptured as ordinary income (≈ the §1250 rules; exact for tax brackets up to 24%) with the remaining appreciation taxed as capital gains.
Selling
Check "Sell this asset" and pick an age, milestone, or specific date. Selling costs (default 6%) come off the top — reducing both the proceeds and the taxable gain. The remaining appreciated value becomes sale proceeds deposited to Brokerage, taxed as a home sale (§121 exclusion — $250k single / $500k married —) or as capital gains against your cost basis. Linked recurring streams automatically end at the sale — insurance and rent on a sold house can't happen. Cars and boats aren't tracked as values; model their costs as expense streams instead.

Roth Conversions

A Roth conversion moves money from a tax-deferred account to a Roth account. You pay taxes now, but the money grows tax-free forever. This can be valuable for reducing future RMDs and creating tax-free income in retirement.

Using the Roth Conversion Planner
Roth conversions are configured through the Roth Conversion Planner page, which automatically calculates a recommended conversion strategy based on your tax situation. The optimizer tests multiple timing strategies and selects the one that leaves you the most money after every tax is paid.
How It Works
Once you run the Roth Conversion Planner, your conversion schedule is automatically applied to both the Calculator projections and Chance of Success simulations. You can adjust individual years on the Roth Conversion Planner page if needed.
Conversion Window
The optimizer schedules conversions between retirement (when income drops) and the start of required minimum distributions. For couples, the window extends until both spouses have started RMDs—if your spouse is younger, you have more years to convert their tax-deferred balance before their RMDs begin. The optimizer considers tax brackets, IRMAA thresholds, and ACA subsidy cliffs when determining amounts.

Investment Assumptions

Stock Return
Expected annual return on stocks. Historical S&P 500 average is about 10% nominal (7% real after inflation). Used in the deterministic Calculator projection. Monte Carlo uses actual historical returns instead.
Bond Return
Expected annual return on bonds. Intermediate-term government bonds historically return about 5% nominal. Lower than stocks but with less volatility.
Bond Allocation
The percentage of your portfolio in bonds (vs. stocks). A common rule of thumb is "your age in bonds" but research suggests retirees may benefit from a "rising equity glidepath" starting more conservative. The percentage applies uniformly to every growth account — tax-deferred, Roth and brokerage alike. Cash accounts never hold bonds.
Inflation Rate
Expected annual inflation. The Federal Reserve targets 2%. Historical average is about 3%. All future values are adjusted by this rate and can be shown in "today's dollars."

Pre-Retirement Contributions

If you're not yet retired, add retirement savings to the salary that funds them. Open a Salary stream and enter the employee tax-deferred, Roth, and taxable contributions from that paycheck, plus any employer match and optional destination account. The Pre-Retirement Contributions section summarizes the combined amounts for each person.

Tax-Deferred Contributions
Employee contributions to a traditional 401(k), 403(b), or similar plan. The calculator warns when one person's total exceeds the age-aware 2025 employee deferral limit, while allowing cases such as a separate 457 plan or after-tax contributions.
Roth Contributions
Employee Roth savings from the paycheck. This is a planning input that may represent Roth 401(k), Roth 403(b), or Roth IRA money; verify the limits and income rules that apply to your actual account.
Brokerage Contributions
Additional savings invested in a taxable brokerage account. In a modeled working year, all employee contributions are limited by what the paycheck can fund after taxes, FICA, and working-years spending; employer match is not.

Working Years

If you're still working, the plan can model your pre-retirement years as real cash flow — not just a flat balance that grows on contributions alone. This is off by default and turns on the moment you tell the plan what you spend while working.

How it turns on
There is no toggle. Add a spending-while-working expense (the "Spending while working" gallery card, or tap "Runs while working" on any expense to snap it to today → the year before you retire) and that year becomes fully modeled. A salary on its own never switches it on — a plan with wages but no working-years spending behaves exactly as before. This keeps the numbers honest: the plan models the years you actually described, and doesn't pretend to invest a surplus it can't see.
What a modeled year computes
In a modeled working year your salary becomes spendable cash and the plan works out: salary − FICA − income tax − working-years spending − your contributions. Whatever is left is a surplus, invested in your taxable brokerage (so a good saver's balance grows before retirement, instead of sitting flat). If spending and contributions outrun the paycheck it's a shortfall, drawn from your savings through the normal order (cash → brokerage → tax-deferred → Roth) — and a pre-59½ tax-deferred draw pays the 10% early-withdrawal penalty just like it would in early retirement. A shortfall is a signal to fix the plan (spend less, save less, or earn more), not a precision feature.
FICA in your working-years tax
Salary years now include employee FICA — 6.2% Social Security up to the wage base, 1.45% Medicare on all wages, and the 0.9% additional Medicare surtax on high earners — in the taxes shown for those years. FICA is charged on your gross pay, before any 401k deferral (pre-tax deferrals don't dodge FICA). It's a payroll tax, kept out of your taxable income and MAGI, and it never touches pension, withdrawals, or Social Security. Like your income tax on wages, FICA is withheld from the paycheck: it makes the "taxes" line more accurate but does not move your projected balances — your balances only change once you add working-years spending and the surplus / shortfall becomes real.
If contributions outrun the paycheck
In a modeled year your contributions are funded from your salary, so they can't exceed what the paycheck can afford (pay, minus FICA and tax, minus your working-years spending). If they do, the plan caps them to the affordable amount — tax-deferred first, then Roth, then taxable — and shows a warning telling you to lower contributions or raise your salary. Your employer match is never capped, because it was never money that left your paycheck.
Not modeled here
Self-employment tax (SECA) and the employer half of FICA are out of scope — a 1099 income modeled as a salary stream is charged the employee FICA rate only, so its payroll tax is understated. Adding working years does not change your entered Social Security estimate (the plan takes SS as your input, it never re-derives it from an earnings record). And Roth conversions stay retirement-gated — the optimizer won't convert during high-salary working years, where a conversion would stack on wages at your top rate.

ACA Health Insurance

For early retirees (before Medicare at 65), health insurance costs can be significant. The Affordable Care Act provides subsidies based on income (MAGI). When ACA subsidies affect your conversion strategy, a callout appears on the Roth Conversion Planner page explaining the trade-off.

Premium Estimate
The optimizer estimates your health insurance premium based on your age. You can click "Edit" to enter your actual quote from healthcare.gov. The optimizer automatically calculates subsidies based on your projected income.
Show Aggressive Scenario
Click this to see what happens if you ignore ACA subsidies and maximize conversions instead. The comparison shows extra conversions, tax savings, lost subsidies, and the net impact—so you can make an informed choice.

Real-World Situations

retireclarity's building blocks — income and expense streams, one-time events, accounts, and real assets — can model more than their names suggest. These recipes show how to represent common instruments that don't have a dedicated type, and say plainly what each approximation can't capture.

Modeling an annuity

A fixed lifetime annuity (SPIA) maps cleanly onto an income stream:

  1. Add an income stream under Income & Expenses with the annual payout.
  2. Set the owner. A single-life annuity belongs to the annuitant — the stream automatically stops at their death. For a joint-life annuity, set the owner to household and it pays until the last survivor.
  3. Leave the end age empty for lifetime payments, or set one for a period-certain annuity.
  4. Inflation toggle: off for a fixed payout (most SPIAs), on if you bought a COLA rider.
  5. Tax treatment: ordinary for a qualified annuity (bought with IRA/401k money) — every payment is taxable income.

The premium — do this carefully. Don't enter the purchase as an expense: the planner would fund it through the withdrawal order and tax the withdrawal, which is wrong for a qualified purchase. Instead, reduce the source account's balance directly by the premium at the purchase date.

Non-qualified annuity? Part of each payment is untaxed return of your own money. Approximate the exclusion ratio with two streams: one ordinary for the earnings portion, one tax-free for the return-of-basis portion, ending the tax-free stream at your life expectancy.

One honest limitation: the plan runs to the life expectancy you set, so an annuity's insurance value in the beyond-that years won't show up in your Chance of Success. That protection is real — the model just can't price it yet.

Long-term care (self-insuring)

retireclarity deliberately models long-term care as what it actually is financially: a large late-life expense, funded by your assets. There's a built-in template for it — to stress-test a care scenario:

  1. Add an expense and pick the "Long-term care (last years)" template — it's pre-anchored to life expectancy and moves with it. Size it to real care costs in your area; $70K–$150K/yr is a common range.
  2. If the plan would fund care by selling the house, set the home's planned sale to the same age — the proceeds land in your accounts and fund the expense.
  3. Run Chance of Success with and without the scenario to see what the risk actually does to your plan.

If you carry LTC insurance instead, model the premiums as an expense stream and reduce the care expense by your policy's daily-benefit coverage.

Inherited IRA (the 10-year rule)

Most non-spouse beneficiaries must empty an inherited IRA within 10 years, paying ordinary income tax on distributions. There's a template for it: add an income stream and pick "Inherited IRA (10-year rule)" — enter the balance and it creates a 10-year ordinary-income stream at balance ÷ 10. Adjust the yearly amounts afterward if you plan an uneven drain schedule.

Approximation: growth inside the inherited account during the window isn't modeled — for a large inheritance, size the stream a little above balance ÷ 10 to compensate, or front-load it if you plan to drain early in low-income years (often the tax-smart move).

Expected inheritance

Use the "Expected inheritance" template (add an income stream) — a one-time, tax-free event at the age you'd conservatively expect it. If it includes a tax-deferred account, model that part as an inherited IRA (above). Unsure it'll happen? Run the plan without it — if the plan only works with the inheritance, you want to know that.

Part-time work in retirement

Consulting, a bridge job, phased retirement: add a salary-type income stream from your retirement age to whenever you plan to fully stop. The projection funds early-retirement years from it before touching your portfolio — often the difference-maker for retiring before Social Security. The ACA subsidy math sees this income too, which is exactly what you want: part-time income raises MAGI and can cost subsidies, and the model will show that honestly.

Reverse mortgage

A HECM's monthly draw is loan proceeds, not income — model it as a tax-free income stream from the start age. The balance you owe grows against the house: approximate by reducing the home's value (or its planned-sale proceeds) by the projected loan balance at sale or life expectancy.

Approximation: the compounding loan interest and fee structure aren't modeled — use your lender's amortization projection for the payoff figure, and treat the result as optimistic by roughly the fees.

Downsizing your home

This one's built in: give the home a planned sale at your downsizing age (Real Assets → planned sale, with §121 home-sale tax treatment), and add the replacement as a one-time expense — or as a new real asset if you want it back on the balance sheet. The sale proceeds, tax exclusion, and freed-up equity all flow through the projection automatically.

Health savings accounts

retireclarity doesn't model HSAs as their own account type yet. The closest honest proxy: fold your HSA balance into Roth (add it to your Roth balance, or itemize an account named "HSA" with the Roth type). Growth is tax-free and qualified medical withdrawals are tax-free — and in retirement, medical expenses are plentiful enough that most HSA dollars exit qualified.

What the proxy misses: the contribution deduction during working years, the 20% penalty on pre-65 non-medical withdrawals (Roth basis rules are friendlier), and post-65 non-medical withdrawals being taxed like an IRA. If your HSA is a large share of your savings, treat the projection as slightly optimistic.

Understanding Results

Summary & Projections

The Calculator displays your results in two main areas:

Your Projection
A colored status banner shows whether your plan is on track: green (fully funded), yellow (falls short), or red (needs attention). On desktop, this panel stays visible on the right as you adjust inputs, showing projected balance at life expectancy, total withdrawals, and key milestones.
Year-by-Year Data
Expand any accordion section to see detailed projections including account balances, income sources, taxes, and Roth conversions for each year of retirement. All values are shown in today's dollars (inflation-adjusted).

Charts

Visual representations help you quickly understand your financial trajectory:

  • Cash Flow: Stacks spendable salary, Social Security, pensions, other income, and portfolio withdrawals against the spending line. Roth conversions appear separately as non-spendable transfers
  • Account Balances: Stacked area showing each account type and real assets over time
  • Income & Spending: A selectable-year money-flow diagram from income and withdrawals through taxes, spending categories, and savings

Event markers and milestone lines identify retirement, Social Security, pension, other income, Medicare, RMDs, life expectancy, and your custom milestones. Hover or select them for details.

Tax Breakdown

The tax detail section shows exactly how your taxes are calculated:

  • Ordinary Income: Salary, RMDs, tax-deferred withdrawals, taxable Social Security
  • Capital Gains: Gains from brokerage account withdrawals
  • Federal Tax: Based on tax brackets for your filing status
  • State Tax: Based on your state's tax rules
  • IRMAA: Medicare surcharges if income exceeds thresholds
  • NIIT: 3.8% surtax on investment income for high earners

Progress

The Progress page tracks your actual net worth over time — your account balances plus real assets, minus liabilities — separately for each plan. Where the Calculator projects your future, Progress records your past.

How Entries Are Created

Entries are created automatically whenever you update a balance — any account, real asset value, or liability balance. At most one entry is recorded per day: if you change balances again the same day, the entry is updated in place, so the day always reflects your latest values.

Backfilling History

  • Add entry lets you record a past balance — pick any earlier date and enter the amounts. Backfilling a few historical points is the fastest way to see your growth trend.
  • Editing an entry (any amount, via the row menu) marks it as manual, so you can tell recorded values from hand-entered ones.
  • Deleting an entry removes it permanently after a confirmation.

Reading the Chart

The range toggles (1M / 3M / 1Y / 5Y / 10Y / All) window the chart to a period ending today; the header shows your change over the selected range. The Net view plots a single net-worth line, while Accounts stacks each account type — the same colors used by the projection charts — with liabilities drawn below zero.

Like everything else in retireclarity, your history lives in your browser's local storage alongside the rest of your plan, is included when you export the plan, and stays in your browser.

Chance of Success

The Chance of Success page uses Monte Carlo simulation to stress-test your retirement plan against thousands of possible market scenarios based on actual historical data. While the Calculator shows a single projection, Chance of Success shows the probability that your money will last.

How It Works

  1. Historical Block Sampling: The simulation randomly selects 3-7 year blocks of actual historical returns (1926-2024) and stitches them together to create unique market scenarios.
  2. Sampling With Replacement: Blocks are drawn with replacement (a proper bootstrap), so a bad era can appear more than once in a long retirement — only an immediate back-to-back repeat of the identical block is rerolled.
  3. 2,000 Trials: Each trial represents one possible future. Running 2,000 trials gives statistical confidence in results while keeping simulation time quick.
  4. Success/Failure: A trial "succeeds" if your portfolio lasts through your life expectancy. It "fails" if you run out of money.

Historical Data

The simulation uses 99 years of historical data (1926-2024):

  • Stock Returns: S&P 500 total returns (with dividends reinvested)
  • Bond Returns: Intermediate-term government bonds
  • Inflation: Historical CPI for that year
  • Market Events: Major events like the Great Depression (1929-1932), 1970s Stagflation, Dot-Com Crash (2000-2002), Financial Crisis (2008), and COVID (2020) are labeled in trial details.

Understanding Your Results

Success Rate
The percentage of trials where your portfolio survived through life expectancy. A common target is 90-95%. Below 80% suggests significant risk of running out of money. This is the primary metric shown prominently at the top.
Outcome Statistics
The sticky panel shows three key outcomes: Median (the middle result), Top 25% (what happens in good scenarios), and Bottom 25% (what happens in poor scenarios). All values are shown in today's dollars.
Portfolio Chart
The chart shows the median outcome and the middle 50% range. The highlighted "sequence risk window" marks the first 7 years of retirement—when bad returns hurt the most.
Scenario Comparisons
The page automatically compares your plan against alternatives: What if you skip Roth conversions? What if you're willing to cut flexible spending in bad years? These comparisons help you understand the trade-offs in your strategy.
Bond Allocation Optimizer
Automatically runs when you simulate, testing different stock/bond mixes to find the best allocation for your assumptions. Uses an 80/20 weighting of success rate vs. median balance.
Trial Explorer
Click "Explore individual trials" to see all 2,000 simulation trials. You can filter by outcome, sort by balance, and click any trial to see year-by-year details including which historical periods were sampled.

Roth Conversion Planner

The Roth Conversion Planner page provides automated tools that size Roth conversions to leave you the most money after every tax is paid.

Roth Conversion Optimizer

See how much more your plan keeps by converting to Roth at the right pace. The planner tests multiple conversion intensities and refines the schedule that leaves the most after all taxes are paid — including what your heirs keep.

How It Works
Maximizes the money you keep at the end of your plan — leftover traditional balances counted at a flat 25% heir rate, brokerage gains at long-term capital-gains rates, and Roth dollars tax-free. That same 25% is applied to the recommendation and to the no-conversion baseline alike, so it shapes the comparison, not the verdict. The planner seeds itself by filling the cheapest tax-bracket room first (a target tax-deferred balance keeps future RMDs low), then buys conversion space in price order. Safety lives in hard limits, not scoring penalties: every recommended year has to be affordable, has to leave two years of spending reachable without a forced traditional withdrawal in every year your plan could already do that without converting, and can never make your money run out earlier than it would with no conversions at all.
Intensity Sweep & Refinement
Starts with a bracket-fill schedule, tests conversion budgets from no conversions through progressively deeper target-balance reductions, and keeps whichever leaves you the most money. A refinement pass then buys the cheapest remaining tax space first and shifts dollars between years. A final convergence pass re-offers every add, removal and year-to-year shift at $100K, $50K, $25K, $10K, $5K and $1K, cycling that ladder until a complete pass at every size changes nothing — or until a generous compute budget runs out. In the common case it reaches that fixed point: a certified local optimum, not a claim of global perfection. The three hard constraints (affordability, two years of reachable spending where your plan already had them, never worsening how long your money lasts) bound the search rather than scoring it down. The opening estimate holds back from an IRMAA step and from the ACA cliff, but neither is fenced off in the refinement or in the objective — they're priced, so a cliff is crossed only when crossing it leaves you with more.
How Much to Convert
The run doesn't stop at one answer — it measures your plan's whole conversion-efficiency curve, and the How much to convert slider is how you pick a point on it. Every stop is a schedule that was actually evaluated through the same engine and the same hard limits, so there is nothing between two stops: you can only choose a plan that was priced. The panel headline is the pair the choice turns on — the money you keep, and the tax you pay now — and both figures, the stat tiles and both charts re-derive as you drag.

Three words on the track are the named stops, and each one is a button that jumps there. Nothing is converting nothing, the baseline everything else is measured against. Optimal is the right end: the schedule that leaves the most money after every tax is paid. Efficient is the detent between them — the last stop where each new $1 of conversion tax still earns at least $0.50 of after-tax estate. Past it, the track is labelled Diminishing returns: every stop up to Optimal still adds net money, just at a shrinking rate. A live readout prints that rate at whatever stop you're on, a share line states what the stop keeps as a share of the gain and of the full tax bill, and How this is calculated opens the $0.50 rule and what it rests on.

The slider applies itself. There is no Apply button and no preview state: releasing the slider is choosing that schedule, and the rest of the app projects it from that moment. A fresh run opens on Efficient where your curve has a knee, and on Optimal where it doesn't; come back later and the slider is wherever you left it. One thing it does not do is clear the "Results may be outdated" banner — moving the slider picks among schedules an earlier run already measured, so only running the optimizer again re-measures them.
The Two Charts
Two views of the schedule the slider is on. What you keep shows the balances your plan ends up with, bucket by bucket, against no conversions. Why this works puts your tax bill beside the no-conversion baseline year by year, with the Medicare (IRMAA) tier each year lands in charted under the axis.
Roth Conversion Schedule
Below the panel, always open, the year-by-year table is the audit of the schedule you picked: for each year, the conversion amount with its bracket bar, the federal bracket as marginal → effective rate, federal and state tax, the ACA and IRMAA effect, and the year's total tax cost. Every row carries a Why this amount tooltip naming the ceiling that decided it, and a year the optimizer left out reads Not recommended with its reason beside it.

The table is read-only, deliberately. Hand-edited years and pinned amounts were removed: a year you overrode was priced by nobody, and the schedule stopped matching the curve the panel was measuring. If a particular year really is different — a property sale, a large one-off gain, a year of consulting income — model that reality in your plan's income and expense streams. The optimizer prices it and the schedule reflects it.

Important: Roth conversions increase taxes now to reduce taxes later. Paying taxes early can slightly reduce success rates due to sequence-of-returns risk. The Chance of Success page automatically compares scenarios with and without conversions to show this trade-off.

ACA Subsidy Considerations

For early retirees (before age 65), ACA subsidies can save thousands per year. The Roth Conversion Planner automatically includes ACA implications:

  • Subsidies priced, not fenced: The opening estimate holds bracket room 5% below the 400% FPL cliff in years where you'd otherwise collect a material subsidy. From there the search prices lost subsidies as the real dollars they are, and crosses the cliff only when crossing it leaves you with more money after every tax.
  • Health Insurance Costs: Your ACA premium settings are factored into the optimization. If you don't enter a premium, the optimizer estimates one based on your age using benchmark data.

The schedule shows estimated healthcare effects year by year, and marks every year whose conversion was held down by the 400% line.

Why the 5% margin at 400% FPL: The opening estimate works from projected income, and projections move — a Social Security COLA increase or an unexpected fund distribution can shift the real number, and going $1 over the cliff loses the entire subsidy. So the seed leaves 5% of headroom. It's a fixed modeling margin, not a setting: the refinement pass works from the full projection, prices the subsidy at its real value, and can spend that headroom when the trade is worth it.

Bond Allocation Optimizer

Found on the Chance of Success page, this tool finds the best stock/bond mix for your assumptions by testing multiple allocations across thousands of historical scenarios.

How It Works
Tests multiple bond allocations (0%, 20%, 40%, etc.) and refines around the best results. Uses a balanced objective that weighs 80% success rate and 20% median balance.
Results Table
Shows success rate, median final balance, and 10th percentile (worst case) for each allocation. The recommended allocation is highlighted.

Tax Calculations

retireclarity implements detailed tax calculations based on current IRS rules.

Federal Income Tax

Key Bracket Tops for Roth Conversions (2026)
12%
$48K / $97K
22%
$103K / $207K
24%
$197K / $395K
32%
$251K / $501K

Single / Married Filing Jointly

Uses 2026 tax brackets (indexed for inflation in future years):

RateSingleMarried Filing Jointly
10%$0 - $12,400$0 - $24,800
12%$12,401 - $50,400$24,801 - $100,800
22%$50,401 - $105,700$100,801 - $211,400
24%$105,701 - $201,775$211,401 - $403,550
32%$201,776 - $256,225$403,551 - $512,450
35%$256,226 - $640,600$512,451 - $768,700
37%Over $640,600Over $768,700
12% Bracket
Single$12,401 - $50,400
Married$24,801 - $100,800
22% Bracket
Single$50,401 - $105,700
Married$100,801 - $211,400
24% Bracket
Single$105,701 - $201,775
Married$211,401 - $403,550

Showing common brackets. Full table visible on larger screens.

State Income Tax

All 50 states plus DC are supported. Key features include:

  • No Income Tax: AK, FL, NV, NH (dividends only), SD, TN (dividends only), TX, WA, WY
  • Flat Tax States: CO, IL, IN, KY, MA, MI, NC, PA, UT
  • Progressive Tax States: Most other states with multiple brackets
  • Retirement Income Exemptions: Many states exempt Social Security, military pensions, or provide senior income exclusions

Social Security Taxation

Social Security benefits may be partially taxable based on "combined income" (AGI + non-taxable interest + half of Social Security):

Combined IncomeSingleMarried
0% TaxableUnder $25,000Under $32,000
Up to 50% Taxable$25,000 - $34,000$32,000 - $44,000
Up to 85% TaxableOver $34,000Over $44,000

Note: These thresholds are not indexed for inflation and have remained unchanged since 1993.

Capital Gains

Long-term capital gains (assets held over 1 year) are taxed at preferential rates:

  • Gains fill the separate 0%, 15%, and 20% long-term capital-gains bands.
  • Taxable ordinary income fills the bottom of the income stack first, so one gain can span more than one capital-gains rate.
  • Any unused standard deduction can shelter part of the gain before the rate bands are applied.

For brokerage accounts, capital gains are calculated based on your cost basis (the original amount you invested). Enter your cost basis in the Retirement Savings section of the Calculator. The calculator tracks how your cost basis changes over time as you make withdrawals and reinvestments.

Required Minimum Distributions (RMDs)

RMD Start Age by Birth Year
72
Born before 1951
73
Born 1951-1959
75
Born 1960+

Tax-deferred accounts (401k, Traditional IRA) require minimum withdrawals starting at the age shown above based on your birth year (per SECURE Act 2.0).

RMDs are calculated using the IRS Uniform Lifetime Table, dividing the account balance by a life expectancy factor. Failure to take RMDs results in a 25% penalty (50% before 2023).

Retiring Before 59½

Tax-deferred withdrawals taken before the year you attain 59½ incur the federal 10% additional tax (26 U.S.C. §72(t)) on top of ordinary income tax. Projections apply it per person, to each person's own accounts — a younger spouse's IRA draws are penalized on the spouse's age even when you are past 59½. The penalty is a tax, not income: it never inflates your MAGI for ACA subsidies or IRMAA, but planned withdrawals are sized larger to cover it, so pre-59½ plans deplete tax-deferred money faster. Three legal escape hatches are modeled:

Rule of 55
If you separate from your employer in or after the year you turn 55, withdrawals from that employer's 401(k)/403(b) are penalty-free. Mark each 401(k)/403(b) account as "Current employer's plan" (the default) to claim it; IRA money is never protected, so avoid rolling a protected 401(k) into an IRA before 59½ if you plan to spend it early. Separation timing is your retirement age — retiring at 54 forfeits the exception entirely.
72(t) / SEPP (Substantially Equal Periodic Payments)
An opt-in schedule of fixed annual IRA withdrawals that is penalty-free at any age — but locks you in for at least 5 years and until 59½, whichever is later. Enable it per person via the "72(t) early withdrawals (SEPP)" card in Accounts; the payment is computed once (IRS amortization method, Single Life Table) from the balance in the first payment year and stays fixed. Payments are still ordinary income and can't be Roth-converted away.
Roth ordering and the 5-year conversion clock
Roth withdrawals follow the IRS ordering: contributions first (always tax- and penalty-free — set "Contributions to date" on your Roth accounts), then conversions oldest-first, then earnings. Each conversion has its own 5-year clock: spending it before conversion year + 5 and before 59½ pays the 10% recapture penalty. Waiting out the clock is the classic "Roth conversion ladder" — convert now, spend penalty-free in year 6. Earnings drawn before 59½ are ordinary income plus the penalty; after 59½ everything is tax-free.

See the Modeling Notes section for the simplifications behind these rules.

IRMAA Medicare Surcharges

Key IRMAA Thresholds (2026)
No Surcharge Below
$109K single / $218K married
Max Surcharge Above
$500K single / $750K married

Income-Related Monthly Adjustment Amount (IRMAA) increases Medicare Part B and D premiums for high-income individuals. Uses MAGI from 2 years prior.

Single MAGIMarried MAGIMonthly Surcharge
≤$109,000≤$218,000$0
$109,001-$137,000$218,001-$274,000$95.70
$137,001-$171,000$274,001-$342,000$240.40
$171,001-$205,000$342,001-$410,000$385.00
$205,001-$500,000$410,001-$750,000$529.60
>$500,000>$750,000$578.00
Single≤$109,000
Married≤$218,000
Surcharge$0/mo
Single$109K-$137K
Married$218K-$274K
Surcharge$95.70/mo
Single>$500,000
Married>$750,000
Surcharge$578.00/mo

Showing key tiers. Full table visible on larger screens.

2026 thresholds. Monthly surcharges include Part B and Part D combined.

NIIT (Net Investment Income Tax)

NIIT Thresholds (2026)
Single / HoH
$200,000
Married Filing Jointly
$250,000
Rate
3.8%

The Net Investment Income Tax (NIIT) is a 3.8% surtax on investment income for high earners. It applies to the lesser of:

  • Your net investment income (capital gains, dividends, interest)
  • Your MAGI exceeding the threshold

For example, if you're single with $300,000 MAGI and $50,000 in capital gains:

  • MAGI excess: $300,000 - $200,000 = $100,000
  • Net investment income: $50,000
  • NIIT applies to lesser amount: $50,000 × 3.8% = $1,900

Key differences from IRMAA: NIIT thresholds are not inflation-adjusted (fixed since 2013), and NIIT applies at any age (not just Medicare age 65+). There's also no 2-year lookback—NIIT is based on the current year's income.

Modeling Notes & Known Approximations

No planning tool models the entire tax code. retireclarity models real law wherever it changes decisions, and simplifies deliberately where it doesn't. This section lists those simplifications honestly — what's modeled, what's approximated, and which direction the approximation leans — so you can judge the results with open eyes. All dollar rules are anchored to published 2026 figures and indexed forward from there.

Federal Tax Rules

Inflation indexing
Tax brackets and the standard deduction are indexed forward using your inflation setting. The IRS actually indexes by chained CPI, which typically runs a fraction of a percent below ordinary CPI — so if your inflation setting reflects ordinary CPI, real-world brackets will likely grow slightly slower than modeled, and actual long-run taxes may run marginally higher than projected.
Thresholds that genuinely never move
Social Security taxation thresholds ($25K/$32K, unchanged since 1993) and NIIT thresholds ($200K/$250K, fixed since 2013) are not indexed in the model because they are not indexed in law. That's not an approximation — it's why more of your Social Security becomes taxable as incomes inflate.
Senior deductions
The permanent age-65+ additional standard deduction is modeled ($2,050 for Single/HoH, $1,650 per 65+ spouse filing jointly, per living taxpayer). The temporary OBBBA "senior bonus" deduction ($6,000/person, tax years 2025–2028 only, with income phase-outs) is deliberately not modeled: it expires before most projection years. Real taxes in 2025–2028 may be slightly lower than shown — a conservative bias.
Survivor filing status
The year a spouse dies still files jointly; the survivor files Single from the following year. The two-year Qualifying Surviving Spouse status (which requires a dependent child) is not modeled — it rarely applies to retirees, and skipping it is conservative.
NIIT investment income
The 3.8% NIIT is computed on capital gains only. Net rental income also counts as investment income in real life but is not included here, so landlords with MAGI above the thresholds may owe slightly more than shown.

ACA Health Insurance

2026 law — enhanced subsidies expired
The enhanced pandemic-era subsidies expired at the end of 2025. Projections use the 2026 rules: a hard subsidy cliff at 400% of the Federal Poverty Level (earning $1 more loses the entire subsidy) and a steeper expected-contribution curve (roughly 2.1%–9.96% of income, per the IRS 2026 table).
Income below 100% FPL
Under 2026 law, income below 100% FPL is ineligible for marketplace subsidies. The model shows those years as estimated Medicaid at $0 premium — accurate in Medicaid-expansion states, but the "coverage gap" in non-expansion states is not modeled.
Married Filing Separately
MFS filers are ineligible for premium subsidies by statute and are modeled at full marketplace price (the narrow abuse/abandonment exceptions are not modeled).
Employer coverage — what isn't modeled
Each person's employer plan covers them (or both of you) until the month that person retires; from there the household buys marketplace coverage until Medicare at 65. Three deliberate approximations sit behind that: COBRA is not modeled separately — an 18-month bridge is priced as ACA, which is usually close and sometimes cheaper than real COBRA; retiree medical (an employer plan that continues past retirement) has no dedicated input — model it by entering your own premium as the healthcare quote override; and the premiums you pay while working are not modeled at all — payroll deductions are treated as part of the paycheck, so a covered working year shows $0 healthcare cost rather than your share of the employer plan.
Benchmark premiums
If you don't enter your own quote, premiums come from a benchmark table priced at the primary person's age band and doubled for couples. The table floors at age 50 and tops out at 64 — younger early retirees and couples with a large age gap should enter their actual healthcare.gov quote.

Medicare IRMAA

Per beneficiary, real CMS amounts
Surcharges use the published CMS 2026 amounts (Part B + Part D combined) and are charged once per Medicare beneficiary — a 65+ couple pays twice — and trigger when either spouse is 65+. Thresholds index with your inflation setting; surcharge dollars grow with medical inflation.
Two-year lookback
IRMAA is based on your MAGI from two years earlier, as in real life. The first two projection years have no lookback history yet, so they approximate using current-year income instead.
No life-event appeals
SSA-44 appeals (work stoppage, marriage, death of a spouse) are not modeled. In reality, retiring is a qualifying event that often waives IRMAA in the first Medicare years, so early-retirement IRMAA may be overstated — conservative.

State Taxes

Tax year 2026 data
All 50 states plus DC use tax-year 2026 rates, brackets, and deductions, each value carrying a source note in the data. A few figures the states have not yet published for 2026 deliberately remain at their 2025 values, marked in the data. States legislate rate changes constantly; data is refreshed periodically.
Retirement income exemptions
State pension and retirement-income exclusions apply to IRA/401(k) withdrawals, RMDs, and Roth conversions according to each state's actual law — full exemptions in states like Illinois, Pennsylvania, and Mississippi; capped exclusions in states like Georgia, New York, New Jersey, and Colorado — per person, with per-person age gates.
Not modeled: income cliffs and phase-outs
New Jersey's pension exclusion actually disappears entirely above ~$150K of income; the model grants the exclusion regardless of income (and, conservatively, never grants it to conversions). Minnesota and Vermont phase their Social Security exemptions out gradually above their thresholds; the model uses a hard cutoff at the threshold instead.
Not modeled: capital-gains preferences
A few states tax long-term gains at a discount (SC, AR, WI, MT, ND, HI). The model taxes gains as ordinary state income everywhere, slightly overstating state tax in those states.
Not modeled: high-income surtaxes
California's 1% mental-health surtax over $1M, Massachusetts' 4% surtax over $1M, and Washington's capital-gains excise tax are not modeled. Very high-income years in those states are understated.
Not modeled: government-pension carve-outs
Some states fully exempt government or public-service pensions (e.g., New York) beyond their general pension rules. The model can't distinguish a government pension from a private one, so those retirees may see overstated state tax.

Projection Engine

RMD table
RMDs use the IRS Uniform Lifetime Table. The Joint Life Expectancy Table (Table II), which lowers RMDs when your sole-beneficiary spouse is more than 10 years younger, is not modeled — those couples' RMDs are overstated, which is conservative.
Survivor rollover
When a spouse dies, their tax-deferred balance rolls into the survivor's account (the spousal "treat-as-own" rollover — the overwhelmingly common election), and future RMDs follow the survivor's own age and schedule.
Death timing
Each person lives through the end of their life-expectancy year. That final year still files jointly; the survivor files Single starting the next year.
How withdrawal taxes settle
Withdrawal sizing, Social Security taxation, and taxes are solved together in a convergence loop. Any last-resort top-up withdrawals needed to cover the final tax bill are themselves re-taxed once in a single bounded pass; the second-order tax on that top-up (roughly the marginal rate squared — usually a few dollars) is an accepted, documented residual rather than an endless tax-on-tax spiral.
Mid-year convention
Withdrawals, Roth conversions, and reinvestments are assumed to happen mid-year and earn half a year of growth; money that stays put earns the full year.
Early-withdrawal (pre-59½) rules
The 10% penalty, Rule of 55, 72(t)/SEPP, and Roth conversion seasoning are modeled with these accepted simplifications: the whole calendar year in which 59½ is attained is treated as penalty-free; Roth money is one household bucket whose qualified-age test uses the older living spouse; conversions made before today aren't seeded into the 5-year ladder (only in-projection conversions get clocks); state-level early-withdrawal penalties (e.g., California's 2.5%) and penalty exceptions beyond Rule of 55/SEPP (medical, disability, first home, public-safety age 50) are not modeled — where these matter, projections lean conservative.
FICA (payroll tax)
Employee FICA on salary uses the current Social Security wage base grown forward by cumulative inflation as a wage-indexing proxy (the real base is re-indexed to average wages each year — close but not identical). The 0.9% additional Medicare surtax thresholds ($200K single / $250K married-joint / $125K married-separate) are not inflation-adjusted, matching the statute, which is fixed in nominal dollars. The employer half and self-employment (SECA) are not modeled.
Working-years cash flow
Once you enter working-years spending, a pre-retirement year is modeled as salary in, taxes/FICA/spending/contributions out, surplus to brokerage or shortfall from savings. Working-years spending does not flex in bad markets (spending flexibility is a retirement behavior). A pre-retirement shortfall funded from savings pays its early-withdrawal penalty, and the last- resort top-up that covers the tax on that draw isn't itself grossed up — so a small residual (bounded under ~3% of the tax-deferred draw) is left uncovered. That's an accepted approximation on what is already a plan-failure signal, not a precision path.

Monte Carlo

Historical bootstrap
Each trial stitches together random 3–7 year blocks of actual 1926–2024 history. Stock returns, bond returns, and inflation are always drawn from the same historical year, preserving their real-world correlations. Blocks are sampled with replacement (a proper bootstrap), so a bad era can recur within a long retirement.
Precision
Each run is 2,000 trials. At a 90% success rate, the sampling margin is about ±1.3 percentage points — treat 89% and 91% as the same answer.
Success definition
A trial succeeds if the money lasts until the last survivor's life expectancy — for couples, the projection runs to whoever lives longer, not just yours.
Spending cuts
Flexible expenses are reduced according to your Spending Flexibility (Guyton-Klinger) settings; the portfolio trigger watches total household wealth, including a spouse's retirement accounts.
Pre-retirement sequence risk
For plans with working-years spending, the modeled accumulation years are now part of each trial — so a bad market in the years right before you retire hits the surplus you were counting on. This pre-retirement sequence-of-returns risk is real and now captured, which can shift the success rate for accumulators (a crash at 63 matters, not just one at 73). Plans without working-years spending still accumulate on contributions and returns alone, unchanged.

Privacy & Data

Private by default — all modeling runs in your browser.

retireclarity is a client-side application. All calculations run entirely in your browser, and your inputs are saved locally in your browser's localStorage. No account or login required, and today your plan data is not sent externally.

For complete details about data storage, analytics, and security, please see our Privacy Policy, or the privacy-first retirement planner overview for how retireclarity compares to server-based planners.

FAQ

What do the colored status banners mean?

The projection card shows your ending balance or the age through which the plan is funded. Its color describes the real trajectory relative to your starting portfolio: Growing, Stable, Declining, or Depletes. For people more than five years from retirement, it instead leads with the earliest retirement age the deterministic projection can support.

What is 'success rate' and what's a good target?

Success rate shows how often your money lasted in 2,000 trials using real market history since 1926. A 90-95% target is reasonable for most retirees—100% usually means being overly conservative with a large unused balance. Each run varies slightly (±1-2%) due to random sampling; this is normal.

What if I die before my life expectancy?

Life expectancy is a planning horizon, not a prediction. Money left when you pass goes to heirs or your estate—it's not wasted. Planning to age 95 gives you a safety margin; the real risk is outliving your money, not leaving some behind.

What's the 'sequence risk window' highlighted in charts?

The first 7 years of retirement are when bad returns hurt most. Poor markets early force you to withdraw from a shrinking portfolio, leaving less to recover later. This is why Roth conversions—which pay taxes up front—can slightly reduce success rates despite saving taxes long-term.

I see a high success rate but also a large ending balance - what does that mean?

Success rate measures survival (did your money last?), while median balance shows the typical outcome. A 95% success rate with a large balance means: you typically end with extra money, and that cushion is what allows survival in even the worst 5% of scenarios. This is healthy—not wasteful.

When are Roth conversions worth it?

Conversions work best with a long retirement (20+ years), low-income years before RMDs start, or when you want to reduce future required withdrawals. They're less valuable for short retirements, when you're already in high brackets, or if you need the money soon. The Roth Conversion Planner shows you the actual dollar impact for your situation.

How does the Roth optimizer decide how much to convert?

It maximizes the money you keep after every tax is paid — the after-tax estate at the end of your plan, with leftover traditional balances counted at a flat 25% heir rate and Roth dollars tax-free. To get there it fills the cheapest tax-bracket room first (seeding from a target tax-deferred balance that keeps future RMDs low), then buys conversion space in price order, then re-offers every add, removal and year-to-year shift at sizes from $100K down to $1K, cycling until a complete pass changes nothing or a generous compute budget runs out — in the common case it reaches that fixed point. Three things are enforced as hard limits: you must be able to afford each year's conversion tax, every year must keep two years of spending reachable without a forced traditional withdrawal in every year your plan could already do that without converting, and no schedule may make your money run out earlier than it would with no conversions. Medicare premium cliffs (IRMAA) and the ACA subsidy cliff hold back the opening estimate, but they are not limits on the search that follows — they're priced as the real dollars they cost, so the planner crosses a cliff only when crossing it leaves you with more. Then the pace is yours: the planner measures nested, smaller versions of that schedule and the "How much to convert" slider moves between them, from converting nothing to the Optimal schedule, stopping only on positions it actually evaluated. For a deeper dive, see Inside the Roth Conversion Calculator: How the Math Actually Works.

Why might the optimizer suggest different amounts each year?

The optimizer fills available tax bracket space, which changes based on your other income. Years with high Social Security or required withdrawals may have zero conversions, while low-income years convert more. Before age 65, ACA health insurance constraints may also limit conversion amounts to protect subsidies.

How are capital gains taxed in my brokerage account?

The calculator uses your cost basis to determine what portion of brokerage withdrawals are taxable gains. Enter your actual cost basis (original investment amount) in the Calculator for accurate projections. These gains are taxed at 0%, 15%, or 20% based on your income—lower than regular tax rates. The tax detail section breaks down exactly how much you'll pay each year.

What's the difference between "Today's Dollars" and "Future Dollars"?

"Future Dollars" shows the actual dollar amounts you'll see in that year. "Today's Dollars" adjusts for inflation to show equivalent purchasing power. For example, $100,000 in 20 years at 3% inflation has the same purchasing power as about $55,000 today.

How accurate are these projections?

The projections are as accurate as your inputs and assumptions. Real life has more variables: tax law changes, unexpected expenses, health issues, housing decisions. Use these projections as a planning tool, not a guarantee. Revisit your plan annually.

Can I export my data?

Yes! On the Calculator page, you can export your inputs to a JSON file for backup or transfer between devices. You can also import previously exported files. In Chance of Success, open an individual trial to export its year-by-year details as CSV. A printable detailed report is available from the Calculator.

Have questions or feedback? Use the Feedback link in the page footer.