# Deploy

> Deploy the joost-blog site. Regenerates the NLWeb search index (including embeddings), commits changes, and pushes to trigger a Cloudflare Pages deploy.

- Skill: `jdevalk/deploy` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jdevalk/deploy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jdevalk/deploy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: jdevalk (https://skillmd.com/u/jdevalk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jdevalk/deploy

---


# Deploy

Deploys the joost-blog site to Cloudflare Pages.

## What it does

1. Fetches YouTube transcripts for any new videos (`scripts/fetch-transcripts.mjs`)
   - Uses cached transcripts when the file already exists
   - Requires `yt-dlp` on PATH (install via `brew install yt-dlp`)
2. Regenerates the NLWeb search index (`scripts/generate-nlweb-index.mjs`)
   - Scans all blog posts, pages, and videos
   - Skips draft content
   - Appends each video's transcript to its search body
   - Generates embeddings for new/changed content via Cloudflare API
   - Uses cached embeddings for unchanged content
3. Stages the updated index + any new transcript files
4. Commits with a descriptive message
5. Pushes to origin, triggering the Cloudflare Pages deploy

## Steps

1. Run `node scripts/fetch-transcripts.mjs` and show the output to the user
2. Run `node --env-file-if-exists=.env scripts/generate-nlweb-index.mjs` and show the output
3. Check what changed under `src/generated/` with `git status --short src/generated/`
4. Stage: `git add src/generated/nlweb-index.json src/generated/nlweb-index.mjs src/generated/embedding-cache.json src/generated/transcripts/` (plus any other staged content the user is shipping)
5. Run `git status` to show the user what will be deployed
6. Ask the user for a commit message (suggest one based on what changed)
7. Commit and push to origin
8. Confirm the deploy was triggered

## Notes

- The `CF_API_TOKEN` and `CF_ACCOUNT_ID` environment variables must be available for embedding generation; they live in `.env`. Pass `--env-file-if-exists=.env` to Node so the script picks them up.
- The prebuild step was removed from package.json — the index must be regenerated locally before deploying.
- If only code changes (no content changes), the index regeneration will show "0 to generate" and the cached index is reused.
- `fetch-transcripts.mjs` is a no-op for videos that already have a cached transcript, so it's safe to run on every deploy.