Create Your First `.stage` Deck

This tutorial packages a minimal HTML deck into a .stage file and verifies it for SlideStage Lite or Pro.

Prerequisites

• Node.js 20 or newer.
• slidestage-pack scripts.
• An HTML deck folder.

1. Create a sample deck

Create my-deck/index.html with a <div class="deck"> and one or more <section class="slide"> elements.

Speaker notes can use <aside class="notes">.

2. Detect the framework

node scripts/detect_framework.mjs my-deck

For an inline deck, the result should include:

{
  "kind": "inline-deck",
  "recommendedMode": "split"
}

3. Pack

node scripts/pack_stage.mjs --src my-deck --out my-deck.stage

The packer writes manifest.json, slide HTML files, assets, notes, and deterministic zip metadata.

4. Verify

node scripts/verify_stage.mjs my-deck.stage

Verification checks the zip, manifest, slide files, paths, sizes, and slide indexes.

5. Play or upload

Open the file in SlideStage Lite or upload it to SlideStage Pro.

For reveal.js or impress.js, prefer wrap mode unless you explicitly want static split slides.