← StateSplit

StateSplit

by Spargur Tax & Accounting

General information, not tax or legal advice for your situation. Domicile depends on all the facts.

Start here

  1. In Settings, name one or two people. Each person has a separate day and workday log.
  2. Enter domicile at January 1, every later change, homes and their availability, actual trips and planned trips. Physical location is not domicile. Overlapping travel dates can count in both states.
  3. Import sales and open lots from CSV, XLSX or lot-level TXF. Select brokerage and person, review column mapping, then confirm rows. Reconcile imported proceeds, basis and wash adjustments with the brokerage statement.
  4. Enter other income, receipt dates and workdays. Annual totals use a clearly marked day-based fallback. Enter K-1 and special state-source amounts manually.
  5. Use the gain planner for cash scenarios. Whole-year statutory residency is checked before Florida windows. No trade is placed.
  6. Review state portions and warnings, print or save PDF, and export CSV/XLSX for your preparer.

Privacy, backup and settings

Data is saved in IndexedDB on this browser and device. No account, analytics, third-party libraries, automatic uploads or background location tracking. Location is requested only when you tap “I’m here today,” and you confirm the state yourself.

Settings include System/Light/Dark, six accents, six patterns, six solid backgrounds, a device-only photo, three text sizes, English/Spanish, default state and household names. Background and document photos are resized to at most 1600 pixels and included in encrypted backups but excluded from handoffs. Keep original evidence separately.

Encrypted JSON backups use AES-GCM with a PBKDF2-SHA256 key (310,000 iterations). Use a unique passphrase of at least 10 characters. There is no recovery key. Restore shows counts and merges by stable record ID without replacing existing records. A changed record with the same ID stops the merge and reports a conflict. Restore into a new profile to preserve the complete backup, including settings and mappings. A backup is not synchronization. Deletion offers one-step undo until the next deletion or reload.

Storage errors are announced. When storage cannot be opened, save actions fail visibly. Export regularly before clearing browser data. The installed app works offline after its first successful online load; external sources, other apps and the portal need connectivity.

Import support and limits

Profiles cover Fidelity, Schwab / former TD Ameritrade, Vanguard, Merrill Edge, Morgan Stanley / E*TRADE, Wells Fargo, Edward Jones, Raymond James, Interactive Brokers, Robinhood and Generic. All use a reviewable alias-based table importer with a saved mapping per brokerage and sales/open-lot mode. These are synthetic-tested profiles, not certified parsers for every historical brokerage export. Choose the header row below any preamble; remove subtotal rows and footers. Choose the header row in the mapping dialog; its position and column mapping are saved per brokerage and sales/open-lot mode.

XLSX reads the first numerically named worksheet, shared strings and inline strings; compressed and stored ZIP entries are supported by current browsers. Dates must be ISO YYYY-MM-DD or MM/DD/YYYY text: Standard Excel 1900-system date serials are accepted; 1904-system workbooks and “Various” acquisitions require correction or CSV text dates. Formulas, encrypted workbooks and macros are not supported. TXF accepts detailed N321–N324 records, with two dates and two amounts; quantity defaults to one because TXF does not have a standard quantity field. Unsupported records produce row errors. TXF cannot preserve all 1099-B fields: verify and edit quantity, account, covered status and wash adjustments.

Files are limited to 2 MB. Raw files are not saved. Full account numbers are reduced to four trailing characters before storage. Do not enter SSNs or identifying numbers in notes. Exact duplicate rows are skipped; economically identical legitimate lots require a distinguishing description before confirmation.

Rules that require preparer review

Rules are maintained in data/rules.js, with source URLs and verification dates. Settings allow local overrides; overrides always remain “needs review.” General rules do not encode every state’s exceptions, reciprocity, business apportionment, convenience-of-employer rules, or taxability adjustments. Worksheet state portions are claims before credits and subtractions, not state tax amounts.

Minnesota: 183 days plus a year-round abode can create statutory residency. Whole-year treatment is applied only with full-year abode availability; partial-year abodes and moves are flagged. New York: 184 days and substantially-all-year permanent abode; current audit guidance uses more than 10 months (not the older 11-month policy). The app only screens this test and requires review. California: nine-month presumption and conditional safe harbors require a facts-and-circumstances review. Six months alone does not establish a safe harbor.

