Documentation manual
Retirement Account Modeler
How the model works, what every input does, the 2026 tax parameters behind it, and what it leaves out.
Site: usaretirement.life
Version 1.0, November 13, 2026
Model basis: United States federal tax year 2026
Author: Tomas Aparicio

Educational use only. Not financial, tax, legal or insurance advice.

Contents

1. Purpose and scope
2. Quick start
3. The interface
4. Inputs reference
5. How the model calculates
6. 2026 tax parameters
7. Outputs reference
8. Example scenarios
9. Validation
10. Limitations
11. Maintenance and yearly update
12. Glossary
13. References
Read this first. Every figure the app produces is a hypothetical estimate from simplified rules and constant returns. The example balances are placeholders. Do not act on a result without a qualified professional who knows your situation. Section 10 lists what the model ignores.

1. Purpose and scope

The Retirement Account Modeler projects account balances and an estimated tax bill for every year from today to a chosen end age. It is built to compare strategies side by side: when to retire, when to convert to Roth, which account to draw first, when to claim Social Security, and how a change in future tax rates would alter the answer.

It covers seven account buckets: pre-tax 401(k), Roth 401(k), traditional IRA, Roth IRA, HSA, taxable brokerage, and a life insurance retirement plan (LIRP). It handles W-2 employees and self-employed people filing Schedule C.

What it is for

What it is not

2. Quick start

  1. Open usaretirement.life. The app loads five example scenarios for a 50-year-old earning $1,000,000.
  2. In the left sidebar, open Start here. Replace the ten values with your own: current age, retirement age, income, living expenses while working, living expenses in retirement, 401(k) balance, brokerage balance, return before retirement, Social Security claiming age, and state tax rate.
  3. Open Profile and set filing status and whether you are a W-2 employee or self-employed.
  4. Open Current balances and enter the remaining accounts.
  5. Read the six headline tiles, then the What to watch flags on the Overview tab.
  6. Click Duplicate, rename the copy, change one lever, and open the Compare tab.
Inputs are saved in your browser's local storage. They are not sent to the site owner. Clearing site data, or using another browser or device, starts from the examples again. Reset restores the five examples and discards your scenarios.

3. The interface

Toolbar

ControlWhat it does
Scenario tabsSwitch the active scenario. Up to six scenarios. The first one is the baseline that every comparison measures against.
Duplicate / DeleteCopy or remove the active scenario.
Today's dollars / Future dollarsToday's dollars divides every amount by cumulative inflation, so values are comparable across ages. Future dollars shows nominal amounts.
Edit inputsOn narrow screens, jumps to the input panel, which sits below the results.
ResetRestores the five example scenarios.

Result tabs

TabContentsDirect link
OverviewFlags, account balances by age, tax treatment of the portfoliousaretirement.life
TaxesAnnual tax bill by component, effective and marginal rates/#taxes
Income and expensesLiving expenses by category, retirement cash sources, year-by-year table with CSV copy/#income
StrategiesPower of Zero scorecard, Social Security card and claim-age table/#strategies
CompareAfter-tax gap against the baseline, comparison table/#compare
AssumptionsThe model's own notes on method and omissions/#method

4. Inputs reference

Money inputs are in today's dollars unless stated. Sliders have limits; the number box beside a money slider accepts larger values.

Profile

InputMeaningDefault
How you earnW-2 employee or self-employed (sole proprietor, freelancer, single-member LLC on Schedule C)W-2
Filing statusSingle or married filing jointlySingle
Current age, Retirement age, Plan through ageThe projection runs one row per age. Earned income stops at retirement age.50 / 62 / 95
Salary or net business profitW-2 wages, or Schedule C net profit when self-employed$1,000,000
Income growthNominal yearly growth of that income3%

Current balances

InputMeaningDefault
401(k) pre-tax, Roth 401(k), Traditional IRA, Roth IRA, HSA, BrokerageBalances today$1.5M / $100K / $300K / $150K / $60K / $2M
Brokerage cost basisShare of the brokerage balance that is already-taxed basis. The rest is unrealized gain.60%

