AI-first fixed-layout document framework. Creative skills decide what to make; OpenPress handles the workbench, inline editing, comment markers, rendering, PDF/image/Word export, and deploy plumbing.
OpenPress is for artifacts where content keeps changing but the output format must stay stable: proposals, whitepapers, reports, course notes, books, social cards, and slide decks.
Prerequisite: Node.js 20 or newer. Use Node.js 24 for framework development and Cloudflare Pages builds.
npm create @open-press my-deck -- --type slides
cd my-deck
npm run devThe create package installs the framework packages and OpenPress skills. Open the local Vite URL, usually http://127.0.0.1:5173/workspace.
Open the workspace in a skill-aware agent such as Claude Code or Codex CLI:
claude
# or
codexThen ask naturally:
我想寫一份投資人提案，幫我起手。Creation is split by artifact type:
openpress-create-pagescreates page-based documents.openpress-create-slidecreates slide decks.openpressowns CLI lifecycle, validation, rendering, export, and routing.openpress-upgradeowns package upgrades and workspace migration QA.
For Copilot Chat or other tools that do not auto-discover SKILL.md, see manual agent setup.
npm create @open-press installs skills automatically. To install or update them separately:
# Install
npx skills add quan0715/open-press
# Update to latest
npm run openpress:skills
# or, in core-only workspaces:
node node_modules/@open-press/core/engine/cli.mjs skills:sync .Skills land in .agents/skills/ (universal) and .claude/skills/ (Claude Code). They are read automatically by Claude Code, Cursor, Codex, Gemini CLI, Cline, Warp, and most other skill-aware agents — no manual loading required.
Use these when the agent does not yet have the OpenPress skills installed.
Create a new workspace (empty folder, no skills):
Run `npx skills add quan0715/open-press` to install the OpenPress skills.
Once installed, use the openpress-create-pages or openpress-create-slide skill
to set up a new workspace or add a Press to this folder.Upgrade an existing workspace:
Use the openpress-upgrade skill.
It updates framework packages and skills, reads applicable migration docs,
scans press/ source, applies confirmed migrations, and loops through Migration QA.- Fixed-layout pages: A4, social formats, slide 16:9, or custom presets.
- Press Tree rendering from folder entries such as
press/slide/press.tsx. - Multi-Press workspaces: documents, cards, and slides in one project.
- Tailwind-first authoring with OpenPress semantic slide classes and protocol layouts.
- Local workbench with preview, comments, mentions, and image export.
- PDF/Word export and Cloudflare Pages deploy workflow.
- Portable skills under
.agents/skills/and.claude/skills/.
This repo includes a tracked dogfood workspace in press/.
pnpm run dev:workspace # dogfood press / workbench
pnpm run dev:web # open-press.dev landing site
pnpm run build # render every Press
pnpm run openpress:pdf # export PDF
pnpm run openpress:word # export Word DOCX| Want to | See |
|---|---|
| CLI commands | docs/cli.md |
| Press Tree model | docs/press-tree.md |
| Workbench UI | docs/workbench.md |
| Skills and routing | docs/skills.md |
| Release / deploy | docs/release-and-deploy.md |
| Contribute | CONTRIBUTING.md and AGENTS.md |
| Changelog | CHANGELOG.md |
MIT - see LICENSE.