Other candidate 183-day tests are marked unverified and do not create a final statutory result. All states can be logged, but most rules still need state-specific verification before production use. Social Security treatment is marked for review except Florida’s no-tax status and California’s exemption. Rental and real-estate gains preserve property-state source plus resident claims; installment sales and K-1s need review. Pensions/IRAs use residence; annuity qualification under 4 U.S.C. 114 must be confirmed.

Federal 2025 and 2026 0/15/20% thresholds are included. 2027 thresholds were not verified and are intentionally blank. Planner values and partial-lot quantities are estimates; prices, trading restrictions, wash sales across accounts and transaction costs require review. Florida domicile windows do not guarantee exemption from another state.

Minnesota residency · New York audit guidance · California Pub. 1031 · 2026 federal brackets

App connections and portal blocker

Selected trips export to Trips using swfl-apps/1 link fragments up to 6,000 encoded characters, then a JSON download. Dates also export as .ics calendar files. StateSplit accepts only event and record items, with a preview and unchecked selections; events become planned trips after the person and state are confirmed, and records become domicile-evidence references. Incoming fragments are removed immediately, even when invalid. No import runs without confirmation.

Live portal handoff is disabled. The supplied reference/portal/app-handoff.ts and books-imports.ts do not include statesplit or residency. The app previews/downloads a proposed summary with allocation totals and separate person day counts, excluding photos and accounts. Claude must add and approve the receiving schema and app registration before enabling the URL handoff. Do not send this proposed file as if the existing portal accepts it.

Build, test and deploy later

node tools/samples.js
npm test
npm run build
npm start

Open http://127.0.0.1:4173. Build output is dist/. No runtime dependencies. Node 22+ recommended. Set APP_VERSION to a new numeric semantic version for each release; APK_VERSION is optional. The build stamps the HTML version, version.json and service-worker cache together; Git is not required. Check for updates on load, focus and every 30 minutes. “Refresh” activates a waiting worker before reloading. An APK update links to the all-apps page.

Claude reviews and deploys to Vercel as a static site, with build command npm run build and output directory dist. No backend, environment secrets, database migrations or functions are required. This task does not deploy, commit or push.

Guía breve en español

Información general, no asesoría fiscal ni legal para su situación. El domicilio depende de todos los hechos.

Configure el hogar, registre cambios de domicilio, viviendas, viajes y días trabajados por separado para cada persona. Importe ventas o lotes abiertos y revise columnas y totales antes de confirmar. La ubicación física no cambia el domicilio. Una residencia por norma legal puede permitir que un estado grave todo el año aunque venda en Florida.

Guarde copias cifradas con una contraseña de al menos 10 caracteres. No hay recuperación de contraseña. La restauración combina registros y conserva los existentes; las fotos se incluyen en las copias cifradas y se excluyen de los envíos. Las normas no verificadas y las asignaciones especiales requieren revisión del preparador. El envío al portal está deshabilitado hasta ampliar su contrato de importación. Los límites federales de 2027 están pendientes.

Prepared files / Archivos preparados

Use Income → “Import a prepared file”, drop a file, or open a #swfl-import= link containing base64url UTF-8 JSON. All additions go to the open profile, whose name appears in the preview. Review counts, duplicates, and each row; untick anything unwanted, then confirm. Data updates immediately. Undo removes the imported records while retaining later edits and additions; dependent records must be removed first. No reminders are stored by StateSplit.

Claude: generate format: "statesplit-import/1", version: 1, a descriptive from label, and arrays named moves, trips, homes, work, sales, lots, income, evidence, checkins. Include empty arrays. Optional business arrays are activities, businessTrips, travelers, tripDays, expenses. Use the app’s field names, ISO dates, JSON numbers, two-letter state codes, and only account last four characters. Omit IDs for ordinary records; business records require stable unique IDs because their references use them. Omit person to use the first household person, or use an existing household person ID. Profiles and settings are not changed by a prepared import.

Complete synthetic example · JSON Schema · W-2 state wage boxes · Vehicle & Mileage day/work log · Business travel and travelers

Dates for income are either date or start and end. W-2 box 16 amounts go in income[].stateAmounts, keyed by state, with type: "wages" and federal wages in amount. Explicit wage state amounts take priority over workday estimates; worldwide income still applies during residence. Do not add the same federal wages once for each state.