Annual savings while working

InputMeaningDefault
Employee deferral, share of limitPercent of the yearly deferral limit, including catch-up100%
Roth share of deferralSplit of the base deferral between Roth and pre-tax0%
Employer contributionW-2 only. Percent of pay, counted up to the compensation limit.4%
After-tax 401(k) to RothMega backdoor Roth amount, capped by the total additions limit$0
IRA each yearNone, backdoor Roth, or nondeductible traditionalNone
HSA coverageNo HSA, self-only, or family. Contributions stop at 65.Self-only
Brokerage savingsEither whatever is left after expenses, or a fixed amountAfter expenses
Retirement plan (self-employed)Solo 401(k), SEP-IRA, SIMPLE IRA, or noneSolo 401(k)
Employer-side contribution, cash balance plan, health premiums (self-employed)Share of the maximum employer contribution; an optional defined benefit contribution; deductible health insurance100% / $0 / $0

Living expenses

InputMeaningDefault
Living expenses while workingAfter-tax spending. The surplus goes to brokerage; a gap is drawn from it.$400,000
Living expenses in retirementCore after-tax spending before the lines below$300,000
Early / middle / late shares and end agesScale core retirement spending by phase100% each; 75, 85
Mortgage or fixed housing paymentYearly, not inflated, until the chosen age$0
Health insurance before Medicare; Healthcare in retirement; Healthcare inflationSeparate cost lines that grow at their own rate$0 / $0 / 5%
Medical costs paid from HSATax-free HSA withdrawals that cover part of spending$10,000
Long-term care, years of careYearly cost in the final years of the plan$0, 3 years
One-off expensesUp to four items by name, age and amountNone

Social Security, markets, withdrawals

InputMeaningDefault
Your benefit at 67; claiming ageYearly benefit at full retirement age, adjusted for the age you claim$50,000; 70
Spouse benefit and claiming ageJoint filers only. Spouse is assumed to be your age.$0; 67
Benefit cut and start yearA percentage cut to all benefits from a chosen year0%
Return before / in retirement; Inflation; Dividend yieldConstant nominal rates. Dividends are taxed yearly as qualified.6.5% / 5.5% / 2.5% / 1.5%
Withdrawal orderTaxable then pre-tax then Roth; pre-tax first; proportional; or Roth firstTaxable first

Roth conversions, LIRP, state tax, future law

InputMeaningDefault
Conversion strategyNone; Power of Zero shift to a target; fill a bracket; fixed amountNone
Target; bracket; amount; start and end ageParameters for the chosen strategy. Conversions can start before retirement.Ideal; 24%; $200K; 62 to 74
LIRP premium, years, existing valueAfter-tax premiums paid while working$0; 10; $0
Crediting rate; policy costsNet growth is the crediting rate minus costs6%; 1.5%
Loan start age; annual loanTax-free policy loans used as retirement cash62; $0
State rate while working / in retirementFlat effective rates. Set them apart to test a move.5% / 5%
Itemized deductionsUsed only when larger than the standard deduction$0
Tax rate on pre-tax balancesHaircut applied to pre-tax money in the after-tax value30%
Future federal tax lawReplaces the seven bracket rates and two capital gains rates from a chosen year. Four presets.Off

5. How the model calculates

The engine runs one loop per year of age. Balances carry from one year to the next. Amounts are computed in nominal dollars and converted for display.

5.1 Indexing

Bracket thresholds, the standard deduction, contribution limits, the Social Security wage base, the QBI thresholds and IRMAA tiers all grow at the inflation input from their 2026 values. Three thresholds stay fixed in nominal dollars, as in current law: the net investment income tax threshold, the Additional Medicare Tax threshold, and the Social Security benefit taxation thresholds.12,13,14

