#Deployment

zpress builds to static HTML — deploy it anywhere that serves static files.

#Build

Generate the production site:

zpress build

Output is written to .zpress/dist/. Pass --clean to remove previous build artifacts first:

zpress build --clean

#Preview

Preview the production build locally before deploying:

zpress serve

This starts a local static file server pointed at .zpress/dist/. The browser opens automatically (use --no-open to disable).

#Static hosting

Point your hosting provider at the .zpress/dist/ directory. zpress produces a standard static site — no server runtime required.

Common providers:

#CI/CD

Example GitHub Actions workflow:

name: Deploy Docs
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: pnpm
      - run: pnpm install --frozen-lockfile
      - run: pnpm zpress build
      - uses: actions/upload-pages-artifact@v3
        with:
          path: .zpress/dist

Adapt the final step to your hosting provider's deployment method.

#Gitignore

Add zpress output directories to .gitignore — they are regenerated by sync and build:

.zpress/content/
.zpress/dist/
.zpress/cache/

#References

• CLI reference — build
• CLI reference — serve
• CLI reference — clean