posts
+No posts yet. New writing will appear here.
+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 ` + +
+Skip to content + +$ ls ~/blog
+Software engineering, agent harnesses, and developer tools.
+ +No posts yet. New writing will appear here.
+