Live Site: https://gehdoc.github.io/quick-tripper/
Quick-tripper is a privacy-first, zero-backend travel companion web app that generates detailed road trip itineraries using AI. It operates entirely in your browser—no databases, no logins, no tracking. Now powered by Llama 3.1 via the Hugging Face Serverless API.
- 🌍 Smart Itineraries: Generate day-by-day travel plans using Llama 3.1.
- 🗺️ Interactive Maps: Embedded Google Maps for every journey, rendered securely from AI-generated routes.
- 🔒 Privacy-First: "Bring Your Own Key" (BYOK) model. Your API token is stored locally in your browser and never sent to our servers.
- 🔗 Compressed Sharing: Share your entire itinerary via a single, ultra-compressed URL (powered by LZString).
- 💾 Local Persistence: Automatic synchronization with your browser's local storage.
- 🛡️ Secure Rendering: Strict markdown sanitization to prevent XSS and ensure your browser environment remains safe.
- Enter your Hugging Face API Token: Get a free "User Access Token" from your Hugging Face Settings.
- Describe your trip: Use the prompt area to describe where you want to go, for how long, and what you like.
- Generate: Click "Generate Itinerary" and wait a few seconds.
- Explore: Use the interactive map and read the day-by-day suggestions.
- Manage: Your trips are saved automatically. You can export them as JSON or share them via a unique link.
Quick-tripper is designed to be serverless and private. We don't have a backend to store your data or your keys.
- Local Storage: Your API token and trip history are stored ONLY in your browser's local storage.
- Direct AI Calls: The app communicates directly with Hugging Face APIs from your browser.
- No Tracking: We don't use cookies, analytics, or tracking scripts.
To use the app, you need a Hugging Face User Access Token.
- Visit Hugging Face Settings.
- Create a new token (Read access is enough).
- Paste it into the top bar of Quick-tripper.
- Framework: Next.js 15+ (App Router)
- Styling: TailwindCSS 4 + DaisyUI 5
- AI Integration: Llama 3.1 8B via Hugging Face Router.
- Data Compression: LZString
- Testing: Vitest + React Testing Library
- Automation: Husky + lint-staged
This project follows Spec-Driven Development (SDD) to maintain a clear roadmap and high technical standards. Before implementing a new feature, a technical specification must be drafted and approved.
- For Contributors: See CONTRIBUTING.md for workflow and commands.
- For AI Agents: Follow the AGENTS.md protocol.
- Clone the Repo:
git clone https://github.com/gehdoc/quick-tripper.git cd quick-tripper - Install Dependencies:
npm install
- Run Locally:
npm run dev
- Open the App: Visit
http://localhost:3000(development) orhttp://localhost:3000/quick-tripper(production-emulated) and enter your API key in the top bar.
For a detailed look at the system design, core modules, and data contract versioning, see: docs/ARCHITECTURE.md.
To maintain a robust "zero-backend" application, we rely on a multi-tiered validation strategy:
- Architectural Design: High-level designs and data contracts are documented in
ARCHITECTURE.md. - Static Analysis: ESLint and Prettier ensure code consistency and catch early errors.
- Type Safety: Strict TypeScript is enforced at the commit level via Husky hooks.
- Unit Testing: Vitest and JSDOM validate core logic, utility functions, and presentational components (co-located tests).
- E2E Testing: Playwright validates full user workflows and "golden paths" in a real browser environment.
- Spec-First Implementation: Every change is traced back to a technical specification in
specs/, ensuring architectural alignment.
MIT © Quick-tripper
If you find this tool helpful, please consider supporting its development:
Your support helps cover maintenance and further development of the tool. Thank you!