Skip to content
Skills Library
Personal productivity · Tool integration

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.

Repository
tripcanvas ↗
Licence
MIT
Last repository change
31.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 31.10.2026, without references to retired models or APIs.

Licence

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. 1. Find or install the app
  2. 2. Credentials (the user fills them in, not you)
  3. 3. First-time database setup
  4. 4. Start it
  5. 5. Using it
  6. Troubleshooting
Original SKILL.md headings · 75 lines, 734 words
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

RepositoryScoreLicence
This page · anupmshah/tripcanvas100MIT
tilnoteio/tilnote-blog100MIT
dedujeong/gemba100Apache-2.0
nextwork-projects/ai-video-editor-cooked100MIT
wrg32786/aigent-os100MIT
T-X-R/codex-game-studio100MIT
alienfast/claude100MIT
ratomirjovanovic/pandaward100AGPL-3.0
darioabc/massimo100MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.