every model spec’d & versioned · Concordance-tested changelog →

Reference implementation

What a white-label build on the component kit looks like: the same fictional household as /demo, but interactive — switch the theme (the sample brand override goes through the same config-time WCAG AA gate every tenant theme faces) and toggle between a consumer-lite view and the full advisor view. Every pixel inside the frame below is drawn by kit components from theme tokens; the engines run server-side.

The Rivera household is fictional, and the assumptions are labeled illustrative defaults — not a market view, not a recommendation, not advice.

The Rivera household (fictional)

Projected net worth ends at $2.5M on the deterministic path; 65.4% of 1,000 simulations stay funded over the fixed horizon, 79.3% when simulated lifespans are accounted for.

Projected household net worth by year$0$1M$2M203020352040204520502055Simulated net worth percentile bands$0$2M$4M$6M203020352040204520502055

Roth conversion ladder

Objective: maximize final-year household net worth net of estimated IRMAA Part B surcharges across candidate Roth conversion schedules, each run through the full projection (score = ending net worth − cumulative estimated IRMAA, both stated per alternative)

Baseline: no Roth conversions over the horizon

  1. No conversionstop-ranked
    baseline
  2. Convert $60,000/yr for 5 years
    −$39K vs baseline · −$18K tax
    • Convert $60,000 from traditional to Roth in 2027.
    • Convert $60,000 from traditional to Roth in 2028.
    • Convert $60,000 from traditional to Roth in 2029.
    • Convert $60,000 from traditional to Roth in 2030.
    • Convert $60,000 from traditional to Roth in 2031.
  3. Convert $120,000/yr for 5 years
    −$54K vs baseline · −$220K tax
    • Convert $120,000 from traditional to Roth in 2027.
    • Convert $120,000 from traditional to Roth in 2028.
    • Convert $120,000 from traditional to Roth in 2029.
    • Convert $120,000 from traditional to Roth in 2030.
    • Convert $120,000 from traditional to Roth in 2031.
  4. Convert $250,000/yr for 4 years
    −$365K vs baseline · −$301K tax
    • Convert $250,000 from traditional to Roth in 2027.
    • Convert $250,000 from traditional to Roth in 2028.
    • Convert $250,000 from traditional to Roth in 2029.
    • Convert $250,000 from traditional to Roth in 2030.
What this ranking does and does not consider (14)
  • ending net worth: $2,501,486; lifetime tax: $664,856
  • estimated IRMAA surcharges: $0 across 56 enrollee-years (max tier 0); score = ending net worth − surcharges; IRMAA delta vs baseline: $0
  • IRMAA estimate (v0.2): CY2026 Part B thresholds and premiums (cms.partb-premium-irmaa.2026) held constant across the horizon — future brackets are unpublished and MAGI thresholds index annually; MAGI proxied from projection rows (gross income + RMD + conversion) with the SSA two-year lookback; surcharges are NOT fed back into the projection's cash flows; 2 Medicare-age years skipped (two-year lookback precedes the horizon)
  • candidate schedules are caller-specified; bracket-fill optimization is not yet modeled
  • projection: RMDs computed per owner at each owner's age (Uniform Lifetime Table)
  • projection: deficits draw cash → taxable → traditional → roth; traditional draws are taxed the following year
  • projection: realized gains on taxable draws are treated as long-term (holding period not tracked) and taxed the following year
  • projection: social_security streams with a computed-benefit block use the ssa-pia model (eligibility-year dollars, no COLA)
  • projection: state tax treats realized gains as ordinary income (no state preferential rates modeled)
  • projection: state taxable income approximated by federal taxable income
  • ending net worth: $2,462,944; lifetime tax: $646,396
  • ending net worth: $2,447,621; lifetime tax: $444,719
  • ending net worth: $2,136,707; lifetime tax: $363,653
  • estimated IRMAA surcharges: $13,637 across 56 enrollee-years (max tier 2); score = ending net worth − surcharges; IRMAA delta vs baseline: $13,637

Assumptions: profile illustrative-6-3-3@1.0.0 (default; Worthune illustration for demos and documentation — not a market view, not a recommendation. Institutions supply their own profiles.)

Verifiable record: sha256 af5481b5ff40a85f6048497056c6b0f5036ac88fa8ef2cdba0603cc16364851b — recompute from the stored response to prove this decision is unaltered

Pension election

Objective: maximize the actuarial expected present value of the pension election at the caller's discount rate (scores in USD EPV; mortality from the NCHS 2024 period table)

Baseline: the plan's single-life quote — every option priced on the same lives and rate

  1. Lump sum: $420,000 at 65 (EPV $420,000)top-ranked
    +$80K vs baseline
    • Elect the $420,000 lump sum at age 65 (in 2027).
  2. Single-life annuity: $2,400/mo (EPV $340,370)
    no change vs baseline
    • Commence the single-life annuity of $2,400/mo at age 65 (in 2027).
  3. Joint & 100% survivor: $1,850/mo (EPV $328,553)
    −$12K vs baseline
    • Commence the joint & 100% survivor annuity of $1,850/mo at age 65 (in 2027).
  4. Joint & 50% survivor: $2,050/mo (EPV $327,402)
    −$13K vs baseline
    • Commence the joint & 50% survivor annuity of $2,050/mo at age 65 (in 2027).
