poli0981andClaude Fable 5.2 24d7c1b117 test(a11y): wider coverage, status checks, and claims that match it
Every sitemap page is checked for sideways scrolling at 320px; the light-theme and phone scans cover a page of every template; a page that does not answer the expected status fails instead of being scanned as an error page; the search focus trap is exercised with results listed; the legal notice is checked at tablet and small-laptop sizes; the story reader is walked backwards with Shift+Tab; each half of a legal page must declare its language. ACCESSIBILITY.md says what the palette test and the suite actually cover, and that the live widgets are not in the test build. CI prints the preview log when the job fails.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 08:27:12 +07:00

poli0981.dev

CI Quality Gate License: GPL-3.0

The personal site of Kokone (SkullMute) — dev portfolio, blog, short fiction and a hub for the SkullMute channel, in Vietnamese and English. Live at poli0981.dev.

Trang cá nhân của Kokone (SkullMute): dự án, blog, truyện ngắn và kênh SkullMute — song ngữ Việt/Anh. Tài liệu thiết kế đầy đủ (tiếng Việt) nằm trong poli0981.dev-docs/.

Stack

Layer Choice
Framework Astro 7 (static-first) with Svelte 5 islands
Styling Tailwind CSS 4, design tokens in src/styles/global.css ("Glacier Teal" palette)
Hosting Cloudflare Workers + Static Assets; KV, R2, Images, Rate Limiting, Access, Turnstile
Content Markdown/MDX in poli0981/content (git submodule src/content)
Search Pagefind (built after astro build)
Tooling Node 26 · TypeScript 7 (tsc) next to TypeScript 6 (astro check, typescript-eslint) · node:test · ESLint · Prettier · knip
Quality SonarCloud quality gate · CodeQL · OSV-Scanner · Snyk · Dependabot (3-day cooldown) · axe-core accessibility gate

How it fits together

visitor ─▶ Cloudflare edge ─▶ src/worker.ts (every request, pages included)
            www → apex · IP denylist (KV) · admin host split · /media (R2) · /ext-img (KV)
            Turnstile gate (48-hour pass) · static pages from ASSETS · the rest → Astro app
                                                                      ├─ /api/report, /api/gate, /api/widgets, /api/health
                                                                      └─ admin.poli0981.dev (Cloudflare Access + JWT check)
workers/widgets (cron, every 45 min) ─▶ YouTube / Steam / GitHub ─▶ KV (data + mirrored images)

Almost every page is prerendered. The Worker entry runs first for every route so the bot gate, the denylist and the security headers also cover static pages. Details: 02_ARCHITECTURE.md and 06_SECURITY.md.

Getting started

Requirements: Node 26 (.nvmrc) and npm 11. The content submodule is public, so a plain clone works.

git clone --recurse-submodules https://github.com/poli0981/poli0981-dev.git
cd poli0981-dev
npm ci --ignore-scripts && npm run check-install-scripts
npx lefthook install
npm run types && npm run types:widgets
npm run dev

npm run dev runs Astro on workerd with local bindings. The admin works locally with a stand-in identity (dev@localhost); saving content needs a GITHUB_CONTENT_TOKEN in .dev.vars.

Commands

Command What it does
npm run dev Dev server (workerd, local KV/R2)
npm run build astro build → OG images → Pagefind index → CSP hash check
npm run preview Serve the build
npm run check astro check (TypeScript 6 language service)
npm run typecheck tsc from TypeScript 7 for the site and the widgets worker
npm run lint · npm run format:check · npm run knip ESLint · Prettier · unused files/exports
npm test · npm run test:coverage node:test suites; coverage writes coverage/lcov.info (80% line floor)
npm run smoke Runs the built Worker with wrangler dev and probes pages, headers, the gate and the denylist
npm run test:a11y axe-core, keyboard, reflow and forced-colours checks against npm run preview (Chrome)
npm run probe:ratelimit -- [url] [requests] [parallel] Spams a live URL and counts 429s from the Worker's site-wide limit vs. the WAF rule
npm run new:post Scaffold a post or story from docs/templates/
npm run check-exif · npm run strip-exif Refuse / remove GPS and camera metadata in images
npm run gen-notices Regenerate THIRD-PARTY-NOTICES.md (CI checks it)

Deploying

Cloudflare Workers Builds builds every push: main runs npx wrangler deploy, any other branch only npx wrangler versions upload (a preview version that takes no traffic). After a merge, https://poli0981.dev/api/health reports the running version and commit. The widgets worker deploys by hand: npx wrangler deploy --config workers/widgets/wrangler.jsonc. Setup from scratch: 07_CLOUDFLARE_SETUP.md; pipeline: 08_CI_CD.md; changes per release: CHANGELOG.md.

Admin

admin.poli0981.dev is the owner's editor: write and edit posts (commits to the content repo), upload images (transformed once into AVIF/WebP and stored in R2), manage gallery albums, publish (opens a submodule-bump PR that CI must pass), review an audit log and manage the IP denylist. It sits behind Cloudflare Access, and the Worker independently verifies the Access JWT (≤ 24 hours old) and an email allowlist on every request.

Security

Please report vulnerabilities privately — see SECURITY.md. Bug reports from the site's "Report a bug" button land in a private repository, not in this one's issues.

Accessibility

The site aims for WCAG 2.2 AA and checks it on every pull request (axe-core over every page, plus keyboard, reflow and forced-colours tests). What is in place, what is known not to work and how to report a barrier: ACCESSIBILITY.md; the statement for visitors is at /legal/accessibility. Barriers can be reported to accessibility@poli0981.dev.

License

S
Description
No description provided
Readme GPL-3.0
7.9 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 51.9%
Astro 19.4%
Svelte 16.3%
JavaScript 9.9%
CSS 2.5%