Perth BitDevs

Website for Perth BitDevs, a monthly socratic seminar exploring Bitcoin development and the broader technical ecosystem.

Pure static HTML hosted on GitHub Pages. No build step, no frameworks.

The deployed site has no runtime dependencies. Local helpers are split between static-site helpers, which only need standard system tools, and optional newswatch planning tools, which use Python dependencies inside .venv.

Structure

• index.html - Landing page with event listings
• about.html - About, rules, and privacy info
• YYYY-MM/index.html - Monthly hub pages linking to topic slides
• YYYY-MM/manifest.json - Current-month source of truth for event and topic metadata
• YYYY-MM/topic-name.html - Individual topic slide pages
• templates/ - Copy sources for new manifests, hubs, decks, archive pages, and auxiliary visual pages

Monthly Manifests

For current and upcoming meetups, update YYYY-MM/manifest.json before changing the month hub or landing page. The manifest records the event date, venue, issue link, topic files, status, summaries, source references, and auxiliary page ownership. Auxiliary pages must name their parent topic with parent_topic. Published pages remain plain static HTML.

Source Templates

Start new monthly content from templates/ rather than copying a previous month by eye. The templates are tracked authoring sources only. They use .html.tmpl so placeholder links are not treated as published pages by local checks.

Copy the relevant template into YYYY-MM/, replace every {{PLACEHOLDER}}, keep the resulting page self-contained, then run just site-check or just check.

Contributing Topics

Submit discussion topics on the GitHub issues.

Local Preview

just dev
just run port=8001

just dev serves the static site on port 8888 by default. just run starts the server, waits until it is responding, opens the browser, and cleans up the server when the command exits. Pass port=NNNN when the default port is already in use.

Newswatch Helper

The repo includes a local Python helper for collecting candidate Bitcoin news from curated sources before each meetup.

just setup-newswatch
just news-scan since=2026-05-07 issue=36
just news-scan-preview since=2026-05-07 issue=36

The scan writes an LLM-ready Markdown packet and matching JSON under tools/newswatch/runs/. Use just news-scan-preview when you want the same packet output without advancing the local state cursor. Add issue=NN to include community topic comments from PerthBitDevs/PerthBitDevs in the same packet as the curated-source scan. Optional local import packets can be merged with scans:

just news-scan since=2026-05-07 issue=36 import=tools/newswatch/imports/local.json

Import packet schema documentation lives in tools/newswatch/imports/README.md. Run outputs and local import packets are planning artefacts and should stay out of git when they contain private or machine-specific content. Source configuration lives in tools/newswatch/sources.json.

Checks

just site-check
just check

just site-check validates local static-site contracts without network access, including link safety for new tabs. just check runs the site checker plus the local newswatch validation and tests.