Ideas worth brewing.
TokenBrews is a coffee-inspired AI/ML field journal for model experiments, local inference, practical systems, and high-signal technical notes.
The production site is intended to run entirely on GitHub Pages:
The repository publishes the static export from main through
.github/workflows/deploy-pages.yml.
The workflow:
- installs the locked dependencies with Node.js 22
- builds the Vinext app in static-export mode
- verifies
dist/client/index.html - publishes the
dist/clientartifact through GitHub Pages
GitHub Pages must be enabled once in Settings → Pages with Source: GitHub Actions.
The domain is managed in Cloudflare, but GitHub Pages is the host. Add these
records in the tokenbrews.com Cloudflare zone:
| Type | Name | Target |
|---|---|---|
| A | @ | 185.199.108.153 |
| A | @ | 185.199.109.153 |
| A | @ | 185.199.110.153 |
| A | @ | 185.199.111.153 |
| CNAME | www | ideaclaw.github.io |
Then set Settings → Pages → Custom domain to tokenbrews.com and enable
Enforce HTTPS after the certificate becomes available.
Remove conflicting A, AAAA, or CNAME records for @ and www. Keep the
records DNS-only while GitHub validates the domain; you can test Cloudflare
proxying later if required.
TokenBrews is styled as an AI/ML roastery — a quiet espresso bar crossed with an inference lab:
- dark roast surfaces, crema-orange and terminal-green accents, and a subtle paper-grain texture
- a CSS-built "neural pour-over" hero: an attention-network dripper dripping token glyphs into a cup, with a live-typing extraction terminal
- an interactive extraction pipeline mapping brewing stages to the ML lifecycle (harvest ⇄ collect, grind ⇄ tokenize, bloom ⇄ embed, extract ⇄ attend, serve ⇄ deploy)
- a brew menu of working AI/ML patterns priced in compute, and a cupping lab that scores models like single-origin lots
- scroll-reveal sections, animated counters, and full reduced-motion support
- Next.js 16 and React 19
- Vinext and Vite for the static export and local development
- Tailwind CSS 4 with a custom design system in
app/globals.css - TypeScript
Requires Node.js 22.13 or newer.
npm ci
npm run devThen open the local URL printed by Vite.
app/page.tsx— site content and semantic structureapp/interactive.tsx— client components: scroll reveals, the brew terminal, the extraction pipeline, counters, and cupping metersapp/globals.css— visual system, illustration, motion, and responsive rulesapp/layout.tsx— metadata, fonts, and global layout.github/workflows/deploy-pages.yml— GitHub Pages deploymentCNAME— the production hostname
TokenBrews is designed around four recurring formats:
- Model Tastings — practical model tests and benchmark notes
- Build Recipes — repeatable agent, RAG, and automation systems
- Signal Shots — high-signal AI/ML releases, papers, and tools
- Brew Stack — the methodology behind each experiment