@taxwallet/framework

The engine that
calculates the return.

Underneath every TaxWallet return is one deterministic calculation framework. It models the 1040 and its supporting forms as a dependency graph, recomputes on every change, and validates as it goes — so the number on the screen is the number that gets filed.

Form dependency graph

recompute
W-2
Sch C
Sch SE
QBI
AGI
1040
Change one box, downstream re-derivesauto

How it calculates.

The framework treats a tax return the way a spreadsheet treats a sheet — a web of cells that know what they depend on. Touch one input and everything downstream re-derives in the correct order.

Deterministic by design

Same inputs, same return — every time. The framework is a pure calculation layer with no hidden state, so a return computes identically on a phone, a laptop, or our servers.

Form graph, not a wizard

Forms declare their dependencies. Change a W-2 box and only the lines that depend on it recalculate — Schedule SE, QBI, the 1040 totals — in the right order, automatically.

Recompute on every keystroke

The whole return re-derives as you type. There is no "calculate" button because the numbers are never stale.

Validation built in

Each line carries its own rules. Out-of-range entries, missing dependents, and mismatched identifiers surface as you go — not after the IRS rejects them.

A wizard asks questions. An engine computes answers.

Most consumer software walks you down a branching script and tots up the result at the end. A real engine holds the whole return in memory and re-derives it continuously.

A question-and-answer wizard
  • Branches you down a script; miss a branch and the number is wrong
  • Recalculates only when you hit a button
  • Hides the math behind a friendly interview
  • Errors surface after submission — or after an IRS reject
The TaxWallet calculation engine
  • Models the return as a dependency graph — no branch to miss
  • Recomputes on every keystroke; numbers are never stale
  • Exposes the same deterministic math on phone, laptop, and server
  • Validates continuously, so the return is e-file-ready as you go

The pipeline

From document to signable return.

01

Intake

Documents land as structured records — typed or OCR-extracted. Either way the framework sees the same shape.

02

Compute

The form graph resolves every dependent line, applies current-year tax law, and produces a complete, signable return.

03

Validate

Business rules and IRS schema checks run continuously, so a return is e-file-ready the moment the math settles.

Federal coverage is complete. State income tax is on the roadmap.

We’d rather tell you exactly where the engine stands than imply coverage we don’t have. The federal 1040 path — income, business, credits, and current-year law — is in production and has accepted tens of thousands of returns.

Supported forms.

Federal coverage for the forms that make up the overwhelming majority of individual and small-business returns — including the current-year provisions most software is still catching up on.

1040Core

U.S. Individual Income Tax Return

Income
W-21099-NEC1099-MISC1099-INT1099-K1099-C
Business
Schedule CSchedule SEQBI
New law
OBBA 2025+
Credits
Form 8962
Penalties
Form 2210

Adding More… Every day

New forms and current-year provisions ship continuously.

One engine.
Every return.

See the calculation framework run on a real return — from a blank 1040 to a validated, e-file-ready filing in a single session.