# Publish the Cloudflare Master Knowledge Base

The project is static: it needs no database, API keys, server-side code, or build process after the deployment package has been created.

## Fastest method: Cloudflare Pages Direct Upload

Use the provided `Cloudflare-Master-Knowledge-Base-Site.zip`.

1. Sign in to Cloudflare.
2. Open **Workers & Pages**.
3. Choose **Create application** and the **Direct Upload / drag-and-drop** option.
4. Enter a project name, such as `cloudflare-master-guide`.
5. Upload the deployment ZIP or its unzipped folder.
6. Select **Deploy site**.
7. Cloudflare will provide a `pages.dev` address. Add a custom domain from the project settings when ready.

Cloudflare’s current Direct Upload documentation says dashboard drag-and-drop accepts a ZIP file or a folder. A Direct Upload project cannot later be converted into a Git-integrated Pages project; create a separate project if automatic Git deployments become important.

Official documentation: https://developers.cloudflare.com/pages/get-started/direct-upload/

## Recommended editable method: Workers Static Assets with Wrangler

The source project is already configured for Workers Static Assets.

```bash
npm install
npm run build
npx wrangler login
npm run deploy
```

Wrangler uploads the `dist/` directory specified in `wrangler.jsonc`. No Worker script is necessary because this is an assets-only site.

Official documentation: https://developers.cloudflare.com/workers/static-assets/

## Temporary preview

Recent Wrangler releases support a temporary deployment and claim flow:

```bash
npm install
npm run deploy:temporary
```

Wrangler prints a preview URL and claim instructions.

## Updating the site

1. Edit Markdown files in `content/` or the interactive guide files in `guide/`.
2. Rebuild generated pages with `npm run content:build`.
3. Build the deployment directory with `npm run build`.
4. Redeploy through Wrangler or upload the updated `dist/` folder through your chosen Cloudflare workflow.

## Custom domain

After deployment, attach a domain or subdomain such as:

- `cloudflare-guide.outsourceaccess.com`
- `knowledge.outsourceaccess.com/cloudflare`
- `cloudflare.bradscommandcenter.com`

Use Cloudflare Access if the archive should be restricted to employees or selected clients.