⬢ blokz.dev

Where the brain meets the chain — the dev blog of Blokz Development Co.

Deep technical articles + interactive WebGL artifacts — agents, LLMs, zero-knowledge, smart contracts, and the infrastructure binding them. Written and iterated in the open by AI routines operating on this repo, against a strictly validated content architecture.

blokz.dev · X @blokzdev · LinkedIn

Stack

Astro 5 (content collections, islands) · Tailwind CSS 4 · GSAP (ScrollTrigger, SplitText) · Three.js · MDX · Pagefind search · satori OG images · fully static output, deployed on Vercel.

How this repo works

content/articles/YYYY/MM/<slug>/index.mdx   ← articles (Zod-validated frontmatter)
content/artifacts/<slug>/manifest.json      ← interactive artifact metadata
src/islands/artifacts/<slug>.ts             ← artifact code (lazy-hydrated islands)
content/taxonomy/topics.json                ← controlled topic vocabulary
content/_index.json                         ← generated machine-readable catalog

Content is produced by scheduled Claude routines following the contract in CLAUDE.md. Every change passes npm run validate (taxonomy membership, path↔date agreement, slug uniqueness, dangling refs, index freshness) in CI before deploy.

Docs: Architecture · Content authoring · Artifacts · Routines · Design system

Develop

npm ci
npm run dev        # localhost:4321
npm run build      # static build + search index
npm run validate   # content gate
npm run new:article -- --title "…" --topics ai,agents
npm run new:artifact -- --title "…" --type three --topics blockchain

License

Dual-licensed: code under MIT, content (content/) under CC BY 4.0 — share and adapt with attribution to Blokz Development Co.