Summary

This project addresses the need for a consolidated, offline-readable, mobile-first HTML travel itinerary generator. It transforms AI-researched travel plans into a single, interactive file, benefiting users who need accessible and easily updatable trip details.

How It Works

It employs a hybrid architecture, baking error-prone mechanics into reusable JavaScript engines (map.js, reminders.js, validate.js) while delegating visual presentation to a pluggable design step. This step can utilize built-in aesthetic guidelines or integrate with external design skills for enhanced output. The system optionally interfaces with other AI agent skills (e.g., for flights, hotels) to enrich data, falling back to web research if these integrations are absent.

Quick Start & Requirements

Installation involves linking the skill directory for agents like Claude Code or Codex (ln -sfn "$(pwd)/travel-plan-viz" ~/.claude/skills/travel-plan-viz). For other agents, SKILL.md serves as the instruction set. The core is platform-agnostic. Optional dependencies include specific AI agent skills for real-time data enrichment. Cross-agent adaptation details are available in references/porting-to-other-agents.md.

Highlighted Details

• Single-File HTML Output: Generates a responsive, offline-readable HTML page containing the itinerary, maps, and essential details.
• Interactive Map: Features Leaflet with free map tiles, numbered stops, routes, and direct navigation links (iOS/Android). Includes automatic GCJ-02 to WGS-84 coordinate correction.
• Daily Timeline & Reminders: Presents itineraries segmented by day (morning/noon/evening), complete with photos, ratings, and automated pre-trip reminders.
• Iterative Editing: The embedded JSON itinerary data allows users to return the HTML to the agent for seamless modifications and re-rendering.
• Post-Generation Validation: validate.js mechanically checks for data integrity, coordinate accuracy, and completeness before output.
• Optional Agent Integration: Can leverage other AI skills for real-time flight, hotel, and navigation data, enhancing the itinerary.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels (e.g., Discord, Slack). Contributions via issues and pull requests are welcomed under the MIT license.

Licensing & Compatibility

The project is released under the permissive MIT license, allowing free use, modification, and commercial distribution, provided the original copyright notice is retained.

Limitations & Caveats

All presented travel information (weather, flights, hotels, prices) is AI-compiled reference data and may be inaccurate or outdated; users must verify details via official channels. Real-time data accuracy is contingent on optional third-party agent skill integrations. Map tiles and images require an internet connection but degrade gracefully if unavailable.