Vehicle & Mileage
by Spargur Tax & Accounting
General information, not tax advice for your situation.
Información general, no asesoramiento fiscal para su situación.
Help and walkthroughs / Ayuda y guías
Open the ? beside each screen title or form title for short help; field question marks explain entries with examples. Help & About replays all 12 Show me how guides: setup, trip entry, annual odometer, method comparison, purchase planning, tracker CSV import, app sharing, backup/restore, profiles/PIN, expenses, travel, and reports. Each guide highlights a real control, describes it for screen readers, and supports Back, Next, Finish, Skip and Escape. Guides do not save or transmit records. Finish leaves an open form for you to review and save. Missing prerequisites explain how to add records before replaying.
Abra el ? del título o formulario para ayuda breve; cada campo incluye explicación y ejemplo. Ayuda permite repetir las 12 guías, con controles reales resaltados, descripción accesible y Atrás, Siguiente, Terminar, Omitir y Escape. Las guías no guardan ni envían datos. Terminar deja el formulario abierto para revisar y guardar. El glosario explica términos fiscales.
Send to Spargur Tax opens only the upload page; select a file there yourself. Save compatible mileage file downloads a previewed file, with no direct portal transmission. The installed app opens in its own window.
Enviar a Spargur Tax solo abre la página de carga; elija el archivo allí. Guardar archivo compatible descarga tras vista previa, sin envío directo al portal. La aplicación instalada se abre en su propia ventana.
Use / Uso
Add a profile, vehicles, and named activities. Log each trip with date, destination, miles, and purpose. Enter annual odometer readings to include unlogged personal use in business-use percentages. Keep each business, rental and farm separate. The quick log supports odometer difference, round-trip distance, weekly repetition, copying, and tap-only endpoint location recording. A web app cannot measure routes or track in the background.
Agregue un perfil, vehículos y actividades por nombre. Registre fecha, destino, millas y propósito. El odómetro anual incluye el uso personal no registrado al calcular porcentajes. Separe negocios, alquileres y granja. El temporizador solo registra ubicaciones al tocar iniciar y detener; no rastrea en segundo plano.
Records / Registros
Vehicles store make/model/year, weight rating, ownership, service/acquisition date, cost, trade proceeds, financing, first/current methods and VIN last six only. Do not enter plate numbers. Annual evidence flags, photos and odometers support Part V preparation; the preparer must confirm every Form 4562 answer. Expenses support receipts and shared allocation by equal split, percentages, days, square feet/units, receipts/rents, or miles/hours. Largest-remainder cent allocation preserves the original total; personal shares are excluded. When no split is supplied, annual vehicle business use applies. Record interest as an expense to include it in deduction totals; vehicle financing facts alone do not create an expense.
Los vehículos conservan solo los últimos seis caracteres del VIN. No ingrese matrículas. Las fotos quedan en el dispositivo. Las asignaciones compartidas conservan cada centavo; la parte personal queda excluida. Sin asignación explícita se aplica el porcentaje anual del vehículo. Registre los intereses como gasto; los datos de financiación no crean gastos automáticamente.
Purchase planning / Planificación
The rate data in data/rates.js links to IRS Notices 2024-08, 2025-5, 2026-10; Announcement 2026-11 in IRB 2026-29 (July 1 midyear increase); Revenue Procedures 2024-13, 2025-16 and 2026-15 for 280F; and the published 179 SUV limits. 2027 is not offered: no published IRS mileage rates were found as of November 17, 2026. Older records remain readable and future calculations stay marked for review. Future standard-mileage totals are withheld when any rate is unknown. Charitable mileage is $0.14 by statute. Depreciation basis components are $0.30/$0.33/$0.35 for 2024/25/26.
Assumptions: constant qualified business use; half-year five-year MACRS; no mid-quarter convention, business income limit, aggregate Section 179 phaseout, state adjustment or credits. A passenger car's statutory weight test can differ from a truck's GVWR test: the preparer must confirm classification. Over 6,000 lb is only a planning switch, not proof of eligibility. Heavy SUV 179 is capped; verified qualifying truck/van exceptions must be selected explicitly. 2025 acquisitions before January 20 use 40% bonus; later qualifying acquisitions use 100%. Leased-vehicle calculations omit the income inclusion adjustment and must be reviewed.
Standard first permits later actual with straight-line. Actual first blocks standard. Leased standard continues for the lease and renewals. Section 179 and bonus require use strictly above 50%; recapture worksheet compares prior accelerated deductions with straight-line when use drops to 50% or less. Sale/trade is a disposition; cost basis is not reduced by trade-in proceeds. Basis is reduced by actual depreciation or the standard-rate embedded depreciation. Personal losses cannot be deducted. Annual planner miles are spread evenly over calendar days, with weighted rates for midyear changes. The log uses each trip’s actual date. Passenger-auto 100% bonus uses the default recovery treatment, not an automatically elected safe harbor; confirm the applicable recovery method with the preparer. Cash estimates include down payment, entered annual loan payments and operating costs, with resale in the last year. Tax savings omit sale tax and self-employment tax.
Annual odometer records can also store depreciation allowed on the filed tax return. A supplied amount overrides the current-year model. Standard-method schedules show the basis reduction embedded in logged business miles. Actual schedules identify entered amounts versus planning estimates. Vehicle summaries are planning estimates, not a historical tax ledger. They do not infer prior depreciation, disallowed amounts, personal/business basis changes or prior-year elections. Review prior returns. Purchase schedules require preparer review, particularly capped passenger autos with bonus and unused depreciation after the recovery period. Do not file the displayed estimate as an automatic tax election.
Las tarifas futuras desconocidas no se reemplazan por tarifas actuales. El modelo supone uso constante y MACRS de medio año. Revise clasificación, límites de ingreso, compras totales, arrendamientos, elecciones previas y reglas estatales con el preparador. Las estimaciones no son una elección fiscal automática ni reemplazan el historial de depreciación.
Travel days / Días de viaje
TRAVEL, WORK and qualifying STANDBY count as business. Standby must lie between business days and returning home must be impractical. Edge weekends default to personal. Domestic transportation is modeled in full only with more business than personal days (facts and circumstances still control). Foreign trips use full transportation for at most seven days excluding departure or strictly less than 25% personal days; otherwise allocate by days. Additional foreign-trip exceptions are not inferred.
Owners/members/partners and employees need their own per-day purpose note. Advisors/contractors are flagged for review; guests have zero deduction. Shared rooms/cars require the solo business cost cap. Lodging needs a receipt; expenses $75 or more need receipts. Meals normally use 50%. Optional destination M&IE rates are entered by the user and remain needs-review until verified; first/last travel days use 75% before the 50% meals limit. See IRS Publication 463 chapter 1 and Treas. Reg. 1.274-5. The supplied Trips tax-core.js and its tests were not present in this workspace, so exact cross-app implementation parity has not been verified. No source was read outside this folder.
Card CSV columns are Date,Amount,Category,Payee with ISO dates and positive USD amounts. Review dates/categories and confirm selected charges. Personal days are suggested as personal; mixed days require review. Receipts and missing purpose notes appear in the checklist. The full report and exports include day records, each traveler’s purposes, line deductions, totals by activity/category, and checklist gaps. Travel expenses also accept the same shared-allocation methods as vehicle expenses; personal shares are excluded after applying the travel deduction rules. A guest on the trip requires a solo cost cap for lodging and car rental before those lines produce a deduction.
Los días de espera deben estar entre días de negocios y el regreso a casa no debe ser práctico. Cada viajero calificado necesita propósito diario. Los invitados no generan deducción. El alojamiento requiere recibo; otros gastos de $75 o más también. Comidas generalmente al 50%; M&IE requiere verificar destino y fecha. No se verificó paridad exacta con el código de Trips porque no se suministró.
CSV import / Importación CSV
Synthetic files in samples/ exercise TripLog (Date, Start Location, End Location, Purpose, Distance), MileIQ (Start Date, Start Location, End Location, Purpose, Miles), Everlance (Date, Start, End, Notes, Miles) and Stride (Date, From, To, Description, Miles). These are synthetic supported layouts, not a guarantee of every vendor export version. Every import opens a saved column mapper, row preview and explicit confirmation. Invalid row numbers are shown. Deduplication uses date, vehicle, activity, route, miles and purpose. Distinct same-day identical trips require a distinct purpose note. Files max 2 MB; up to 10,000 CSV rows. CSV output neutralizes leading spreadsheet formulas. XLSX stores text as inline strings.
Las muestras son sintéticas; las versiones de cada proveedor pueden variar. Siempre revise columnas y filas. Las filas inválidas se identifican. Las reimportaciones omiten duplicados. Importaciones y cálculos usan millas; puede ingresar kilómetros en el formulario de recorridos.
Profiles, privacy and backups / Perfiles y copias
Everything is stored in IndexedDB. No analytics, third-party scripts, automatic transmission, cloud sign-in or sync. Each profile has independent settings/records/export scope. Schema 2 migrates a legacy single-profile object to the first profile without removing records. Profile deletes require acknowledgement of a backup prompt and support undo until another deletion or reload. PINs use a random salt and 100,000 PBKDF2 SHA-256 iterations: they are a privacy screen, NOT encryption. A person with access to browser storage can read records.
Encrypted profile backups use PBKDF2 SHA-256 (250,000 iterations) and AES-256-GCM, random 16-byte salt and 12-byte IV. Passphrase at least eight characters; no recovery. Receipts and odometer photos are included; PIN and background photo are excluded. Plain JSON is also available with a privacy reminder. Restore validates, previews, and merges into the open profile or a new profile. It never wipes current data. Same IDs preserve the current record. Older single-profile JSON backups are accepted. No background photo is uploaded or exported. Storage-full failures leave the persisted state unchanged. Browser data deletion removes records; keep an external backup.
Todo se guarda en IndexedDB sin cuenta ni sincronización. Cada perfil es independiente. El PIN no cifra los datos. La copia cifrada usa AES-GCM y una frase de contraseña que no se puede recuperar. La restauración valida, muestra vista previa y combina sin borrar. Fotos de fondo y PIN no se exportan. Conserve una copia externa.
App handoff contract / Contrato entre aplicaciones
The only envelope is {format:"swfl-apps/1",from:"vehicle-mileage",created:"ISO timestamp",items:[...]}. Maximum 500 items, 2 MB UTF-8. This app receives only event (travel plans) and money (vehicle expenses or mileage); unsupported kinds/unknown fields are rejected. The fragment is cleared before validation. A checklist preview must be confirmed; records go only to the open profile, marked from the sender and deduplicated. No photos, coordinates, VINs, plate numbers, PINs or settings in handoffs.
Because swfl-apps/1 has no mileage kind, a mileage item uses only allowed money fields:
{
"kind": "money",
"date": "2026-11-05",
"amount_usd": 0,
"payee": "Consulting business",
"category": "mileage",
"notes": "{\"schema\":\"vehicle-mileage/1\",\"miles\":12.5,\"from\":\"Office\",\"to\":\"Client\",\"purpose\":\"Consultation\",\"activity\":\"Consulting business\",\"type\":\"C\",\"vehicle\":\"local opaque ID\",\"source_key\":\"stable trip ID\"}"
}Recipients should offer “Import from Vehicle & Mileage,” parse only this documented notes schema, ask the user to map activity/vehicle, and never treat amount_usd:0 as a computed deduction. Giving Log can accept charity miles; Realty Desk rental miles; Quarterly business miles; Trips dated records. Trips can send event travel dates into this app. Sender lets the person explicitly select records and target. Travel sharing uses allowed event items per day (notes schema vehicle-travel-day/1 with activity, day, purpose and traveler role/purpose records) and money items per expense (notes schema vehicle-travel-expense/1 with trip, activity, role, amount_paid, allocated shares/method, reason, purpose and records_complete). Receipt images and coordinates are excluded. A receiver must independently confirm tax treatment.
For encoded payloads ≤6,000 characters open https://target/#swfl-import=<base64url UTF-8 JSON>; otherwise download vehicle-mileage-to-target-date.swfl.json and open the target. A fragment is never sent to a server. Current links are in Help & About. Calendar export is an all-day .ics file.
El envío requiere selección y vista previa. La aplicación receptora también debe confirmar. El millaje usa un elemento money con importe cero y notas JSON; cero no representa una deducción calculada. No se envían fotos ni datos privados del perfil.
Portal compatibility — owner action required
The provided reference/portal/books-imports.ts accepts {format:"spargur-books-import",version:1,kind:"mileage",source:"vehicle_planner",rows:[...]}. Each row has source_key, date, positive quantity and strict details: purpose, from, to, vehicle, category (business/charity/medical/moving), optional odometers/round_trip. Activity is an optional portal UUID, never a local activity ID. We place the named activity in purpose instead. Row maximum 2,000; identifying-number patterns are rejected. Payload validation is plain JS and tests are based on the supplied zod shapes.
The supplied app-handoff.ts does not accept the requested app ID vehicle-mileage. It accepts vehicle-planner. The strict mileage details also cannot hold vehicle facts, day records or allocation schedules. This app therefore previews and downloads a contract-compatible mileage file instead of opening a known unsupported portal route. The requested URL logic for app=vehicle-mileage is implemented and tested but not activated. Before deployment the portal owner must register vehicle-mileage (kinds mileage and, separately, vehicle_asset if desired) and agree a versioned travel/vehicle contract. Do not silently change the copied reference files. Full reports/CSV/XLSX carry the additional records for preparer handoff meanwhile. Photos are never sent. No portal data is sent automatically.
El portal suministrado no reconoce vehicle-mileage. Debe actualizarse antes de activar el enlace. Por ahora se descarga un archivo de millaje compatible; el informe completo contiene los datos adicionales.
Appearance / Apariencia
System/light/dark theme; six accessible dark accent colors; plain background plus six CSS designs, six solids and device-only photo resized to 1,600 px; small/normal/large text. Selected values are shown with check marks in native selects. Opaque content surfaces protect contrast. The photo is behind an overlay. Profile color appears on the switcher. Preferences set year, display units, default vehicle/activity and home screen. Language is saved per profile. No background reminders or notifications are implied.
Tema del sistema, claro u oscuro; seis colores, seis diseños CSS, seis fondos lisos y foto local; tres tamaños de texto. Las selecciones se muestran en controles nativos. Preferencias por perfil: año, unidades, vehículo y actividad predeterminados, pantalla inicial e idioma.
Build, tests, deployment
npm test npm run build npm run check node tools/browser-check.js node tools/serve.js
No runtime or npm dependencies. Node 22+ required for tests/Web Crypto and the optional dependency-free CDP browser check. The synthetic browser test covers four viewport widths, entry, profiles/PIN, delete/undo, language, CSV previews, handoff confirmation, restore merge, offline reload and simulated quota failure. It saves a 375 px screenshot under ignored artifacts/. Chrome or Edge must be installed for browser checks; set CHROME_PATH if needed. Build writes dist/, version.json, the index meta and matching service-worker cache name from package.json or APP_VERSION. Bump version for each release. APK_VERSION can set an Android update version; ?apk= compares it and links only to the apps page. Update checks on load, focus and every 30 minutes use a five-second timeout and one retry. Refresh activates the waiting worker. First visit must be online to install the offline shell. The browser check also exercises every walkthrough step in English and Spanish at 375 px while offline.
Vercel later: build command npm run build, output dist; vercel.json supplies headers. No environment variables, backend functions or database migrations are required. No deployment or push is part of this release workflow. Portal activation requires the contract update above. Verify Trips parity once its tax-core and fixtures are supplied. Tax calculations and translations require professional review before public release.
Construya con npm run build; publique dist más adelante. No se requiere servidor, funciones ni variables secretas. No se ha desplegado. Revise el contrato del portal, la paridad con Trips y los cálculos antes de publicar.
Firm / Firma
Spargur Tax & Accounting PA · William Spargur, EA
3521 Bonita Bay Blvd Suite 100, Bonita Springs FL 34134
239-488-4555 · spargurtax.com