openpress-deploy

Original：🇺🇸 English

Translated

Use when preparing, configuring, checking, staging, or publishing an open-press document to public hosting, especially Cloudflare Pages, deploy setup, deploy buttons, deploy status, public release checks, or safe deployment workflow.

5installs

Sourcequan0715/open-press

Added on2026-08-29

NPX Install

npx skill4agent add quan0715/open-press openpress-deploy

SKILL.md Content

View Translation Comparison →

open-press Deploy

open-press deploy owns the public-release gate. Use it only when the user asks to configure, inspect, dry-run, or publish an open-press document.

Responsibilities

Inspect deploy config in
```
openpress/settings.json
```
under the
```
"deploy"
```
field.
Check target adapter, staging source, project name, and confirmation settings.
Run deploy preflight and dry runs.
Keep secrets out of source files.
Require explicit confirmation before publishing.
Report the public URL and, when included, the PDF URL after successful deploy.

Boundaries

```
openpress
```
owns generic CLI usage, non-deploy validation, local review, and the source/generated boundary.
```
openpress-create-pages
```
owns page artifact content and visual readiness.
```
openpress-create-slide
```
owns slide deck content and visual readiness.
This skill owns public target confirmation and deploy execution.

Public Deploy Rule

Never publish without a clear confirmation that names the target project.

Good confirmation shape:

txt

This will publish the current open-press build to Cloudflare Pages project `<projectName>` from `<deploy.source>`.
Do you want me to deploy now?

Preflight

Before real deploy, run the commands that prove the output is ready:

bash

npm run build              # validates + renders dist-react/

Also scan public-facing source for unfinished markers:

bash

rg "\\[TODO:|\\[FIX:|\\[DRAFT:" "press/*/chapters" press/design.md

PDF Size Limit

Cloudflare Pages rejects any single file larger than 25 MB. A multi-press or image-heavy PDF commonly exceeds this limit.

Unless the user explicitly asks to publish the PDF, deploy without it:

bash

npm run openpress:deploy -- --confirm --no-pdf

--no-pdf

skips PDF generation and excludes it from the deploy source entirely.

If the user wants to check the PDF size first:

bash

npm run openpress:pdf
du -sh .deploy/**/*.pdf 2>/dev/null

If the PDF is over 25 MB and the user still wants it publicly hosted, recommend a separate host (Cloudflare R2, S3, etc.). OpenPress does not currently expose an authored external-PDF URL field, so do not invent one in

openpress/settings.json

; report the separate URL in the delivery handoff.

Deploy Commands

Dry run:

bash

npm run openpress:deploy:dry-run -- --no-pdf

Publish after explicit confirmation:

bash

npm run openpress:deploy -- --confirm --no-pdf

Remove

--no-pdf

only when the user explicitly includes the PDF in the confirmed publication target.

When To Read References

Read
```
references/cloudflare-pages.md
```
when creating or repairing Cloudflare Pages config, project setup, Wrangler auth expectations, or UI deploy-button behavior.

openpress-deploy

NPX Install

Tags

SKILL.md Content

open-press Deploy

Responsibilities

Boundaries

Public Deploy Rule

Preflight

PDF Size Limit

Deploy Commands

When To Read References