# Tinyworld Onboarding Driver

> TinyWorld Driver.js Onboarding

- Skill: `jasonkneen/tinyworld-onboarding-driver` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jasonkneen/tinyworld-onboarding-driver`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jasonkneen/tinyworld-onboarding-driver/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jasonkneen (https://skillmd.com/u/jasonkneen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jasonkneen/tinyworld-onboarding-driver

---

# TinyWorld Driver.js Onboarding

Use this skill when changing the TinyWorld onboarding tour, Guide button, or Driver.js integration.

## Current Shape

- Driver.js is vendored under `vendor/driverjs/` and loaded from `tiny-world-builder.html`.
- The tour module is `engine/world/70-onboarding-driver.js`; it is a classic script, so keep top-level names unique.
- The toolbar replay entry is `#toolbar-guide` in `engine/world/19-tools-toolbar.js`.
- Tour styling lives in `styles/tiny-world.css` under `/* ---- Driver.js onboarding ---- */`.

## Behavior Contract

- The first-run dismissal key is `tinyworld:onboarding:driver.v1`.
- Users can force the tour with `?tour=1`, reset the dismissal with `?tour=reset`, or disable it for a page load with `?tour=0`.
- Auto-start waits until the welcome modal is closed and skips preview, room/collab, and play-mode sessions.
- The module exposes `window.__tinyworldOnboarding.start({ force: true })` for replay controls.

## Persistence

- Keep the onboarding dismissal out of shipped defaults. `tools/dev-server.js` excludes `tinyworld:onboarding:driver.v*`; mirror that exclusion if another defaults-save path becomes active.

## Checks

- Run `node --check engine/world/70-onboarding-driver.js`.
- Run `npm test` and `npm run build`.
- Browser-check `http://localhost:3000/tiny-world-builder?tour=1` after dismissing the welcome modal; confirm the popover uses the yellow TinyWorld UI style and the Guide button replays the tour.