NextDemo
installation

Let's get you filming.

Your agent films your app — describe the shot, it writes and runs the recording. Three steps to your first take.

  1. 01

    Install

    An npm package plus a skill your agent reads. Let it set everything up — paste this in:

    Install https://nextdemo.app/install.md
    works with any agent —Claude Code
    What it does›

    The agent works from a short checklist and approves each step with you as it goes:

    • Checks for Node.js 22+ and ffmpeg, installing them if they're missing
    • Installs the nextdemo package and the recording skill
    • Activates your license
    • Records a quick verification clip of nextdemo.app to prove the pipeline works end-to-end
    • Asks what you'd like to film first
    Manual installation›

    Prefer to wire it up yourself? Pick your OS:

    1. Node.js 22+
      terminal
      brew install node@22            # or download from nodejs.org
    2. ffmpeg
      terminal
      brew install ffmpeg
    3. NextDemo + the skill
      terminal
      npm install nextdemo
npx skills add tomasbonco/nextdemo
npx nextdemo activate <license-key>
npx nextdemo --version
      npm, pnpm and yarn all work.
    Troubleshooting›
    • "Node version too old." NextDemo needs Node 22+. Check node -v and upgrade — nvm makes it painless.
    • ffmpeg not found. Install it (see the manual steps above); it must be on your $PATH.
    • Your agent or editor doesn't support skills. The skill is just a guide file. Run npx nextdemo skill and paste its output into your prompt — do that at the start of each new conversation and any agent can write NextDemo scripts.
      terminal
      npx nextdemo skill   # paste the output into your agent
    • Electron won't launch on Linux. Install the system libraries:
      terminal
      npx playwright install-deps
    • License won't activate. It may still be tied to another machine — run npx nextdemo deactivate there, or email support.
  2. 02

    Activate

    Paste the key from your purchase email.

    terminal
    npx nextdemo activate <license-key>

    Tied to your machine — npx nextdemo deactivate frees the slot for a new device.

    Don't have a license yet?›
    Grab one — Get NextDemo →
    Where do I find my license key?›
    In your Lemon Squeezy receipt — the email sent right after checkout.
    How do I cancel or manage my subscription?›
    Use the Lemon Squeezy customer portal → and sign in with your purchase email.
    How do I get a refund?›
    Within 14 days, request one here →.
  3. 03

    Roll camera

    Open your agent in your project and ask for a shot — this one works for any app:

    Using the NextDemo skill, record a 20-second video of the most common flow our project offers. Use our brand colors and voice if available; otherwise use a grayish gradient as the background.
    Everything you can direct→
going further

Record in a pipeline

Headless on Linux, in Docker, and in GitHub Actions — NextDemo auto-spawns Xvfb, so there's no X server to wire up.

terminal
# Mint a long-lived token once, from any machine with the CLI:
npx nextdemo generate-token <license-key>

Store the printed JWT as a secret named NEXTDEMO_LICENSE_TOKEN. It auto-refreshes, so one secret keeps working — no re-activating per job.