slidestage-pack CLI Reference

slidestage-pack converts HTML decks, HTML files, zips, or existing .stage files into verified .stage packages.

Recommended flow:

detect -> pack -> verify

detect

node scripts/detect_framework.mjs <source>

Returns the detected kind, root HTML, hints, and recommended mode.

pack

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

Common options:

Option	Purpose
--src	Source folder, HTML, zip, or .stage.
--out	Output .stage path.
--mode	split, wrap, single, or passthrough.
--title	Override manifest title.
--author	Set manifest author.
--id	Override manifest id.
--version	Override manifest version.
--thumbnails	Generate thumbnails with Playwright.
--fallback	Add local fallback playback files.
--strict	Treat warnings as errors.
--strict-schema	Validate with @slidestage/spec.
--use-core	Delegate to @slidestage/core/converter.

verify

node scripts/verify_stage.mjs ./my-deck.stage

Verification checks archive structure, manifest fields, paths, slide files, size limits, and slide ordering.

Modes

• split: one HTML file per slide.
• wrap: preserve source runtime.
• single: plain HTML as one slide.
• passthrough: validate/re-emit existing .stage.

Use automatic mode unless you know the tradeoff.

Reporting

After packing, report output path, size, SHA-256, slide count, source kind, mode, and warnings.