5.2 Working years

  1. Income grows from the starting value at the income growth rate.
  2. Contributions are set from the limits in Section 6. For W-2 wages above the Roth catch-up threshold, the catch-up portion goes to the Roth 401(k).3,4
  3. Any Roth conversion scheduled for that age is applied at the start of the year. Its tax is paid from the brokerage account.
  4. Federal, payroll and state tax are computed (5.5).
  5. In expenses mode, income minus tax, contributions and living expenses is swept into the brokerage account. If the result is negative, the gap and the tax on the realized gain are drawn from brokerage.
  6. Balances grow at the pre-retirement return, then the year's contributions are added.

5.3 Retirement years

  1. The spending need is core living expenses for the phase, plus housing, healthcare, long-term care and one-off items.
  2. Fixed cash sources are counted first: Social Security, brokerage dividends, required minimum distributions, HSA medical withdrawals and LIRP loans.
  3. A solver finds the extra withdrawal that leaves exactly enough after tax, penalties and IRMAA to meet the need. It uses bisection on the withdrawal amount and allocates it across accounts in the chosen order.
  4. If fixed sources exceed the need, the surplus is reinvested in brokerage. If every account is empty and the need is unmet, the year is flagged as a shortfall.
  5. Balances grow at the retirement return. Brokerage grows at the return less the dividend yield, because dividends were paid out as cash.

5.4 Required minimum distributions

RMDs start at 73 for people born 1951 to 1959 and at 75 for people born in 1960 or later, and equal the prior balance divided by the Uniform Lifetime Table factor for that age.15 They apply to the pre-tax 401(k) and traditional IRA. Roth accounts have none.

5.5 Tax calculation

ComponentMethod
Ordinary income taxWages, pre-tax withdrawals, conversions and taxable Social Security, less the larger of the standard deduction (plus the age-65 addition) or itemized deductions, through the seven brackets.1,2
Capital gains and qualified dividendsStacked on top of ordinary taxable income at 0%, 15% and 20%.1 Gain on a brokerage withdrawal is the withdrawal times the unrealized-gain share of the account.
Net investment income tax3.8% of the lesser of investment income or income above the threshold.12
Social Security taxationThe provisional income test, with up to 85% of benefits taxable.14
Payroll tax (W-2)6.2% to the wage base, 1.45% on all wages, 0.9% above the Additional Medicare Tax threshold.7,13 HSA payroll contributions are excluded.
Self-employment taxOn 92.35% of profit: 12.4% to the wage base, 2.9% on all, 0.9% above the threshold. Half of the first two parts is deducted.16
QBI deduction20% of qualified business income, limited to 20% of taxable income less net capital gain, phased out linearly across the threshold range. The model assumes no employees, so it is zero above the range.10
State taxA flat rate on adjusted gross income excluding taxable Social Security.
IRMAAFrom age 65, Part B and Part D surcharges per person, by tier, using income from two years earlier.6
Early withdrawal penalty10% of pre-tax withdrawals before age 60 and 20% of non-medical HSA withdrawals before 65.

5.6 Roth conversions

The ideal balance is the largest pre-tax balance whose first RMD equals the standard deduction at RMD age, discounted back at the return assumption. This follows the bucket approach in David McKnight's The Power of Zero.17 McKnight's fuller test also keeps provisional income under the Social Security thresholds. The scorecard reports that separately.

Conversions come from the traditional IRA first, then the pre-tax 401(k). IRA basis from nondeductible contributions is recovered pro rata. A backdoor Roth contribution is taxed on the pre-tax share of the whole IRA balance.

5.7 LIRP

Cash value grows at the crediting rate less the cost rate. Premiums are added while working. Loans are treated as tax-free cash that does not enter taxable income, the Social Security test or IRMAA income.

5.8 Social Security

The benefit at 67 is scaled by claiming age: 70% at 62, 75% at 63, 80% at 64, 86.67% at 65, 93.33% at 66, 100% at 67, 108% at 68, 116% at 69 and 124% at 70.18 Benefits rise with the inflation input. The claim-age table reruns the whole scenario at 62, 65, 67 and 70.

5.9 After-tax value

After-tax value equals Roth, HSA, LIRP and brokerage balances, plus pre-tax balances reduced by the chosen rate, less 23.8% of unrealized brokerage gains (20% capital gains plus 3.8% NIIT). It is the basis for scenario comparison, because a dollar in a pre-tax account is not worth a dollar in a Roth.