Other formats

CSV/XLSX and detailed TXF use the existing brokerage importer. US MM/DD/YYYY, ISO YYYY-MM-DD, Excel 1900 serial dates and parentheses for negative numbers are supported. Header-row selection and mapping are saved by source. XLSX uses the first sheet; export each other sheet separately. All brokerage samples are synthetic in examples/brokerages/ (also retained in samples/); additional lower-header CSV/XLSX examples are in examples/.

ICS uses exclusive calendar end dates, preserves written local dates, and requires you to choose the person and state. Recurrence rules must first be expanded by the exporting calendar; unsupported recurrence is rejected rather than silently truncated. Trips handoff examples use exclusive all-day ends; legacy StateSplit handoffs keep their historical inclusive ends. ICS example · Trips handoff.

OFX/QFX/QBO debit transactions import as unconfirmed expenses for a selected existing trip/traveler. Review their date, category, daily business purpose, mixed/personal use and receipt in the travel worksheet; no bank amount becomes deductible automatically. Credits are not expenses. Transactions outside the selected trip dates are rejected for review. OFX · QFX · QBO. KML/GPX dated points become presence days in a user-confirmed state; coordinates alone never infer tax jurisdiction. KML · GPX. Pasted confirmation text extracts ISO/US dates into a planned-trip draft; check every field. Text example. vCard is not applicable: StateSplit has no contact/address-book records.

Every import is local, works offline after installation, deduplicates against existing records and its own batch, and asks before adding. Invalid files leave current data intact. Prepared imports never overwrite records. Stable-ID restore conflicts are reported instead of silently dropping edits.

Profiles / Perfiles

The header switcher opens separate records, settings, backups and exports for each profile. Existing single-household data becomes Profile 1 without removal. The gear button adds, renames and removes profiles, assigns a color, and sets or clears an optional 4–6 digit PIN. PINs use a unique random salt and PBKDF2-SHA256 (100,000 iterations). This is a privacy screen, not encryption; device/browser administrators can access stored data. Reload locks a PIN profile. Keep your encrypted backup passphrase separately.

Removal first prompts you to make an encrypted backup in Settings. Undo removal is available until the app closes. At least one profile must remain. Backups contain only the open profile; old encrypted backups can merge into it or restore into a new profile. Full new-profile restore preserves settings, mappings and receipt photos. No server account or sync link exists in this app.

El selector abre datos y ajustes separados por perfil. El engranaje permite agregar, renombrar, elegir color, eliminar con deshacer y configurar PIN opcional. El PIN es una pantalla de privacidad, no cifrado. Guarde copias cifradas por perfil; restaure en el perfil actual o en uno nuevo. Los archivos preparados y envíos usan el perfil abierto.

Business travel and shared expenses / Viajes de negocio y gastos compartidos

Residency includes an overall worksheet: add named Schedule C businesses, rental properties or a farm; add trips, travelers, daily purpose notes and expenses. Each traveler has a trip-specific role. LLC members/partners/owners and employees require their own business purpose each business day; guests are excluded and contractors/advisors require separate eligibility review. Enter the business traveler’s solo cost when a guest shares a room or car. Store receipt photos locally for all lodging and expenses of $75 or more. The report shows missing purpose notes, receipts and confirmations.

Classify days as TRAVEL (reasonably direct route), WORK (business activity or required presence), STANDBY (between business days with an impractical return home), or PERSONAL. No unlogged day is assumed business. Travel and standby do not automatically become wage workdays: only check “also log actual work” when work occurred. Review domestic primary-business and foreign-trip transportation allocations with your preparer. Meals use 50% of actual business cost; lodging uses business days. The implementation uses a verbatim local copy of travel-app/tax-core.js, with its five tax/PDF tests retained (only import paths changed), based on IRS Publication 463 chapter 1 and IRC 274. StateSplit requires explicit day records, each person’s purpose notes and an impractical return-home confirmation for standby. Unlogged days stay personal rather than silently becoming deductible. Trips’ shared primary-business/foreign transportation calculation is used directly. Per-diem rates in data/per-diem.js are marked needs review; the self-employed M&IE option remains zero until you confirm self-employment and verify the destination and effective GSA rate. Standard CONUS FY2026/FY2027 rates are included with sources; named higher-cost localities need their own verified rate and are not automatically substituted. The first/last TRAVEL days use 75%, followed by the 50% meals limitation. Actual meals cannot be recorded again for the same person/day.

