From 5687c22b40e756f383bf9251fb26c36451280159 Mon Sep 17 00:00:00 2001 From: TJ <11341191+thomwebb@users.noreply.github.com> Date: Sat, 31 Oct 2026 11:54:08 -0700 Subject: [PATCH 1/2] Add a static blog section with RSS and unpublished article template --- .github/workflows/check.yml | 28 ++++ .gitignore | 4 + AGENTS.md | 12 +- README.md | 15 +- public/blog/feed.xml | 10 ++ public/blog/index.html | 297 +++++++++++++++++++++++++++++++++ public/index.html | 4 +- tests/test_site.py | 73 +++++++++ tools/BLOG.md | 17 ++ tools/blog-post-template.html | 298 ++++++++++++++++++++++++++++++++++ tools/check_browser.py | 65 ++++++++ 11 files changed, 815 insertions(+), 8 deletions(-) create mode 100644 .github/workflows/check.yml create mode 100644 public/blog/feed.xml create mode 100644 public/blog/index.html create mode 100644 tests/test_site.py create mode 100644 tools/BLOG.md create mode 100644 tools/blog-post-template.html create mode 100644 tools/check_browser.py diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml new file mode 100644 index 0000000..ddcf221 --- /dev/null +++ b/.github/workflows/check.yml @@ -0,0 +1,28 @@ +name: Check static site +on: + pull_request: + push: + branches: [main] +permissions: + contents: read +jobs: + check: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - run: python3 -m unittest discover -s tests -v + - name: Install browser test tools (not site dependencies) + run: | + python3 -m pip install playwright==1.56.0 + python3 -m playwright install --with-deps chromium + - name: Check browser behavior + run: python3 tools/check_browser.py + - uses: actions/upload-artifact@v4 + if: always() + with: + name: blog-screenshots + path: preview/blog-*.png + if-no-files-found: ignore diff --git a/.gitignore b/.gitignore index 17fc24f..748a9a3 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,7 @@ node_modules/ .DS_Store preview/ + +# Unpublished writing stays local, outside deployed assets. +drafts/ +__pycache__/ diff --git a/AGENTS.md b/AGENTS.md index 7980d25..cc298e7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ Guidance for AI coding agents working in this repository. ## Project overview -Source for [tjwebb.dev](https://tjwebb.dev) — TJ Webb's personal portfolio site. It is a **single self-contained `index.html`** with inline CSS and JS, no build step, no dependencies, and no package manifest (`package.json`, `pyproject.toml`, etc. do not exist). +Source for [tjwebb.dev](https://tjwebb.dev) — TJ Webb's personal portfolio site. It is **self-contained static HTML pages** with inline CSS and JS, no build step, no dependencies, and no package manifest (`package.json`, `pyproject.toml`, etc. do not exist). The site has a terminal aesthetic and includes: @@ -14,7 +14,9 @@ The site has a terminal aesthetic and includes: ## Repository layout -- `public/index.html` — the entire site (markup, styles, scripts all inline). +- `public/index.html` — the portfolio (markup, styles, scripts all inline). +- `public/blog/index.html` and `public/blog/feed.xml` — blog index and RSS feed. +- `tools/blog-post-template.html` and `tools/BLOG.md` — unpublished placeholder template and authoring guide. Never commit unapproved writing to this public repo; keep it in gitignored `drafts/`. - `public/fonts/` — JetBrains Mono Regular/Bold `.woff2`, self-hosted. - `public/og-card-v2.png` — social share card (1200x630). **Version the filename when it changes** (e.g. `og-card-v3.png`) and update the `og:image` / `twitter:image` meta tags to match, so cached cards are invalidated. - `public/projects/` — currently empty. @@ -25,19 +27,19 @@ The site has a terminal aesthetic and includes: ## Tech stack and runtime architecture -- Plain HTML/CSS/vanilla JS (ES5-style `var`, no modules, no frameworks). Everything is inlined in `public/index.html`; the only external requests are the two font files. +- Plain HTML/CSS/vanilla JS (ES5-style `var`, no modules, no frameworks). CSS and JS are inlined in each HTML page; the only external requests are the two font files. - Runtime: Cloudflare Workers **static assets** — there is no Worker script (`wrangler.jsonc` has no `main` entry), so requests are served directly from the asset store. ## Build, test, and deploy -- **No build step and no test suite.** Verification is manual: open `public/index.html` in a browser (or serve `public/` with any static server) and check the themes, the theme toggle, and the cat's behavior — including `prefers-reduced-motion` emulation and narrow viewports. +- **No build step.** Run `python3 -m unittest discover -s tests -v` for static checks (also run in PR CI). Browser verification remains manual: open `public/index.html` in a browser (or serve `public/` with any static server) and check the themes, the theme toggle, and the cat's behavior — including `prefers-reduced-motion` emulation and narrow viewports. - Local preview with Wrangler: `npx wrangler dev` (serves `public/` per `wrangler.jsonc`). - Deploy happens by pushing to `main`: GitHub Actions runs `cloudflare/wrangler-action@v3` with `command: deploy`. Manual deploy: `npx wrangler deploy`. - Wrangler is **pinned to 4.120.1** in the workflow — do not bump blindly; the pin comment notes 4.121.0 depends on an unpublished `miniflare@5.20260804.1-alpha`. Check that this is resolved before upgrading. ## Code style guidelines -- Keep the single-file architecture: new styles go in the existing ` + + + + +
+
+

$ ls ~/blog

+

Blog

+

Software engineering, agent harnesses, and developer tools.

+ +
+
+
+

posts

+

No posts yet. New writing will appear here.

+
+
+ +
+ + + diff --git a/public/index.html b/public/index.html index 62be55c..99a082e 100644 --- a/public/index.html +++ b/public/index.html @@ -5,6 +5,7 @@ TJ Webb — Principal Software Engineer + @@ -358,7 +359,8 @@

TJ Webb

// Principal Software Engineer

I build agent harnesses and developer tools. Creator of gac (125k+ downloads). Principal engineer working on Code Puppy, an open-source AI coding agent.

-