How dylanddeng/bubbles-brain works
Bubble’s Brain is an Astro-based bilingual knowledge site for AI practitioners, centered on evergreen, reusable content rather than a live news feed. The visitor workflow is to browse or search articles, with RSS and sitemap as alternate discovery outputs; community comments and authentication are supporting capabilities. Content is maintained in Markdown and a separate Workers publishing pipeline supports publication. README documents the site capabilities, while source-index references show several Worker-to-storage dependencies; unsampled Worker internals are not inferred. The retired daily-news pipeline is excluded.
Main entry points: astro.config.mjs Astro site · db.ts Publishing database · index.ts Editorial worker · mirror.ts Content ingestion
Components 17
Knowledge site
- Astro site
astro/astro.config.mjs - Markdown collections
astro/src/content.config.ts - Bilingual sections
astro/src/lib/collectionRoutes.ts - Full-text search
astro/src/lib/searchIndex.ts - RSS and sitemap
astro/src/pages/rss.xml.ts
Community features
- Comments UI
static/js/supabase-comments.js - Supabase client
astro/src/lib/supabase/client.ts - Community config
astro/src/lib/community/config.ts - User auth
astro/src/lib/auth/authStore.ts
Content publishing
- Editorial worker
workers/content/editorial/index.ts - Publishing broker
workers/content/broker/index.ts - Content ingestion
workers/content/ingestion/mirror.ts - Content deployer
workers/content/deployer/index.ts
Publishing storage
- Canonical content
workers/content/shared/canonical.ts - Publishing database
workers/content/shared/db.ts - Artifact storage
workers/content/shared/r2.ts
Other components
- Reader
Connections 19
- Reader → Astro site: browses
README.md - Astro site → Markdown collections: renders
README.md - Astro site → Bilingual sections: routes through
README.md - Astro site → Full-text search: provides search
README.md - Astro site → RSS and sitemap: generates feeds
README.md - Astro site → Comments UI: offers comments
- Comments UI → Supabase client: uses client
- Supabase client → Community config: loads config
astro/src/lib/supabase/client.ts - Comments UI → User auth: supports sign-in
- Editorial worker → Canonical content: uses canonical data
workers/content/editorial/index.ts - Editorial worker → Publishing database: reads and writes
workers/content/editorial/index.ts - Editorial worker → Artifact storage: uses artifacts
workers/content/editorial/index.ts - Publishing broker → Publishing database: reads and writes
workers/content/broker/index.ts - Content ingestion → Canonical content: uses canonical data
workers/content/ingestion/mirror.ts - Content ingestion → Publishing database: reads and writes
workers/content/ingestion/mirror.ts - Content ingestion → Artifact storage: uses artifacts
workers/content/ingestion/mirror.ts - Content deployer → Canonical content: uses canonical data
workers/content/deployer/index.ts - Content deployer → Publishing database: reads and writes
workers/content/deployer/index.ts - Content deployer → Artifact storage: uses artifacts
workers/content/deployer/index.ts