6. 2026 tax parameters

These values are hard-coded in the LAW object and indexed forward as described in 5.1.

Ordinary income brackets, top of each bracket1,2

RateSingleMarried filing jointly
10%$12,400$24,800
12%$50,400$100,800
22%$105,700$211,400
24%$201,775$403,550
32%$256,225$512,450
35%$640,600$768,700
37%aboveabove

Deductions, capital gains and thresholds

ItemSingleMarried filing jointlyRef.
Standard deduction$16,100$32,2001
Additional deduction at 65, per person$2,050$1,6501
0% capital gains up to taxable income of$49,450$98,9001
15% capital gains up to$545,500$613,7001
NIIT and Additional Medicare Tax threshold (fixed)$200,000$250,00012, 13
Social Security taxation thresholds (fixed)$25,000 / $34,000$32,000 / $44,00014
QBI threshold; phase-in range$201,750; $75,000$403,500; $150,00010

Contribution limits and payroll

Item2026Ref.
401(k) elective deferral$24,5003, 4
Catch-up at 50 and over; at 60 to 63$8,000; $11,2503, 4
Total additions limit, section 415(c)$72,0003, 4
Compensation limit, section 401(a)(17)$360,0003, 4
Roth catch-up wage threshold (prior-year FICA wages)$150,0004
IRA limit; catch-up at 50$7,500; $1,1009
SIMPLE IRA, employers with 25 or fewer employees; catch-up at 50; at 60 to 63$18,100; $3,850; $5,2509, 11
HSA self-only; family; catch-up at 55$4,400; $8,750; $1,0005
Social Security wage base$184,5003, 7

Medicare IRMAA, monthly surcharge per person6

Income above (single)Income above (joint)Part BPart DCombined
$109,000$218,000$81.20$14.50$95.70
$137,000$274,000$202.90$37.50$240.40
$171,000$342,000$324.60$60.40$385.00
$205,000$410,000$446.30$83.30$529.60
$500,000$750,000$487.00$91.00$578.00

The model counts the surcharge only. The standard Part B premium ($202.90 a month in 2026) is treated as a living expense.

7. Outputs reference

Headline tiles

TileDefinition
Portfolio at retirementSum of all buckets at the start of the retirement year, with its after-tax value
Portfolio at end ageSum at the end of the final year, with after-tax value and the gap against the baseline
Lifetime taxesAll tax components summed over the plan, split into working and retired years
Tax bill this yearFirst-year total, effective rate on total income, and federal marginal bracket
Largest RMDThe peak required distribution and the age it occurs
Plan durabilityFunded to the end age, or the age the money runs out

Flags

Plain-language notes generated from the active scenario. Green is informational, amber is a point to review, red is a problem such as a shortfall, a penalty, or an LIRP loan the cash value cannot support.

Power of Zero scorecard

MeasureDefinition
Retirement years at 0% federal taxCount of retirement years with federal income and capital gains tax under $1 and no shortfall
Tax-deferred bucket at RMD agePre-tax balance compared with the ideal balance
Tax-free share of retirement cashRoth and LIRP withdrawals, HSA withdrawals and untaxed Social Security, as a share of all retirement cash
Social Security that is taxedTaxable benefits divided by total benefits in retirement
Taxable bucket at retirementBrokerage balance compared with six months of spending
LIRP bucketLoans taken, premiums paid, and cash value left at the end

Charts and tables

8. Example scenarios

The five examples share one person: age 50, single, $1,000,000 salary growing 3%, retiring at 62, spending $400,000 while working and $300,000 in retirement, with the default balances in Section 4. Results below are in today's dollars, from the build of November 12, 2026.

