---
title: Cloudflare Pages Workflow
section: infra
summary: Steps to publish the static notes site to Cloudflare Pages using the provided workflow and build output.
tags: [cloudflare, ci, deploy]
nav: 1
---

# Cloudflare Pages Workflow

## Overview

This note captures the build and deploy flow for the static notes site. The site compiles Markdown into static HTML under the `dist/` directory.

## Build steps

1. Install dependencies: `npm install`.
2. Generate the site: `npm run build`.
3. Upload the `dist/` output to Cloudflare Pages.

## Environment

- Node 20+ is recommended.
- CI uses `npm ci` and `npm run build` from the default branch.

## Tips

- Keep content in `content/` with front matter to expose metadata.
- The build bundles a `search-index.json`; avoid storing secrets in front matter.
- Regenerate locally before pushing to preview changes.