Any expense can use the overall worksheet or belong to a traveler. Split by equal weights, custom percentage (must total 100), days, square feet/units, gross receipts/rents, miles or hours. Enter positive weights and optionally a personal share, which is excluded. Largest-remainder cent allocation ensures the shares exactly reconcile. Reports show each share and method. Print/Save as PDF, CSV/XLSX and allocation-schedule JSON include travelers, daily logs, allocations, per-activity totals and records gaps. Proposed portal JSON includes business-travel data, but sending remains disabled until the receiving portal supports the contract.

Agregue actividades, viajes, viajeros, propósito por día y gastos. Revise cada cargo importado y adjunte recibos. La planilla general reparte gastos entre negocios, alquileres y granja, excluyendo la parte personal. Los porcentajes suman 100 y las partes cuadran al centavo. Las reglas compartidas de Trips están incluidas; las tarifas de viáticos verificadas quedan pendientes.

Real browser verification

$env:PLAYWRIGHT_PATH='D:/codex-work/estimated-tax-app/_build/playwright/node_modules/playwright'
$env:PLAYWRIGHT_BROWSERS_PATH='D:/codex-work/estimated-tax-app/_build/browsers'
node tools/build.js
node tools/browser-check.js

The script starts a local server, checks all seven views at 375px in English/Spanish and light/dark online/offline, exercises imports and XSS text, and writes screenshots/results under tools/browser-results. It never deploys.

Backup update

Settings backup now permits plain JSON when the passphrase is empty, or existing AES-GCM encryption with a passphrase of at least ten characters. A lost passphrase means a lost backup. Files include app/version/schema/date/profile metadata. Share backup uses the phone share sheet when available. Restore previews records and offers merge, replace or a new profile. Undo restore is available in Settings for the current session. Existing encrypted backups remain readable. All-profile backup, reminder and full task-specific help remain unfinished.

Full device backup: choose All profiles in Settings. Restore previews all metadata and travel counts. Existing PINs are retained; newly restored profiles keep their saved PIN. The entire catalog is written in one transaction; Undo restores all profiles. Drop JSON backups anywhere or receive a statesplit swfl-apps/1 backup handoff. Backup reminders appear after 30 days with records; dismiss for 30 days or turn them off in Settings.

Copias completas: elija Todos los perfiles en Ajustes. La revisión muestra metadatos y cantidades de viajes. Se conservan los PIN existentes. Deshacer recupera todos los perfiles. Arrastre copias JSON o recíbalas por swfl-apps/1. Descarte recordatorios por 30 días o desactívelos en Ajustes.

Day trail and review / Historial diario y revisión

Residency → Day trail: attach a day/trip photo or PDF; record person/year assumptions; download daily check-in or projected threshold ICS alarms; set a personal limit; download the review package. Import ICS files into your calendar to activate alarms and reimport after plan changes. Check-in links open Residency without requesting location until you tap. Work calendars show fractional units beside presence days. History records old/new values, profile and time from version 1.3 onward, including deletions/undo; optional reasons are available in record forms. Local history is editable device data, not independent certification. Backups include attachments, history, assumptions and limits. The package contains an evidence index, so upload original evidence separately through Open secure upload. Portal handoff stays blocked. Assumptions are review notes and do not change calculations. No new state rules or residency conclusions are introduced. Use ? → Show me how for each task.

En Presencia → Historial diario adjunte foto/PDF por día o viaje, registre supuestos por persona/año, descargue ICS diario o de umbrales, configure límite personal y guarde paquete de revisión. Importe ICS al calendario y actualícelo si cambia el plan. El enlace abre Presencia sin solicitar ubicación hasta que pulse. El calendario laboral muestra fracciones. El historial conserva valores, perfil, hora y eliminaciones/deshacer desde 1.3; motivo opcional en formularios. Es información local, no certificación independiente. Las copias incluyen todos los datos nuevos. El paquete lleva índice de pruebas; cargue originales aparte. El portal sigue bloqueado. Los supuestos son notas sin cambiar cálculos. Use ? → Muéstreme cómo.