start
/start
Install, configure and launch TripCanvas, a local multi-city trip planner, using the user's own OpenAI key and Postgres database. Use when the user wants to plan a trip with TripCanvas, set it up, fix its credentials, or start it again.
- Author
- anupmshah ↗
- Repository
- tripcanvas ↗
- Licence
- MIT
- Last repository change
- 31.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 31.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Install, configure and launch TripCanvas, a local multi-city trip planner, using the user's own OpenAI key and Postgres database. Use when the user wants to plan a trip with TripCanvas, set it up, fix its credentials, or start it again.
Original author description
Install, configure and launch TripCanvas, a local multi-city trip planner, using the user's own OpenAI key and Postgres database. Use when the user wants to plan a trip with TripCanvas, set it up, fix its credentials, or start it again.
How it works
- 1. Find or install the app
- 2. Credentials (the user fills them in, not you)
- 3. First-time database setup
- 4. Start it
- 5. Using it
- Troubleshooting
SKILL.md preview
---
name: start
description: Install, configure and launch TripCanvas, a local multi-city trip planner, using the user's own OpenAI key and Postgres database. Use when the user wants to plan a trip with TripCanvas, set it up, fix its credentials, or start it again.
---
# TripCanvas
TripCanvas is a Next.js app that runs on the user's machine. The user describes a trip in one sentence, reviews an editable multi-city route, and gets a day-by-day itinerary with a map, labelled cost estimates, a budget, chat edits, booking links, sharing, a calendar file and a print view.
It uses the **user's own credentials**. You never supply keys, and you never ask the user to paste a key into chat.
## 1. Find or install the app
Ask where to keep it if it's not obvious; the default is a `TripCanvas` folder in the user's home directory. If that folder already has `package.json` with `"name": "tripcanvas"`, use it and skip to step 2.
```
git clone https://github.com/anupmshah/tripcanvas.git TripCanvas
cd TripCanvas
npm install
```
Needs Node 20.6 or later and git. If either is missing, say so and stop.
## 2. Credentials (the user fills them in, not you)
If `.env` doesn't exist, copy `.env.example` to `.env`. Open `.env` in the user's editor (on Windows `notepad .env`, on macOS `open -e .env`, otherwise their `$EDITOR`) and tell them what goes in each line:
| Setting | Required | Where to get it |
|---|---|---|
| `OPENAI_API_KEY` | yes | platform.openai.com → API keys. The account needs billing credit. |
| `DATABASE_URL` | yes | Any Postgres. Free option: neon.tech → new project → Connect → Prisma → **pooled** string. Append `&schema=tripcanvas`. |
| `DIRECT_URL` | yes | The **direct** (non-pooled) string from the same Neon screen, also with `&schema=tripcanvas`. For plain Postgres, use the same URL as `DATABASE_URL`. |
| `NOMINATIM_CONTACT` | yes | The user's email or website; OpenStreetMap's usage policy asks for it. |
| `DUFFEL_ACCESS_TOKEN` | no | duffel.com. Without it, flights show labelled AI estimates plus Google Flights / Skyscanner links. |
Tell the user: never paste keys into the chat; save the file and reply "done". The app only touches the `tripcanvas` schema, so a shared database is safe.
Then verify, without printing any secret:
```
npx prisma generate
npm run check-env
```
`check-env` prints `ok`/`FAIL` lines and `ENV OK` at the end. On `FAIL`, explain the line in plain words, reopen `.env`, and check again. Do not read `.env` aloud or echo its values.
## 3. First-time database setup
Only when `check-env` passes:
```
npm run db:push
npm run db:seed
```
`db:push` creates TripCanvas's tables inside the `tripcanvas` schema only. Never add `--force-reset` or `--accept-data-loss`.
## 4. Start it
Run `npm run dev` as a long-running background process and wait for the line containing `Local:`. Both `npm run dev` and `npm run start` bind to `127.0.0.1` only. Give the user the printed URL (normally http://127.0.0.1:3000). If port 3000 is busy, Next picks another port; use the one it prints. To use IPv6 loopback explicitly, run `npm run dev -- --hostname ::1 --port 3000` (also supported by `npm run start`) and give http://[::1]:3000; `localhost` may reach a different IPv4 service. Never bind to `0.0.0.0` or `::`.
## 5. Using it
Tell the user, briefly:
1. Type a trip in the "Describe your trip" box, e.g. *"Plan a USA trip for 2 adults and 1 kid for 15 days anytime between 15th December and 5th January. First time in the USA, we are vegetarians."* Pressing Tab in the empty box fills in this example.
2. Review the proposed dates and cities (edit any field, or type a change), then **Accept route & create itinerary**.
3. Use the chat for changes ("swap Orlando for Chicago", "we're over budget, suggest cheaper hotels"). Every change is shown for review first; booked items are never changed.
4. Set a budget in the Budget panel; Share, `.ics` and Export PDF are at the top of the trip.
Prices are AI estimates unless marked Live or Entered; the user must check prices and bookings with the provider. The app has no login: it is meant for one person on their own computer, so don't expose it to the internet.
## Troubleshooting
- `check-env` says OpenAI rejected the key (401): the key was revoked or mistyped; create a new one.
- OpenAI 429 / quota: the OpenAI account needs billing credit.
- Database could not connect: wrong URL, missing `sslmode=require` for Neon, or the Neon project is paused (open it in the Neon console to wake it).
- On Windows, stop `npm run dev` before `npx prisma generate`, otherwise the Prisma engine file is locked.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · anupmshah/tripcanvas | 100 | MIT |
| tilnoteio/tilnote-blog | 100 | MIT |
| dedujeong/gemba | 100 | Apache-2.0 |
| nextwork-projects/ai-video-editor-cooked | 100 | MIT |
| wrg32786/aigent-os | 100 | MIT |
| T-X-R/codex-game-studio | 100 | MIT |
| alienfast/claude | 100 | MIT |
| ratomirjovanovic/pandaward | 100 | AGPL-3.0 |
| darioabc/massimo | 100 | MIT |
Database snapshot: 13.11.2026 · package version 626e04319b5b (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100trip-planner
Generate personalized packing lists from a weather forecast. Use when user says 'plan a trip', 'packing list', 'what should I pack', or 'trip to [destination]'. - 100plan-trip
Build or update a RouteWise trip site from someone's bookings. Use when the user says "plan my trip", "make a trip site", "update my trip", "add this booking", or shares a flight, hotel or restaurant confirmation for a trip that has (or should have) a RouteWise site. Sets up a… - 100trip-planner
Use when the user wants detailed travel itineraries with activities, logistics, day-by-day schedules, vacation planning, trip organization, or travel documentation. - 84install-and-start
Install and start voice-teleprompter on this computer, then tell the user what to do on the page. Use when the user asks to set up, install, run, start or open the teleprompter. - 87travel-planner
Plan a trip end to end with SearchApi's Google Flights, TripAdvisor, and Airbnb engines - round-trip flights, a place to stay, and things to do, in one assembled plan with a day-by-day itinerary, a cost breakdown against budget, and an interactive HTML dashboard. Use when the… - 90k2f-travel-planner
Blueprint a printable, trip-ready travel planner from destination, dates, budget, and must-dos—day-by-day flow, budget roll-up, packing, culture notes, and prep timeline with scannable hierarchy. Use when the user asks for a travel planner, trip itinerary document, vacation plan…