# Tokyo Family Trip — Sample Itinerary (demo)

A public, self-contained **sample** of a family trip-itinerary web app, built with
an AI-assisted workflow and shared as a free template. Everything in it — the
travellers, dates, hotel, and plans — is **fictional demo content**. There is no
real personal information anywhere in this download.

Read the story of how it was built on **[LaserLloyd.com](https://laserlloyd.com/)**.

## How to open it

Double-click **`index.html`** (or drag it into any modern browser — Chrome, Firefox,
Safari, Edge). That's it: no install, no server, no accounts.

- It's a **single self-contained file** — the whole app, the React runtime, the
  fonts and images are all inlined, so it runs straight from your disk.
- Because everything is inlined it's a **large file (~14 MB) and can be slow on the
  first open** — that's the trade-off for zero dependencies. A real deployment would
  split and compress these assets so it loads fast; this sample favours "just works
  offline" over speed.
- Works **offline**. Two things reach the internet when you're online and simply do
  nothing when you're not: the *live weather* reading on the Overview tab and the
  *Open in Google Maps* buttons.

## What's in the app

- **Overview** — hero, a live weather card, a dual clock (your time ↔ Tokyo), and a
  two-way USD ↔ JPY currency converter.
- **Days** — a card per day with a suggested outfit, expandable stops (photos, cost,
  parking notes), and map links.
- **Guide** — arrival/customs, getting around, and etiquette notes.
- **Contact** — a placeholder card (empty in this sample).
- **Yoshi** — an AI assistant tab (see below).

## About the "Yoshi" AI assistant

The Yoshi tab is here so you can see where a trip assistant lives — but **in this
sample it is not connected to anything and will not answer.** Open it and it says so.

In the real, private version of this app, Yoshi runs on a **self-hosted local LLM**
(a small AI model on the owner's own computer) reached through a guarded server-side
relay, and can even make small edits to the itinerary. None of that backend ships in
this public download, by design.

**Want Yoshi working in your own copy?** You have to wire it to *your own* model.
Open `index.html`, find the `askBackend()` function in the Yoshi chat script (it's
clearly marked `WIRE YOUR OWN AI HERE`), and have it call your own local model — for
example an OpenAI-compatible endpoint like **LM Studio** or **Ollama** running on your
machine, ideally behind a tiny server-side relay so no API key is ever exposed in the
browser. LaserLloyd.com has a full write-up on running a web-facing chatbot on local
consumer hardware, including the security and performance gotchas.

## Files

| File | What it is |
|------|-----------|
| `index.html` | The whole app — open this. |
| `content.json` | The itinerary data the app is generated from. Edit this to see how the schedule is structured (rebuilding requires the build tooling, which isn't included). |
| `README.md` | This file. |

## Reuse

Free to open, share, and adapt for your own trips. A note like "template from
LaserLloyd.com" is appreciated but never required. This is a sample template, not a
booking service — always confirm real hours, prices, and transport yourself.
