Methodology · Taxes

The whole federal return. Not a bracket lookup.

The federal engine is built from the IRS source tables for the current tax year and computes the whole return, not just a marginal rate. State tax gets the same discipline in all 50 states + DC — each state's own brackets and its major retirement exclusions, every rate cited to the government that levies it — with the local layers that actually bite on top.

Federal

The federal return, end to end.

1.1

Every line, not a single total

AGI, then deductions (standard, or itemized: SALT with its cap and phase-down, mortgage interest under the acquisition-debt cap for the loan's origination year, charitable, medical, casualty), then ordinary brackets, then preferential-rate stacking for long-term gains and qualified dividends, then NIIT, Additional Medicare, and AMT. Every component comes back — marginal rate, effective rate, and each line. All five filing statuses. Payroll taxes are modeled too: Social Security 6.2% on the wage base, Medicare 1.45%, and the 0.9% Additional Medicare Tax, alongside the 3.8% Net Investment Income Tax on investment income.

1.2

Tax years

Federal ordinary and capital-gains brackets cover the current tax year and the two before it. The rest of the return — AMT, deductions, equity compensation, Roth conversion analysis — and every state table are built for the current tax year. Projections that run past the last legislated year hold that year's law fixed in real terms; they do not predict future legislation.

1.3

AMT

Form 6251 with the 26%/28% tiers, the phased-out exemption, and the Form 8801 credit carryforward. Long-term capital gains are folded into the AMT base at ordinary rates rather than keeping their preferential treatment (Form 6251 Part III), so in years with large long-term gains the AMT figure is an upper bound.

Equity comp & planning moves

The cases that break generic calculators.

2.1

Equity compensation

ISO exercises (the bargain element as an AMT preference when exercised and held, ordinary income on a disqualifying disposition), NQSO exercises, and RSU vests (FICA-subject supplemental W-2 income) are modeled explicitly.

2.2

Roth conversions and safe harbor

Roth conversion analysis for a single year: the marginal cost of the converted slice, federal plus state and local, filling to a target bracket, the resulting RMD reduction, and a convert-now vs leave-in break-even that accounts for the early-withdrawal penalty. Also safe-harbor and underpayment estimation with suggested quarterly payments, and withdrawal tax by account type.

2.3

Required minimum distributions

SECURE 2.0 start ages by birth year, the Uniform Lifetime, Joint and Last Survivor, and single-life tables, multi-IRA aggregation, the shortfall penalty, and multi-year projected RMD schedules. The joint table applies when the owner's sole beneficiary is a spouse more than ten years younger, and it takes both ages.

State & local

All 50 states + DC, on their own brackets.

3.1

Coverage

Resident returns on each state's own schedule — graduated, flat, or none — with the retirement exclusions (Social Security, pension, IRA) each state actually applies, every rate cited to the state's own revenue department with the date it was verified. Nine states levy no broad income tax. Local layers are modeled where they bite: New York City and Yonkers, every Maryland county, Philadelphia, Detroit, the four major Ohio cities, St. Louis, Kansas City, Louisville, Birmingham, and Wilmington — the earned-income-only ones correctly leave a retiree's IRA withdrawal untaxed. An unlisted Ohio municipality comes back as an explicit unsupported result rather than a silent zero.

What state tax leaves out

The edges of the state engine.

  1. 4.1Every return is computed as a full-year resident return; there is no input for nonresident or part-year status.
  2. 4.2Most state credits (EITC supplements, child care, senior credits) are not modeled, nor is New York's high-earner tax-benefit recapture.
  3. 4.3An Ohio resident's credit for tax paid to a work city is not applied, so that figure is a before-credit ceiling.
  4. 4.4The occupational taxes (Louisville, Birmingham) assume the work is performed where you live.
  5. 4.5Washington's separate 7% tax on long-term capital gains is not modeled; Washington returns zero.

Where the engine stops.

The methodology overview lists every known limitation, with the capital-market defaults and how the engine is validated.