Offline-First Multi-Currency Financial Suite, VET Engine & Geospatial Pocket Travel Guide
-2563EB.svg){kind=icon}
-7EBC6F.svg){kind=icon}
iVoyager is an offline-first financial intelligence suite and open pocket travel companion engineered for international travelers, global contractors, and cross-border shoppers.
Unlike conventional currency converters that function as simple nominal rate multipliers, iVoyager is built to solve real-world international travel and spending challenges:
- Effective Total Value (VET) Simulation: Real-time calculation of actual foreign transaction costs, evaluating IOF taxes (1.10% vs 4.38%), issuer exchange spreads (1.0% to 5.5%), and fixed fees across Physical Cash, Traditional International Credit Cards, and Global Digital Accounts (Nomad, Wise, C6 Global).
- Dual & Tourism Exchange Rates (Blue, MEP, Tarjeta): Native support for parallel, financial, and tourist exchange rates across Latin America and Argentina, preventing significant purchasing power losses.
- Multi-Currency Smart Cart: Fast item entry in local foreign currency (ARS, CLP, EUR, PYG, USD) with simultaneous real-time conversion into the user's primary wallet currency (BRL) and reference currency (USD).
- Trip Expense Manager & Split Calculation: Group expenses by travel event, assign payers, compute optimal debt-settlement matrices, and export structured CSV and PDF reports.
- Zero-Cost Geospatial Radar (OpenStreetMap): Discover authorized exchange bureaus, ATM networks, and remittance spots (Western Union) using native GPS hardware and the OpenStreetMap Overpass API rendered via Leaflet.js, requiring zero Google Maps API costs.
- Open Wikivoyage Travel Guide: Pre-compiled offline city guides with curated safety advisories, common scam alerts, emergency numbers, and regional chapters (Understand, Get around, See & Do, Eat & Drink).
- Offline Sign & Menu Translator: On-device fuzzy matching lexicon translating South American road signs, public transit terms, and restaurant dining menus without network connectivity.
- Route Fuel & Toll Cost Calculator: Cross-border mobility engine computing fuel consumption and highway corridor toll budgets across major travel routes.
- Airport Transit Hub Logistics: Ground transport options, schedules, ticket tariffs, and security recommendations for major international transit hubs (EZE, AEP, COR, SCL).
- 100% Offline-First Architecture: Full functionality in airplane mode or areas without cellular roaming, persisting exchange history, trips, and shopping carts directly in the device's IndexedDB.
- AI Agent Integration via Model Context Protocol (MCP): A native TypeScript MCP server enabling LLMs (Claude, Gemini, Cursor) to directly query live rates, audit trip budgets, and simulate tax scenarios through natural language.
+-----------------------------------------------------------------------------+
| iVoyager App |
+-----------------------------------------------------------------------------+
| Presentation Layer & UI |
| - Standalone Reactive Architecture (DOM Signals & Web Components) |
| - Touch-Optimized Mobile Navigation & Responsive Grid Layout |
| - Tokenized Modular CSS (Zero Tailwind, OKLCH / HSL Design Tokens) |
+-----------------------------------------------------------------------------+
| Business Layer & Calculation Engines |
| - Currency Engine (Cross-Rates & Fixed-Point Decimal Math via Decimal.js) |
| - VET & Tax Calculator (IOF 1.1% vs 4.38%, Spreads, Cashback) |
| - Cart & Expense Aggregator (Multi-Currency, Local Splitwise) |
| - OCR & Voice Parser (Tesseract.js / Web Speech API) |
| - Wikivoyage Travel Guide & Safety Engine (WikivoyageService) |
| - Offline Sign & Menu Lexicon (SignTranslatorService + Levenshtein) |
| - Mobility & Toll Calculator (MobilityService) |
| - Airport Transit Intelligence (FlightTransitService) |
+-----------------------------------------------------------------------------+
| Data Layer & Local-First Persistence |
| - IndexedDB via Dexie.js (Strict TypeScript Schema) |
| - Service Worker (Asset & Rate Cache with Strict TTL) |
+-----------------------------------------------------------------------------+
| Geospatial & Hardware Layer |
| - Native GPS (navigator.geolocation / Capacitor Geolocation) |
| - OpenStreetMap + Overpass API (Bounding Radius Exchange POIs) |
| - Leaflet.js (On-Demand Vector Tile Rendering) |
+-----------------------------------------------------------------------------+
| Distribution & Integration Layer |
| - Capacitor Bridge (Native iOS IPA & Android AAB Generation) |
| - Model Context Protocol (TypeScript MCP Server for Autonomous AI Agents) |
+-----------------------------------------------------------------------------+
Computes the complete Effective Total Value equation:
Split-screen interface designed for fast overseas shopping in grocery markets, electronics retail, and local fairs:
- Fast keypad input in local tag currency.
- Real-time converted subtotals and totals.
- Custom rate locking for cash transactions.
- Folder-based trip categorization (e.g., Bariloche Trip 2026, Ciudad del Este Tech).
- Dynamic debt-settlement matrix based on historical rates recorded on the transaction date.
- Export to CSV, JSON, and formatted PDF.
- Discover authorized physical exchange houses within a 1km to 5km radius.
- Data retrieved via OpenStreetMap Overpass API (
amenity=bureau_de_change). - Custom point-of-interest dropper with GeoJSON export.
- Offline city data packs cached directly in IndexedDB.
- Pre-compiled offline destination packs for Cordoba, Buenos Aires, Mendoza, and Santiago.
- Verified safety alerts, scam mitigation guides, and local emergency contacts.
- Structured city chapters covering transit, sightseeing, and dining.
- On-device bilingual dictionary translating critical road signs (e.g., Pare, Ceda el paso, Telepeaje, Contramano).
- Dining glossary explaining restaurant surcharge terms (e.g., Cubierto, Propina, Factura B).
- Levenshtein distance string similarity supporting noisy camera OCR text inputs.
- Fuel volume consumption formulas based on route distance and vehicle efficiency.
- Highway toll pricing tables for principal South American travel corridors (RN9, RN7, Autovia 2, Ruta 68).
- Grand route total calculations with multi-currency cross-rate conversions.
- Detailed ground transport directories for international airport hubs (EZE, AEP, COR, SCL).
- Direct comparisons between express coaches, local public transit lines, and authorized radio-taxi ranks.
- Tariff ranges and travel duration estimates.
Pre-built tools for autonomous AI agents:
ivoyager_get_rates: Multi-source exchange rates (Official, Blue, MEP, Crypto).ivoyager_calculate_vet: Payment method tax and spread simulations.ivoyager_convert: High-precision cross-rate arithmetic.ivoyager_trip_summary: Trip expense and balance aggregation.ivoyager_find_exchange_spots: Geospatial search for nearby exchange bureaus.
| Layer | Technology | Role |
|---|---|---|
| Language & Engine | TypeScript 5.7+ | Strict type safety, modular services, and mathematical interfaces. |
| Architecture | Standalone Reactive Core | Zero-bloat, lightweight event-driven state without framework overhead. |
| Styling | Tokenized CSS | Custom design system using OKLCH/HSL tokens (Zero Tailwind). |
| Persistence | IndexedDB via Dexie.js | Embedded transactional NoSQL storage. |
| Mobile Distribution | Capacitor | Native iOS (Swift) and Android (Kotlin) build bridge. |
| Geospatial | Native GPS + OpenStreetMap | Hardware location and Overpass POI queries. |
| Map Rendering | Leaflet.js | Lightweight on-demand map tile rendering. |
| Precision Math | Decimal.js | Fixed-point arithmetic avoiding IEEE-754 floating point errors. |
| AI Protocol | @modelcontextprotocol/sdk | Native TypeScript Model Context Protocol server. |
ivoyager/
├── .github/ # CI/CD pipelines for linting, testing, and builds
├── capacitor.config.ts # Capacitor native bridge configuration
├── package.json # Project dependencies
├── tsconfig.json # Strict TypeScript configuration
├── index.html # Main application entrypoint
├── src/
│ ├── index.html # Core HTML template
│ ├── main.ts # Application bootstrap
│ ├── styles/ # Modular stylesheets (reset.css, tokens.css, typography.css, app.css)
│ ├── app/
│ │ ├── core/ # Models, services, fixed-point math, and IndexedDB
│ │ │ ├── services/ # Wikivoyage, SignTranslator, Mobility, FlightTransit, VET, Radar
│ │ │ ├── models/ # Currency, VET, PaymentMethod, Cart, Trip, Geo models
│ │ │ └── math/ # FixedDecimal precision arithmetic
│ │ ├── features/ # Feature controllers
│ │ └── shared/ # Reusable UI elements and pipes
│ └── assets/ # Clean SVG assets and offline city datasets
├── mcp-server/ # TypeScript Model Context Protocol server
├── websocket-server/ # Real-time WebSocket ticker service
├── LICENSE # MIT License
└── README.md # Technical documentation
This project is licensed under the MIT License. See the LICENSE file for details.