ScenarioWhat differs from BaselineLifetime taxesAfter-tax value at 95
BaselineNo conversions, taxable-first withdrawals$7.76M$5.61M
Roth conversionsFill the 24% bracket from 62 to 74$7.90M$5.92M
Higher rates 20312017-style bracket rates from 2031$8.05M$5.14M
Power of ZeroShift to the ideal balance by 74; $50,000 LIRP premium for 12 years; $25,000 yearly loans from 62$7.35M$5.75M
Self-employedSchedule C; Solo 401(k) at maximum; $150,000 cash balance plan; $24,000 health premiums$8.07M$5.45M

Readings

9. Validation

The tax engine was tested against hand calculations before release. All cases matched to the dollar.

CaseChecked valueResult
Single, $1M wages, $24,500 deferral, $4,400 HSAFederal ordinary tax$309,307.25
SamePayroll tax$33,035.60
Joint, $300,000 wages, $50,000 qualified dividendsOrdinary tax; capital gains plus NIIT$49,468; $9,400
Single retiree at 70: $60,000 Social Security, $40,000 IRA, $30,000 dividendsTaxable Social Security; ordinary tax$51,000; $10,739
Single, $60,000 long-term gain onlyCapital gains tax (0% band)$0
Self-employed, $1M profit, Solo 401(k)Self-employment tax; employer contribution$56,171; $47,500
Self-employed, $120,000 profit, SEP-IRASEP contribution; QBI deduction$22,304.45; $14,623.56
Retirement year cash identitySources minus tax, spending and surplus$0

Not validated by hand: the LIRP projection, and any comparison against commercial tax software or a filed return. The version on usaretirement.life was transferred with a checksum match to the tested file, and later edits by the hosting tool were confirmed to leave the calculation code unchanged.

10. Limitations

Tax rules not modeled

Simplifications

Dated parameters. All tax values are for 2026. Figures for 2027 are not loaded; later years are 2026 values grown at the inflation input. The model should be updated each year (Section 11).

11. Maintenance and yearly update

Where things live

ItemLocation
The whole appOne file, public/modeler.html, in the Lovable project "Retirement Account Modeler"
Tax parametersThe LAW object at the top of the first script block
Default inputs and examplesDEFAULTS and examples()
Tax and projection logiccomputeTax() and simulate()
Host page, deep-link sync, metadatasrc/routes/index.tsx
Legal, contact, glossary pagessrc/routes/
Saved scenarios in the browserLocal storage key ram.v5. Raise the version when input names change, so old saves are ignored.

Yearly update checklist

  1. Set baseYear to the new tax year.
  2. Update brackets, standard deduction, additional deduction and capital gains thresholds from the IRS inflation revenue procedure (published each autumn).
  3. Update 401(k), IRA, SIMPLE, compensation and total additions limits and the Roth catch-up wage threshold from the IRS cost-of-living notice.
  4. Update HSA limits from the IRS HSA revenue procedure (published each spring).
  5. Update the Social Security wage base and the maximum benefit hint from the SSA announcement.
  6. Update IRMAA tiers and surcharges from the CMS fact sheet.
  7. Update QBI thresholds and ranges.
  8. Rerun the hand-calculated cases in Section 9 with the new values before publishing.
  9. Update the Assumptions tab text, this manual and the legal page date.

Editing safely

Ask the hosting tool for small, targeted edits and require confirmation that the script blocks are unchanged. A rewrite of the file can silently alter tax logic.

12. Glossary

TermMeaning
Backdoor RothA nondeductible traditional IRA contribution converted to Roth, used when income is too high for a direct Roth contribution
Cash balance planA defined benefit plan that allows large deductible contributions, often paired with a 401(k)
Effective rateTotal tax divided by total income for the year
IRMAAIncome-related monthly adjustment amount, a surcharge on Medicare Part B and Part D premiums
LIRPLife insurance retirement plan, a cash value policy funded for tax-free loans in retirement
Mega backdoor RothAfter-tax 401(k) contributions converted to Roth, within the total additions limit
NIITNet investment income tax of 3.8%
Pro-rata ruleIRA conversions are taxed in proportion to the pre-tax share of all traditional IRA money
Provisional incomeOther income plus half of Social Security, used to test how much of the benefit is taxable
QBI deductionSection 199A deduction of up to 20% of qualified business income
RMDRequired minimum distribution from pre-tax retirement accounts
Today's dollarsAmounts with inflation removed, also called real dollars

