Tax Letter Help
by Spargur Tax & Accounting · static HTML/CSS/JavaScript PWA · no server, analytics, email or donation feature.
Using the app / Usar la app
Take or select up to 10 JPEG, PNG, HEIC or PDF files (20 MB total). Reading stays on the device. PDF text is extracted locally; scanned PDF pages use bundled Tesseract OCR with English and Spanish data. HEIC conversion is attempted locally; if unsupported, choose a JPEG copy. PDFs are limited to 50 pages to protect phone memory.
Tome o seleccione hasta 10 archivos JPEG, PNG, HEIC o PDF (20 MB total). La lectura ocurre en el dispositivo. Los PDF escaneados usan OCR local en inglés y español. Se intenta convertir HEIC localmente; si no funciona, elija JPEG. Los PDF se limitan a 50 páginas para proteger la memoria.
Check extracted details against the original. The guide covers federal notices and Florida DOR letters. Unknown notices show extracted fields and help options. Calculated deadlines are estimates, not legal determinations: printed dates, mailing date, overseas rules, weekends and holidays matter. Calendar downloads use the confirmed-date schedule described below, subject to calendar support after import. Local reminders do not produce background notifications.
Compare los datos con el original. La guía cubre avisos federales y cartas del DOR de Florida. Los plazos calculados son estimados; importan fechas impresas, envío, reglas del extranjero, fines de semana y feriados. El calendario usa el programa de fechas confirmadas explicado abajo, sujeto a la app de calendario. Los recordatorios locales no envían alertas en segundo plano.
Privacy / Privacidad
Cloudflare provides the “I’m not a robot” check, which runs only when you choose to send your letter.
Cloudflare proporciona la verificación «No soy un robot», que solo se ejecuta cuando elige enviar su carta.
Nothing uploads automatically. Unsaved scan files stay in memory. Save explicitly stores original pages in IndexedDB on this device. History deletion and Delete everything offer Undo during the session. A full backup contains original pages and should be kept private. Restore merges stable IDs without wiping existing records. Schema version 1 is checked; unsupported future schemas are rejected. Background photos are resized to 1600 pixels, stored in IndexedDB, and excluded from backups and exports. Optional AI is hidden with an empty endpoint and may receive only allowlisted masked fields, never OCR or images. There are no third-party runtime scripts or fonts.
Nada se sube automáticamente. Las páginas sin guardar quedan en memoria. Guardar conserva originales en IndexedDB local. Las eliminaciones permiten deshacer durante la sesión. La copia contiene originales: guárdela de forma privada. Restaurar combina sin borrar registros. La foto de fondo se limita a 1600 píxeles, queda en IndexedDB y no se exporta. La IA opcional está oculta y solo puede recibir campos permitidos, nunca OCR ni imágenes.
The original-page secure upload is the explicit exception to masking: the firm needs the actual notice. Contact information and pages are sent only after the specific consent checkbox and Submit. App-to-app and portal summaries contain only validated notice code, dates, year and amount, with no raw OCR, names, addresses, account numbers or pages.
La carga segura de originales es la excepción explícita al enmascarado: la firma necesita el aviso real. Datos de contacto y páginas se envían solo tras consentimiento y Enviar. Los resúmenes entre apps y al portal solo contienen código, fechas, año e importe validados, sin OCR, nombres, direcciones, cuentas ni páginas.
Appearance & preferences / Apariencia y preferencias
System/light/dark theme; six accents; plain, six CSS designs, six solids and a personal photo; small/normal/large text; optional home reminder count. Selections show check marks and persist locally. Text sits on opaque panels over patterns and photos. English and Spanish are available throughout app flows.
Tema sistema/claro/oscuro; seis acentos; fondo liso, seis diseños CSS, seis colores y foto propia; texto pequeño/normal/grande; número de recordatorios opcional en inicio. Las selecciones muestran marcas y se guardan localmente. Los paneles de texto son opacos sobre fotos y diseños.
Build, run, test
npm ci npm test npm run build npm run test:browser npm start
Node 22+ recommended. The deploy output is dist/. Do not serve the source tree as the production site. All reader scripts, WASM, trained data and licenses are checked into vendor/; node tools/vendor.js refreshes scripts from the exact package-lock versions. Language data is from tessdata.projectnaptha.com/4.0.0 (eng/spa); SHA-256 hashes are in vendor/SHA256SUMS.json. Offline installation caches all local runtime files; first installation must finish online. Large OCR/HEIC assets are loaded into the UI only on demand. OCR installation can be tens of MB.
On Windows, the existing Chrome browser can be used with $env:TEST_BROWSER_CHANNEL=\"chrome\"; npm run test:browser. Otherwise Playwright Chromium must be installed (npx playwright install chromium). Tests use synthetic taxpayers and images only; no real letters. Browser checks cover 320-pixel layout, bilingual results, consent, mocked upload, fragment clearing, import selection and offline image OCR. No pre-existing browser check was present in the empty repo.
Build generates version.json and injects APP_VERSION (default package version) into the HTML meta tag and service-worker cache. Increment APP_VERSION or package version for each release. APK_VERSION is optional. Updates check at load, focus and every 30 minutes. Refresh activates the waiting worker before reloading. An APK version newer than ?apk= shows the all-apps download link. No deployment, commits or pushes are performed by this implementation.
Secure upload contract
CONFIG.SUBMIT_ENDPOINT is https://spargurtax.com/api/forms/tax-letter-handoff. The CSP permits that origin. All tests use local mocks. The app never calls the firm automatically and never retries automatically. Sent requires a valid finish receipt. Package PDF creation uses the supplied, locally vendored pdf-lib 1.17.1. No email is sent.
Envío seguro: inicio, fragmentos y finalización. Solo el recibo final válido permite mostrar Enviado. Reintentar requiere pulsar el botón. El paquete PDF local no significa enviado. No se envía correo.
THE TAX LETTER HAND-OFF CONTRACT, version 1 (job 16 builds the platform side from this same text)
- One address: POST https://spargurtax.com/api/forms/tax-letter-handoff
- Cross-origin, from the app's own origin only; the platform keeps an allowlist. No cookies or credentials.
- Every answer is JSON: { "ok": true, ... } or { "ok": false, "error": "<plain words>" }, with Cache-Control: no-store.
- Step 1, start. Content-Type application/json, at most 32 KB:
{
"step": "start", "version": 1, "app": "tax-letter-help", "appVersion": "<app version>", "language": "en" | "es",
"website": "", // the bot trap: must be empty
"contact": { "name": "...", "email": "...", "phone": "..." }, // all three required; a request with no phone is refused
"existingClient": true | false,
"relatedCase": "TL-XXXXXX" | null, // a later send for the same letter, e.g. the signed POA
"notice": { "code": "CP2000", "issuedOn": "YYYY-MM-DD" | null, "taxForm": "1040" | null, "periods": ["2023"],
"proposedChange": 2400.00 | null, "balanceDue": 0 | null, "summary": "<plain text, at most 600 characters>",
"letterLanguage": "en" | "es" },
"dates": [ { "type": "respond_by" | "pay_by" | "appeal_by" | "petition_by" | "hearing_by" | "other", "date": "YYYY-MM-DD",
"source": "printed" | "calculated", "page": 2 | null, "confirmedByUser": true | false, "tentative": true | false } ], // 0 to 6
"poa": { "status": "not_started" | "draft" | "signed", "spouse": true | false },
"feeCard": { "version": "2026-11-06", "acknowledged": true },
"consent": { "share": true, "marketing": true | false }, // share must be true; marketing is a separate, optional choice
"note": "<at most 1,000 characters>",
"files": [ { "name": "page-1.jpg", "type": "image/jpeg" | "image/png" | "image/heic" | "application/pdf", "size": 812345,
"sha256": "<64 hex>" } ] // 1 to 10 files, 20 MB in all
}
Answer: { "ok": true, "case": "TL-7KQ4XM", "ticket": "<sealed>", "chunkBytes": 3145728, "expiresAt": "<ISO time, about 2 hours ahead>" }
A second start with the same email and the same file hashes within 2 hours returns the same case, so there are no duplicates.
- Step 2, chunk. POST <address>?step=chunk&file=<0-based index>&offset=<bytes of that file already sent>
- Header X-Handoff-Ticket: <the newest ticket>. Content-Type application/octet-stream. Body at most chunkBytes.
- Each file's pieces go in order.
- Answer: { "ok": true, "ticket": "<new sealed ticket>", "received": <bytes of that file so far> }. Always send the newest ticket.
- Step 3, finish. JSON { "step": "finish", "ticket": "<newest>" }
- Answer, only when every file arrived whole and matches its size and SHA-256:
{ "ok": true, "case": "TL-7KQ4XM", "receivedAt": "<ISO>", "files": [ { "name", "size", "sha256" } ], "dates": [ { "type", "date" } ] }
- Otherwise: { "ok": false, "error": "...", "missing": [<file indexes>] }. The app may resend those files' pieces with its ticket until the ticket expires.
- Refusals:
- 400, in plain words:
- a full SSN, ITIN or EIN, or a run of 10 or more digits, anywhere in the JSON. The pages themselves are the real notice and are the exception.
- a missing phone;
- consent.share not true;
- more than 10 files, or more than 20 MB;
- any other file type. The server checks the bytes, not just the declared type.
- 403 for another origin, with no CORS headers.
- 413 for a body over its limit, and 415 for the wrong Content-Type.
- 429 for too many tries: 5 starts per sender an hour, 60 from everyone.
- 503 { "ok": false, "error": "Secure sending is not switched on yet." } until the firm switches it on.
- A filled-in bot trap is answered as if accepted, and nothing is recorded.
- Nothing is emailed by either side. The app says "Sent" only after finish answers ok:true.
App integrations and portal gap
Send a reviewed, masked event to Checklists or a record to Family Binder. Links use swfl-apps/1 UTF-8 base64url in a fragment up to 6,000 characters, otherwise a .swfl.json download. Receives strictly validated events and records only, maximum 500 items and 2 MB per import. The fragment is cleared before decoding. Nothing is added without checkbox selection and confirmation. Imported records are marked with source app. Other kinds are rejected because this app does not hold them.
Portal notice receiving contract is missing. reference/portal/app-handoff.ts permits no tax-letter app, and books-imports.ts permits no notice kind. Therefore PORTAL_NOTICE_ENABLED is false. The required “Send to my Spargur Tax portal” button presents the masked preview and explains the gap; it cannot honestly claim a successful supported handoff. The proposed extension is in reference/portal/notice-import.proposed.json. After the portal owner implements and validates that exact extension, enable the flag. Transport is /send-to-portal?app=tax-letter#payload=… or /portal/import?app=tax-letter for a saved file over 6,000 encoded characters. Existing reference contracts are preserved unchanged. Tests translate the proposed plain-field shape and assert that existing portal contracts lack support.
AI_ENDPOINT defaults to empty, hides the optional action, and must remain off until an approved HTTPS service is configured. Enabling a different host also requires explicitly updating CSP connect-src; it never receives original images or raw OCR. Retry is explicit.
Content sources and release review
Original bilingual explanations are in src/knowledge.js, grouped by workflow with notice-specific titles and exceptions. Official links are provided for follow-up. The final verification run passed 73 Node tests and 7 Chrome browser tests. All official notice guide URLs resolved successfully. Mobile layouts and dark mode screenshots were visually inspected. Before release, William Spargur, EA should verify tax wording, current official links and all deadlines, particularly deficiency petitions, CDP rights, backup withholding duties and Florida final-assessment challenges. A phone call or submission never extends legal rights.
- CP2000 and response requirements
- CP3219A petition period
- CP90 hearing rights
- Refund claim disallowance
- Florida dispute resolution
Not affiliated with the IRS or the Florida Department of Revenue. General information, not tax advice for your situation.
Sin afiliación con el IRS ni con el Departamento de Ingresos de Florida. Información general; no es asesoramiento tributario para su situación.
Spargur Tax & Accounting PA · William Spargur, EA · 3521 Bonita Bay Blvd Suite 100, Bonita Springs FL 34134 · 239-488-4555 · spargurtax.com