deckgen-local

A contract-first local deck generator for Markdown, source packages, HTML previews, and optional PPTX exports.

Contract

Shared deck schema

Normalizes article, report, note, and Markdown sources into one validated deck contract.

Render

HTML and PPTX outputs

Creates browser-preview decks and can hand the same contract to a local PPTX exporter.

Quality

Run-bundle smoke gates

Checks request metadata, source manifests, deck contracts, output files, and optional visual gates.

Boundary

Local-first packaging

Keeps generated artifacts and private source packages out of the public repository.

Quick Start

npm install
npm test
node src\cli\deckgen.mjs generate --source fixtures\generic-markdown\briefing.md --profile briefing --output html

Demo Run

Input

Public fixture

fixtures/generic-markdown/briefing.md

Contract

Four-slide briefing

Generates a validated deck_contract.json with source references and HTML output intent.

Output

Ignored run bundle

.tmp/deckgen/<run-id>/html/index.html

Read the public-safe demo runbook for the sample result shape, bundle map, and smoke command.

Public Safety

Designed for local and cross-repo workflows where source truth stays in the source package and render logic stays in one deck generator.