## What this models
Modeling a change of state of residence so future tax estimates use the new state's income-tax
treatment from the move year onward. People often explore this to see the effect of moving to a
lower- or no-income-tax state (for example Florida, Texas, Nevada, Washington, or Arizona) in or
around retirement.
## Maps to module(s)
- `tax_timelines_v1` — set a **state residence timeline** entry beginning in the move year. Optionally
set a **filing status timeline** if the move coincides with a filing-status change (marriage,
widowhood). State income tax is then modeled at the new state's rate from that year forward.
## Information needed
- **Target state** (two-letter code, e.g., `FL`, `AZ`, `TX`).
- **Move year** — the calendar year the new residency begins; must fall within the planning horizon.
- (Optional) a **local/city tax rate** if the user wants to model one.
## Defaults & assumptions
- If the move year is not given, ask for it — do not assume one.
- Filing status is unchanged unless the user explicitly says it changes.
- The residence timeline runs from the move year to the end of the planning horizon unless the user
describes a later move back.
## Prerequisites
- A completed baseline plan (needed for the planning calendar and tax estimates).
## How to summarize to the user
"Move to {STATE} starting {YEAR}: your plan models {STATE} state income tax from {YEAR} onward."
Educational content only—not personalized investment, tax, or legal advice.