feat(website): Add brand-new bub website powered by Astro and Starlight (#176)

* wip

* feat(website): build landing page sections and migrate docs content

Landing page:
- Add Features.astro (6 feature cards, responsive 3×2 grid, hover animation)
- Add QuickStart.astro (3-step install/configure/run with code blocks)
- Add Philosophy.astro (born-in-group-chats storytelling, pull quote, highlights)
- Add Footer.astro (brand, nav links, copyright, built-with)
- Wire all new sections into pages/index.astro and pages/zh-cn/index.astro
- Extend landing-page.ts with full EN and zh-cn i18n copy for all sections
- Add section divider rule to global.css

Docs migration (from docs/ source of truth):
- Migrate docs/architecture.md → concepts/architecture.mdx (EN + zh-cn)
- Migrate docs/channels/{index,cli,telegram}.md → guides/{channels,cli,telegram}.mdx
- Migrate docs/skills.md → guides/skills.mdx
- Migrate docs/deployment.md → guides/deployment.mdx
- Split docs/extension-guide.md → extending/{plugins,hooks}.mdx
- Migrate blog posts → blog/{socialized-evaluation,bootstrap-milestone}.mdx
- Create reference/index.mdx placeholder (EN + zh-cn)
- Remove orphaned en/docs/index.mdx and zh-cn/docs/index.mdx
- Switch astro.config.mjs sidebar to autogenerate per directory

Build: 37 static pages, zero errors

Closes #3, #4, #5, #6, #7, #8, #9, #10, #11, #12

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* refactor(website): brand-new design with shadcn create

* wip

* wip

* wip

* wip

* feat: make all landing page components mobile-responsive

- Features: hide center logo on <lg, 1col mobile/2col sm/3col lg grid,
  responsive padding and min-height
- NavBar: icons + borders in mobile dropdown, slide-down animation
- Hero: full-width CTA buttons on mobile, overflow-x-auto on terminal
- HookIntro: hide hook-note text on <md, overflow-hidden on stage container
- TapeModel: hide time column on <sm, responsive cell padding, scroll
  fade indicator
- Testimonials: responsive height (320/380/440px)
- Footer: vertical stack on mobile, centered, flex-wrap links
- Contributors: show 5 avatars on mobile (10 on md+), smaller avatar size

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* wip

* wip

* wip

* refactor(website/i18n): Optimize i18n configuration and route path

* feat(website): Set real repository data and enable SSR mode

* style(website/hook): Redesign the hook intro illustration and animation

* refactor(website/tape): Redesign tape section illustration and animation

* improve(website): Optimize website UI/UX

- Unified the theme between main site and docs
- Unified the theme storage key
- fix the i18n route path issue

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* feat(website/i18n): Optimize chinese translation content

* og and userwall avatar

* feat(website): switch OG fonts to fontsource, add zh-cn index card

- Replace Google Fonts API with @fontsource/outfit and
  @fontsource/noto-sans-sc (.woff files read directly by satori)
- Use unicode-range subset matching to load only needed CJK subsets
- Give each CJK subset a unique font name to work around satori's
  deduplication of same-name+weight entries
- Add /og/zh-cn/index.png OG card with Chinese site description
- Wire locale-specific ogImage through LandingLayout → BaseLayout
- Remove wawoff2 dependency (satori supports WOFF natively)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* extract site url environment variable

* optimize og and html background

* fix the navbar issue

* remove duplicated title

* fix x icon and ui i18n issue

* chore: switch website adapter to cloudflare

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Chojan Shang <psiace@apache.org>

Author: 3 people

.gitignore

@@ -146,3 +146,4 @@ reference/
 # Local legacy backups created during framework migrations
 backup/
 _version.py
+!website/src/lib/

.pre-commit-config.yaml

@@ -10,7 +10,7 @@ repos:
         exclude: ^.devcontainer/devcontainer.json
       - id: pretty-format-json
         exclude: ^.devcontainer/devcontainer.json
-        args: [--autofix, --no-sort-keys]
+        args: [--autofix, --no-sort-keys, --no-ensure-ascii]
       - id: end-of-file-fixer
       - id: trailing-whitespace
 

website/.env.example

@@ -0,0 +1,5 @@
+# The canonical site URL (no trailing slash). Used for OG images, canonical links, etc.
+SITE_URL=https://bub.build
+
+# To get bub repository real contributors and stars data via GitHub API.
+GITHUB_TOKEN=

website/.gitignore

@@ -0,0 +1,23 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+.vercel/output
+.wrangler/

website/AGENTS.md

@@ -0,0 +1,5 @@
+# CLAUDE.md
+
+> **All project guidelines live in [`AGENTS.md`](./AGENTS.md). Read that file — it is the single source of truth.**
+>
+> This file exists only so Claude Code automatically picks up the project context. Do not duplicate content here.

website/CLAUDE.md

@@ -0,0 +1,79 @@
+// @ts-check
+import { fileURLToPath } from 'node:url';
+import { defineConfig, envField } from 'astro/config';
+import tailwindcss from '@tailwindcss/vite';
+import starlight from '@astrojs/starlight';
+import cloudflare from '@astrojs/cloudflare';
+
+export default defineConfig({
+  // SSG by default; landing pages opt-in to SSR via `export const prerender = false`.
+  adapter: cloudflare({
+    prerenderEnvironment: 'node',
+  }),
+  site: process.env.SITE_URL ?? 'https://bub.build',
+  env: {
+    schema: {
+      SITE_URL: envField.string({
+        context: 'client',
+        access: 'public',
+        default: 'https://bub.build',
+        optional: true,
+        url: true,
+      }),
+    },
+  },
+  vite: {
+    plugins: [tailwindcss()],
+    resolve: {
+      alias: {
+        '@': fileURLToPath(new URL('./src', import.meta.url)),
+      },
+    },
+  },
+  integrations: [
+    starlight({
+      title: 'Bub',
+      description: 'A common shape for agents that live alongside people.',
+      logo: {
+        light: './src/assets/bub-logo.png',
+        dark: './src/assets/bub-logo-dark.png',
+        alt: 'Bub',
+      },
+      customCss: ['./src/styles/global.css'],
+      disable404Route: true,
+      locales: {
+        root: {
+          label: 'English',
+          lang: 'en',
+        },
+        'zh-cn': {
+          label: '简体中文',
+          lang: 'zh-CN',
+        },
+      },
+      social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/bubbuild/bub' }],
+      sidebar: [
+        {
+          label: 'Getting Started',
+          translations: { 'zh-CN': '快速开始' },
+          autogenerate: { directory: 'docs/getting-started' },
+        },
+        {
+          label: 'Concepts',
+          translations: { 'zh-CN': '概念' },
+          autogenerate: { directory: 'docs/concepts' },
+        },
+        {
+          label: 'Guides',
+          translations: { 'zh-CN': '指南' },
+          autogenerate: { directory: 'docs/guides' },
+        },
+        {
+          label: 'Extending',
+          translations: { 'zh-CN': '扩展' },
+          autogenerate: { directory: 'docs/extending' },
+        },
+      ],
+    }),
+  ],
+});

website/astro.config.mjs

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-vega",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/styles/global.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

website/components.json

@@ -0,0 +1,38 @@
+{
+  "name": "website",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview"
+  },
+  "dependencies": {
+    "@astrojs/cloudflare": "^13.1.9",
+    "@astrojs/starlight": "^0.38.3",
+    "@astrojs/starlight-tailwind": "^5.0.0",
+    "@fontsource-variable/jetbrains-mono": "^5.2.8",
+    "@fontsource-variable/outfit": "^5.2.8",
+    "@fontsource/noto-sans-sc": "^5.2.9",
+    "@fontsource/outfit": "^5.2.8",
+    "@tailwindcss/vite": "^4.1.14",
+    "astro": "^6.0.1",
+    "astro-expressive-code": "^0.41.7",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "motion": "^12.38.0",
+    "satori": "^0.26.0",
+    "sharp": "^0.34.2",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0"
+  },
+  "devDependencies": {
+    "@lucide/astro": "^1.8.0",
+    "react-grab": "^0.1.32",
+    "tailwindcss": "^4.1.14",
+    "wrangler": "^4.13.2"
+  },
+  "overrides": {
+    "vite": "^7.3.2"
+  }
+}