Interactive presentation builder
Build slide decks that run as a website and are projected to a room. The deck is the
visual half of a talk; the presenter does the talking. Two ways to build, one shared
design language.
First, the mental model (read before writing any code)
There is one operator (the presenter) on one machine. Slides go on a big screen;
the audience only looks — they never click, type, or interact. Everything below
follows from this. Four failure modes to avoid:
- Text too small. Slides are read from across a room, not on a laptop. Never use
web-reading sizes (
text-sm, 16px) or fixed Tailwind text classes (text-4xl).
Always use fluid clamp() so text scales with the screen. Honour the typography floor
(body ≈ 30–36px, never below 28px on a 1080p canvas). See references/design-system.md.
- Content hugging an edge. Padding is a two-layer contract. Slide content must stay
inside the viewport safe area, and content inside a card, panel, callout, bordered box,
or other visible container must stay inset from that container's own edge. A parent
slide's padding does not protect a nested container;
gap and child margins are not a
substitute for the container's own padding. Both scaffolds provide safe-area padding
and a .slide-surface inset helper. Even fullBleed slides keep text content inset.
- Building an app. No input fields, no "Submit", no login, no data collection — there
is no backend and nowhere for data to go. Interaction is only the presenter clicking to
reveal/advance content. If a component asks "where does this data go?", it's wrong.
- Wrong voice for the audience. A board report is not a lesson and a pitch is not a
status update. The deck type sets the structure and the voice. Decide it first — see
references/deck-types.md.
The presenter may hold a phone remote (scan a QR code from the terminal, then tap
Next/Prev). It is the same single operator on a second device, not audience interaction.
references/design-system.md is the heart of this skill — the typography floor, two-layer
padding contract, content overflow, layout recipes, motion, and palette. Read it whenever
you design or restyle slide content.
Workflow
- Understand and clarify the talk.
- Content: If the presentation content is vague or unclear, ask questions to clarify the topic, audience, speaker (name/role), and key message before building. For Vietnamese content, the default voice is plain, honest, direct — no marketing hype.
- Deck type: Decide what the deck is for before writing: report upward, decision request, pitch, training, talk, or internal update. Infer it from the request and tell the user your choice in one line; ask only when two types fit equally. Then read
references/deck-types.md and follow that type's arc, voice, and prohibitions.
- Style: Ask the user for their preferred visual style and suggest these 5 modern options:
- Minimalist Bauhaus: High contrast, geometric typography, generous whitespace.
- Dark Mode Cinematic: Deep slate/black backgrounds, dramatic contrast, glowing accents.
- Editorial / Magazine: Sophisticated font pairings (serif + sans), structured grid layouts.
- Glassmorphism: Soft background gradients with blurred, translucent content panels.
- Neo-Brutalism: Bold typography, raw borders, hard shadows, high energy.
- Pick a track (below). If unsure, ask once; otherwise default to plain HTML for
small/quick decks and React for substantial, maintained talks.
- Scaffold with the matching script — don't hand-assemble the boilerplate.
- Build slides in the arc and voice of the deck type, following
references/design-system.md: one idea per slide, few
words, real visuals, projection-legible type, presenter-only interaction, and the
two-layer padding contract for both viewport and content containers. Respect the
density limits — never exceed 5 bullets, ~60 words, or 5×4 table cells per slide.
If content doesn't fit at the typography floor, split into more slides — never shrink
past the floor and never produce a slide that scrolls vertically.
- Keep the required chrome: a visible bottom navigation slider (dot strip) and slide
number. Both scaffolds include it — don't remove it.
- Write speaker notes in the
<deck-name>-notes.md file the scaffold creates (never
on the slides themselves).
- Run the verify script to catch text-too-small and content-too-dense violations:
bash /mnt/skills/user/slidewright/scripts/verify-slides.sh <path-to-deck>
Fix every reported issue before proceeding.
- Run the spacing audit before handoff. Check every slide at 1920×1080 and at one
smaller viewport. No text or primary content may cross the viewport safe area. For
every element that draws a visible boundary (
background, border, outline,
shadow, rounded surface, or text-overlay panel), verify that its content has
padding on all four sides. Media and purely decorative edge-to-edge layers are the
only exceptions; text over them belongs in a nested padded surface.
- Tell the user how to present with the phone remote. Both scaffolds include it.
The HTML track runs
node <deck>/slidewright-remote.mjs. The React track runs npm run dev.
The terminal prints a QR code for the phone. See references/remote-control.md.
Keep the deck's window.slidewright API and slidewright:change event when you edit
navigation code.
- Export to PDF if asked — see
references/export-pdf.md.
Put each deck in its own folder. Keep any live-demo app as a separate project, not inside
the deck.
Choosing a track
| Pick |
When |
Reference |
| Plain HTML |
Zero setup wanted; runs by opening a file; quick deck; shareable anywhere; no toolchain. Gets unwieldy past ~15–20 rich slides. |
references/html-track.md |
| Vite + React |
Many slides, reusable components, state-driven interactions, TypeScript, Framer Motion, maintained/re-run talks. |
references/react-track.md |
Both produce the same projected experience and obey the same design system; they differ
only in implementation.
Scaffolding
Plain HTML — single self-contained index.html, Tailwind via CDN, no build:
bash scripts/new-html-deck.sh <deck-name> [target-dir] [--title "Deck title"]
Vite + React — scaffolds with the official Vite tool and installs the latest
React, Tailwind, Framer Motion, and Lucide (versions are intentionally not pinned, so
each deck starts on current tooling), then layers the App → Deck → Slide architecture:
bash scripts/new-react-deck.sh <deck-name> [target-dir] [--no-install]
cd <deck-name> && npm run dev
Both scaffolds include the phone remote (slidewright-remote.mjs, zero dependencies).
For a deck scaffolded before the remote existed:
bash scripts/add-remote.sh <path-to-deck>
After scaffolding, read the matching track reference for how slides are structured and how
to add/reorder them, then build the content.
Files in this skill
references/design-system.md — projection rules, typography floor, layout recipes,
motion, palette. The core; consult for any content/design work.
references/deck-types.md — the six deck types and each one's arc, voice, and
prohibitions. Read it before writing slide content.
references/html-track.md — plain-HTML deck structure, template internals, adding slides.
references/react-track.md — Vite+React architecture, slide ordering, Tailwind wiring.
references/export-pdf.md — PDF export options and speaker-notes convention.
references/remote-control.md — phone remote: running it, the deck API contract,
security, troubleshooting (wrong IP, firewall, venue Wi-Fi).
scripts/new-html-deck.sh — scaffold a plain-HTML deck.
scripts/new-react-deck.sh — scaffold a Vite + React deck.
scripts/add-remote.sh — add the phone remote to an existing deck.
assets/remote/slidewright-remote.mjs — the phone remote: WebSocket relay, remote
page, terminal QR code, static server (HTML track) and Vite plugin (React track).
The scaffolds copy it into each deck; edit this source, not the copies.
scripts/export-deck-pdf.py — export a deck to a content-complete PDF (waits for render
and reveals hidden content; image-based).
scripts/verify-slides.sh — static analysis of deck files: flags text below the
typography floor, fixed-px font sizes, excessive bullet counts, and high word density
per slide. Run after building slides and before handoff.
1---2name: slidewright3description: >-4 Build interactive presentation websites — slide decks projected to a room, controlled5 by one presenter. Use this skill WHENEVER the user wants to create, build, or design a6 presentation, slide deck, talk, or "bài thuyết trình / slide / trình chiếu", and also7 when they ask to add/edit slides, restyle a deck, scaffold a new presentation project,8 reuse their presentation setup in another repo, control slides from a phone (remote,9 QR code, "điều khiển slide bằng điện thoại"), or export slides to PDF — even if they10 don't say the word "slide" but clearly need projected talk visuals (e.g. "I'm giving a11 talk next week and need visuals", "dựng deck cho buổi chia sẻ", "làm mấy trang chiếu12 cho hội thảo"). Supports two tracks: a zero-build single HTML file, or a Vite + React13 project. Do NOT use it for printable documents, normal web apps, or dashboards meant14 for individual users to interact with.15metadata:16 source: https://skillmd.com/skills/tuyv/slidewright17---1819# Interactive presentation builder2021Build slide decks that run as a website and are **projected to a room**. The deck is the22visual half of a talk; the presenter does the talking. Two ways to build, one shared23design language.2425## First, the mental model (read before writing any code)2627There is **one operator** (the presenter) on **one machine**. Slides go on a big screen;28the audience only **looks** — they never click, type, or interact. Everything below29follows from this. Four failure modes to avoid:3031- **Text too small.** Slides are read from across a room, not on a laptop. Never use32 web-reading sizes (`text-sm`, `16px`) or fixed Tailwind text classes (`text-4xl`).33 Always use fluid `clamp()` so text scales with the screen. Honour the typography floor34 (body ≈ 30–36px, never below 28px on a 1080p canvas). See `references/design-system.md`.35- **Content hugging an edge.** Padding is a two-layer contract. Slide content must stay36 inside the viewport safe area, and content inside a card, panel, callout, bordered box,37 or other visible container must stay inset from that container's own edge. A parent38 slide's padding does not protect a nested container; `gap` and child margins are not a39 substitute for the container's own padding. Both scaffolds provide safe-area padding40 and a `.slide-surface` inset helper. Even `fullBleed` slides keep text content inset.41- **Building an app.** No input fields, no "Submit", no login, no data collection — there42 is no backend and nowhere for data to go. Interaction is only the presenter clicking to43 reveal/advance content. If a component asks "where does this data go?", it's wrong.44- **Wrong voice for the audience.** A board report is not a lesson and a pitch is not a45 status update. The deck type sets the structure and the voice. Decide it first — see46 `references/deck-types.md`.4748The presenter may hold a **phone remote** (scan a QR code from the terminal, then tap49Next/Prev). It is the same single operator on a second device, not audience interaction.5051`references/design-system.md` is the heart of this skill — the typography floor, two-layer52padding contract, content overflow, layout recipes, motion, and palette. Read it whenever53you design or restyle slide content.5455## Workflow56571. **Understand and clarify the talk.**58 - **Content:** If the presentation content is vague or unclear, ask questions to clarify the topic, audience, speaker (name/role), and key message before building. For Vietnamese content, the default voice is plain, honest, direct — no marketing hype.59 - **Deck type:** Decide what the deck is for before writing: report upward, decision request, pitch, training, talk, or internal update. Infer it from the request and tell the user your choice in one line; ask only when two types fit equally. Then read `references/deck-types.md` and follow that type's arc, voice, and prohibitions.60 - **Style:** Ask the user for their preferred visual style and suggest these 5 modern options:61 1. *Minimalist Bauhaus*: High contrast, geometric typography, generous whitespace.62 2. *Dark Mode Cinematic*: Deep slate/black backgrounds, dramatic contrast, glowing accents.63 3. *Editorial / Magazine*: Sophisticated font pairings (serif + sans), structured grid layouts.64 4. *Glassmorphism*: Soft background gradients with blurred, translucent content panels.65 5. *Neo-Brutalism*: Bold typography, raw borders, hard shadows, high energy.662. **Pick a track** (below). If unsure, ask once; otherwise default to plain HTML for67 small/quick decks and React for substantial, maintained talks.683. **Scaffold** with the matching script — don't hand-assemble the boilerplate.694. **Build slides** in the arc and voice of the deck type, following70 `references/design-system.md`: one idea per slide, few71 words, real visuals, projection-legible type, presenter-only interaction, and the72 two-layer padding contract for both viewport and content containers. Respect the73 density limits — never exceed 5 bullets, ~60 words, or 5×4 table cells per slide.74 If content doesn't fit at the typography floor, split into more slides — never shrink75 past the floor and never produce a slide that scrolls vertically.765. **Keep the required chrome:** a visible bottom navigation slider (dot strip) and slide77 number. Both scaffolds include it — don't remove it.786. **Write speaker notes** in the `<deck-name>-notes.md` file the scaffold creates (never79 on the slides themselves).807. **Run the verify script** to catch text-too-small and content-too-dense violations:81 ```bash82 bash /mnt/skills/user/slidewright/scripts/verify-slides.sh <path-to-deck>83 ```84 Fix every reported issue before proceeding.858. **Run the spacing audit before handoff.** Check every slide at 1920×1080 and at one86 smaller viewport. No text or primary content may cross the viewport safe area. For87 every element that draws a visible boundary (`background`, `border`, `outline`,88 `shadow`, rounded surface, or text-overlay panel), verify that its content has89 padding on all four sides. Media and purely decorative edge-to-edge layers are the90 only exceptions; text over them belongs in a nested padded surface.919. **Tell the user how to present with the phone remote.** Both scaffolds include it.92 The HTML track runs `node <deck>/slidewright-remote.mjs`. The React track runs `npm run dev`.93 The terminal prints a QR code for the phone. See `references/remote-control.md`.94 Keep the deck's `window.slidewright` API and `slidewright:change` event when you edit95 navigation code.9610. **Export to PDF** if asked — see `references/export-pdf.md`.9798Put each deck in its own folder. Keep any live-demo app as a separate project, not inside99the deck.100101## Choosing a track102103| Pick | When | Reference |104| --- | --- | --- |105| **Plain HTML** | Zero setup wanted; runs by opening a file; quick deck; shareable anywhere; no toolchain. Gets unwieldy past ~15–20 rich slides. | `references/html-track.md` |106| **Vite + React** | Many slides, reusable components, state-driven interactions, TypeScript, Framer Motion, maintained/re-run talks. | `references/react-track.md` |107108Both produce the same projected experience and obey the same design system; they differ109only in implementation.110111## Scaffolding112113**Plain HTML** — single self-contained `index.html`, Tailwind via CDN, no build:114115```bash116bash scripts/new-html-deck.sh <deck-name> [target-dir] [--title "Deck title"]117```118119**Vite + React** — scaffolds with the official Vite tool and installs the **latest**120React, Tailwind, Framer Motion, and Lucide (versions are intentionally not pinned, so121each deck starts on current tooling), then layers the `App → Deck → Slide` architecture:122123```bash124bash scripts/new-react-deck.sh <deck-name> [target-dir] [--no-install]125cd <deck-name> && npm run dev126```127128Both scaffolds include the phone remote (`slidewright-remote.mjs`, zero dependencies).129For a deck scaffolded before the remote existed:130131```bash132bash scripts/add-remote.sh <path-to-deck>133```134135After scaffolding, read the matching track reference for how slides are structured and how136to add/reorder them, then build the content.137138## Files in this skill139140- `references/design-system.md` — projection rules, typography floor, layout recipes,141 motion, palette. The core; consult for any content/design work.142- `references/deck-types.md` — the six deck types and each one's arc, voice, and143 prohibitions. Read it before writing slide content.144- `references/html-track.md` — plain-HTML deck structure, template internals, adding slides.145- `references/react-track.md` — Vite+React architecture, slide ordering, Tailwind wiring.146- `references/export-pdf.md` — PDF export options and speaker-notes convention.147- `references/remote-control.md` — phone remote: running it, the deck API contract,148 security, troubleshooting (wrong IP, firewall, venue Wi-Fi).149- `scripts/new-html-deck.sh` — scaffold a plain-HTML deck.150- `scripts/new-react-deck.sh` — scaffold a Vite + React deck.151- `scripts/add-remote.sh` — add the phone remote to an existing deck.152- `assets/remote/slidewright-remote.mjs` — the phone remote: WebSocket relay, remote153 page, terminal QR code, static server (HTML track) and Vite plugin (React track).154 The scaffolds copy it into each deck; edit this source, not the copies.155- `scripts/export-deck-pdf.py` — export a deck to a content-complete PDF (waits for render156 and reveals hidden content; image-based).157- `scripts/verify-slides.sh` — static analysis of deck files: flags text below the158 typography floor, fixed-px font sizes, excessive bullet counts, and high word density159 per slide. Run after building slides and before handoff.