What this ranking does and does not consider (13)
  • expected present value: $420,000
  • delta vs single-life: $79,630 (EPV, not a projected net-worth path)
  • expected present value: $340,370
  • delta vs single-life: $0 (EPV, not a projected net-worth path)
  • EPVs at a 5% caller-supplied discount rate, valued at 2027 (participant age 65); payments annual, survival measured at year start
  • mortality from the NCHS 2024 PERIOD life table (nchs.us-life-table.2024): it understates future longevity improvement, which systematically understates annuity EPVs relative to the lump sum
  • pre-tax comparison: annuity income taxation vs lump-sum rollover treatment is not modeled
  • joint-survivor EPVs assume the two lives are independent
  • lump sums are conditioned on the participant surviving to commencement; pre-commencement death benefits are not modeled
  • expected present value: $328,553
  • delta vs single-life: $-11,818 (EPV, not a projected net-worth path)
  • expected present value: $327,402
  • delta vs single-life: $-12,968 (EPV, not a projected net-worth path)

Assumptions: profile illustrative-6-3-3@1.0.0 (default; Worthune illustration for demos and documentation — not a market view, not a recommendation. Institutions supply their own profiles.)

Verifiable record: sha256 246854a2ad51e0d1c7493442479ec1e2370e0c7a7509430d41b361964e35bd2a — recompute from the stored response to prove this decision is unaltered

Social Security claiming

Objective: maximize final-year household net worth across joint claim-age combinations, each run through the full projection (scores in ending-net-worth USD)

Baseline: current claim plan: alex at 67, sam at 67

  1. Claim: alex at 67, sam at 67 (current plan)top-ranked
    baseline
  2. Claim: alex at 67, sam at 70
    −$38K vs baseline · +$14K tax
    • Member sam claims Social Security at 70 (in 2034).
  3. Claim: alex at 67, sam at 62
    −$42K vs baseline · −$28K tax
    • Member sam claims Social Security at 62 (in 2026).
  4. Claim: alex at 70, sam at 67
    −$90K vs baseline · +$33K tax
    • Member alex claims Social Security at 70 (in 2032).
  5. Claim: alex at 70, sam at 62
    −$116K vs baseline · +$1,973 tax
    • Member alex claims Social Security at 70 (in 2032).
    • Member sam claims Social Security at 62 (in 2026).
  6. Claim: alex at 70, sam at 70
    −$137K vs baseline · +$49K tax
    • Member alex claims Social Security at 70 (in 2032).
    • Member sam claims Social Security at 70 (in 2034).
  7. Claim: alex at 62, sam at 67
    −$404K vs baseline · −$49K tax
    • Member alex claims Social Security at 62 (in 2024).
  8. Claim: alex at 62, sam at 70
    −$454K vs baseline · −$30K tax
    • Member alex claims Social Security at 62 (in 2024).
    • Member sam claims Social Security at 70 (in 2034).
  9. Claim: alex at 62, sam at 62
    −$459K vs baseline · −$73K tax
    • Member alex claims Social Security at 62 (in 2024).
    • Member sam claims Social Security at 62 (in 2026).
What this ranking does and does not consider (17)
  • ending net worth: $2,501,486
  • the deterministic projection has NO mortality: members do not die, so longevity-insurance value beyond the horizon and survivor benefits are not captured — this ranking holds under this horizon and these assumptions only
  • pension elections are handled by the pension-election strategy, which prices options on the NCHS mortality table
  • projection: RMDs computed per owner at each owner's age (Uniform Lifetime Table)
  • projection: deficits draw cash → taxable → traditional → roth; traditional draws are taxed the following year
  • projection: realized gains on taxable draws are treated as long-term (holding period not tracked) and taxed the following year
  • projection: social_security streams with a computed-benefit block use the ssa-pia model (eligibility-year dollars, no COLA)
  • projection: state tax treats realized gains as ordinary income (no state preferential rates modeled)
  • projection: state taxable income approximated by federal taxable income
  • ending net worth: $2,463,167
  • ending net worth: $2,459,675
  • ending net worth: $2,411,761
  • ending net worth: $2,385,519
  • ending net worth: $2,364,422
  • ending net worth: $2,097,769
  • ending net worth: $2,047,008
  • ending net worth: $2,042,914

Assumptions: profile illustrative-6-3-3@1.0.0 (default; Worthune illustration for demos and documentation — not a market view, not a recommendation. Institutions supply their own profiles.)

Verifiable record: sha256 eadd9340704563b4d7cb77e6524b01c446ca9f53f7233cec2b405a22e8d0ce92 — recompute from the stored response to prove this decision is unaltered

Embed these widgets anywhere

The same surfaces are embeddable on any site — no React required — with the same loader that serves the calculator embeds:

<div data-worthune-embed="household-overview" data-theme="dark"></div>
<script async src="https://worthune.com/embed.js"></script>

Or as custom elements, if your stack prefers components — same frames, reactive attributes:

<script async src="https://worthune.com/elements.js"></script>
<worthune-household widget="monte-carlo" theme="dark"></worthune-household>
<worthune-calculator model="fire" input-current-age="35"></worthune-calculator>

Widgets: household-overview, household-projection, household-monte-carlo, household-decisions. Frames size themselves to their content. Embeds currently show the seeded fictional household — the evaluation surface; tenant-bound embeds arrive with white-label configuration.