JSter - Website v2

This repository contains the source for jster.net.

Usage

See npm run for available build targets.

Publishing to Buttondown

Create a Buttondown API key with write access to emails and add it to .env (or export it in your shell):

BUTTONDOWN_API_KEY=...

The latest JSter issue is selected automatically. The command creates a draft unless sending or scheduling is explicitly requested:

npm run publish:buttondown -- --dry-run
npm run publish:buttondown
npm run publish:buttondown -- --post 258
npm run publish:buttondown -- --send
npm run publish:buttondown -- --schedule 2026-08-04T09:00:00Z

For a platform account with multiple newsletters, also set BUTTONDOWN_NEWSLETTER_ID to the target newsletter UUID. Immediate or scheduled publishing requires sending permission on the API key.

Cloudflare build cache

Cloudflare uses the previously deployed site as Gustwind's cache source:

npm run build:cloudflare

That reads https://jster.net/.gustwind/build-cache.json and reuses route outputs from the deployed site when their fingerprints still match.

Testing CF

1. npm run build && npm run copy:css && npm run generate:manifest
2. npm run workers:dev
3. Head to http://localhost:8787/library/jquery

The Worker serves static assets from ./build and dynamic catalog routes from worker.ts.