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

.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/CLAUDE.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/astro.config.mjs

@@ -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/components.json

@@ -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/package.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"
+  }
+}