Bubble's Brain
English | 简体中文
Bubble's Brain is a personal knowledge base for AI practitioners — curating content worth revisiting and reusing over the long term, rather than chasing the daily feed.
Live site: https://bubblenews.today
This project began as an AI daily-news site. The automated crawling and daily publishing pipeline has been retired; historical dailies live only in Git history and never enter the current build, search, RSS, or routes.
Sections
- Codex Tutorials (
codex-tutorials/): systematic guides from installation to real-world workflows.
- Pi Agent Tutorials (
pi-agent-tutorials/): hands-on guides to installation, session storage, and the tool system.
- WorkBuddy Tutorials (
workbuddy-tutorials/): practical guides from installation to office automation.
- Vibe Coding (
vibe-coding/): three sub-sections — Terms, Skills, and Design.
- Highlights (
highlights/): primary sources, official articles, and in-depth commentary.
- About (
about/): the site and its author.
Content principles
- Favor evergreen content with clear provenance.
- Markdown is the primary source for full articles;
content/ is the single content directory.
- Content is organized by section, tags, and related topics — never by date-driven pressure.
Tech stack
- Astro 7 static output +
@astrojs/cloudflare adapter (deployed on Cloudflare)
- Markdown content collections
- Bilingual routing (zh-CN default,
en/ prefix) with canonical and hreflang
- Static full-text search, RSS, sitemap, and readable pages without JavaScript
- Build-time validation: route contract, CSP, internal links
Project structure
astro/ Astro presentation layer: pages, components, search index, and tests (see astro/README.md)
content/ Markdown content source — the single source of site content
static/ Site-wide static assets (referenced as the Astro publicDir)
workers/ Content publishing pipeline Workers, working with GitHub Actions
scripts/ Validation scripts (verify-site.mjs and friends, reused by astro verify)
docs/ Design docs and runbooks
Local development
Requires Node.js ^22.17 or >=24:
cd astro
npm install
npm run dev
Verify and build
cd astro
npm run verify # astro check + eslint + vitest + build + CSP + site validation
Build output lives in astro/dist/.
License
MIT