13. References

Sources marked checked were opened and read while the model was built in November 2026. Sources marked standard are the governing statute or agency publication, cited from general knowledge and not reopened; confirm them before relying on a figure.

  1. Tax Foundation. "2026 Tax Brackets." Reports IRS Revenue Procedure 2025-32. https://taxfoundation.org/data/all/federal/2026-tax-brackets/ checked
  2. Internal Revenue Service. Revenue Procedure 2025-32, inflation adjustments for tax year 2026. https://www.eitc.irs.gov/pub/irs-drop/rp-25-32.pdf checked
  3. Venable LLP. "2026 IRS Dollar Limits on Benefits, Contributions, and Recognizable Compensation." https://www.venable.com/insights/publications/2025/11/2026-irs-dollar-limits-on-benefits-contributions checked
  4. Foley & Lardner LLP. "Better Late Than Never: IRS Announces 2026 Retirement Plan Cost-of-Living Adjustments." https://www.foley.com/insights/publications/2025/11/better-late-than-never-irs-announces-2026-retirement-plan-cost-of-living-adjustm/ checked
  5. Internal Revenue Service. Revenue Procedure 2025-19, 2026 HSA and HDHP amounts. https://www.irs.gov/pub/irs-drop/rp-25-19.pdf. Summarized at https://www.ifebp.org/detail-pages/news/2025/05/01/irs-releases-2026-hsa--hdhp--and-hra-inflation-adjusted-amounts checked
  6. ustax.tools. "2026 IRMAA Brackets: The Full Medicare Part B & D Chart." Built from the CMS 2026 Medicare Parts A & B premiums fact sheet of November 14, 2025 and SSA tables. https://ustax.tools/irmaa-brackets-2026/ checked
  7. Journal of Accountancy. "Social Security wage base and COLA announced for 2026." https://www.journalofaccountancy.com/news/2025/oct/social-security-wage-base-and-cola-announced-for-2026/ checked
  8. Kiplinger. "Medicare Premiums 2026: IRMAA Brackets and Surcharges for Parts B and D." https://www.kiplinger.com/retirement/medicare/medicare-premiums-2026-irmaa-brackets-and-surcharges-for-parts-b-and-d checked
  9. ustax.tools. "401(k) and IRA Contribution Limits for 2026." https://ustax.tools/retirement-contribution-limits-2026/ checked
  10. CountryTaxCalc. "QBI Deduction Guide 2026." Reports Rev. Proc. 2025-32 section 4.26 and the 2025 budget law changes to section 199A. https://www.countrytaxcalc.com/tax-guides/usa/qbi-deduction-guide-2026/ checked
  11. Vision Retirement. "401(k) and IRAs: 2026 Contribution Limits." SIMPLE IRA limits by employer size. https://www.visionretirement.com/articles/investing/ways-to-boost-your-retirement-savings checked
  12. Internal Revenue Code section 1411, net investment income tax. standard
  13. Internal Revenue Code section 3101(b)(2), Additional Medicare Tax. standard
  14. Internal Revenue Code section 86, taxation of Social Security benefits. standard
  15. Internal Revenue Service. Publication 590-B, Distributions from Individual Retirement Arrangements, Uniform Lifetime Table; SECURE 2.0 Act of 2022, section 107, RMD starting ages. standard
  16. Internal Revenue Code sections 1401 and 164(f), self-employment tax and the deduction for half of it; IRS Schedule SE. standard
  17. McKnight, David. The Power of Zero: How to Get to the 0% Tax Bracket and Transform Your Retirement. The model's bucket rules are a simplified reading of this book and were not checked against the text. standard
  18. Social Security Administration. Early and delayed retirement adjustment schedule for a full retirement age of 67. standard

References to tax authorities, Social Security, David McKnight, Power of Zero or financial products are for educational context and do not imply affiliation or endorsement. © 2026 Tomas Aparicio.