Vercel auto-detected Turbo and started adjusting defaults, which
ended up running 'turbo build' at the repo root — that fans out to
every workspace including @agentskit/docs (legacy Docusaurus, broken
on Node 25).

Explicit config pins framework = Next.js, builds packages first so
workspace:* resolutions work, then builds the docs site. Skips
unrelated commits via ignoreCommand to save build minutes.

Paired with this file, the Vercel dashboard should set:
  Root Directory:  apps/docs-next
  Framework:       Next.js (auto-detected from this file)
  Node.js:         22.x

- Replace minimal hero with full 7-section landing (hero + demo,
  social proof, problem, solution, benefits, provider strip, CTA)
- Add live hero demo: auto-cycling agent conversation that renders
  real React widgets (weather card, BTC price chart, order tracker,
  flight list) via tool calls — sells the "agents render components,
  not markdown" angle
- Restore interactive example components (BasicChat, ToolUse, RAG,
  Multi-Agent, etc.) ported from the legacy Docusaurus site; wire
  them into each /docs/examples mdx
- Fix /docs/examples index links (relative -> absolute)
- Make package grid clickable; each card links to its package docs
- Add live npm downloads + GitHub stars social-proof bar
- Brand tokens (direction B: midnight/foam) applied throughout

…deps

…erview

Add visible, contextual contribution CTAs so more people can help
grow the ecosystem.

- /docs/contribute section: overview (with live contributor wall),
  good-first-issues (live GitHub list), local-setup, commit-style,
  rfc-process, roadmap
- Homepage: "Built in the open" block with contributor avatars,
  issue counts, and CTAs; "Contribute" button in final CTA
- Social proof bar: add live contributors metric
- Top nav: add "Contribute" and "Examples" links
- Every docs page: "Edit on GitHub" + "Open an issue" + "Contribute"
  footer row (wired via editOnGithub prop on DocsPage)
- Reusable ContributeCallout added to every package overview, data-layer
  and agent docs page; adapters + tools pages get tailored copy
- Migrating pages: post-migration CTA to share story back
- Examples index: "Have a pattern we missed?" CTA
- 404 page: custom not-found with contribute links
- README.md: expanded Contributing section + contrib.rocks avatar grid

…ussion topics

- ContributorWall: avatar grid now scrollable (max-h-200) to accommodate
  large lists; fallback to contrib.rocks SVG when GitHub API returns
  nothing (rate-limit / offline) so wall is never empty
- /docs/contribute: add "Start a new discussion" topic table with
  pre-filled links (use cases, missing providers, migrations, DX
  friction, architecture Q&A, recipes, bugs, docs gaps)
- /docs/contribute/good-first-issues: add 30+ curated seeded starter
  issues across DX, docs, adapters, tools, React/Ink, memory/RAG/eval,
  observability, examples
- /docs/contribute/local-setup: add hot-reload section explaining pnpm
  dev watch + HMR workflow (two-terminal tip)
- /docs/contribute/commit-style: replace fake enforcement claims with
  honest 'planned + good-first-issue' plan to wire commitlint + husky +
  CI step (turns it into a concrete starter ticket)

- New AnimatedLogo component (CSS-only, zero deps)
- Intro: lines draw in via stroke-dasharray, dots pop via cubic-bezier scale
- Loop variant: dots breathe (3.2s pulse) after intro
- Hover: lines shimmer + dots bounce
- Variants: nav (small), hero (glow + slow), footer (fast)
- prefers-reduced-motion snaps to final state, no animation
- Wired into nav, homepage hero, final CTA, 404 page

…tion

- animated-logo.css: remove all animations, keep static SVG + hero glow
- hero-demo: assistant bubble uses word-break: break-word +
  overflow-wrap: anywhere so long sentences wrap inside card width;
  inner column constrained to max-w-[92%] w-full so flex child
  doesn't grow to content
- hero-demo: remove 'agent renders real components · not markdown'
  caption from footer; keep scene pills only, centered

- Cap body at h-[460px]; messages area overflow-y-auto with thin scrollbar
- useLayoutEffect scrolls to bottom on every frame update so incoming
  tokens + widget renders keep the latest content visible
- Input bar moved outside scroll container, sticks to bottom with
  its own top-border separator

- Define --ak-* as CSS vars; :root holds light-mode values, .dark
  overrides with the original palette-B dark values
- @theme now points each --color-ak-* at its var, so bg-ak-midnight,
  text-ak-foam, border-ak-border etc. swap automatically when Fumadocs
  toggles the .dark class on <html>
- Light palette: clean inverted GitHub-style (#fff bg, #0D1117 text,
  #f6f8fa surface, #d0d7de border, accessible green/blue/red)

- Caption above grid: '↓ click any package to open its docs'
- Each card now shows an arrow on hover + hover shadow ring
- Caption below grid links to /docs 'browse all →'
- aria-label per card for screen readers

- app/robots.ts: allow all, disallow /api, point at sitemap
- app/sitemap.ts: enumerate 74+ docs pages via source.getPages(),
  priority/changefreq tuned per section
- app/layout.tsx: add robots directives (index/follow + googleBot
  max-image-preview), keywords, authors, alternates.canonical,
  openGraph.locale, stronger default title
- app/(home)/page.tsx: JSON-LD @graph (Organization +
  SoftwareApplication + WebSite w/ SearchAction)
- app/docs/[[...slug]]/page.tsx: per-page alternates.canonical +
  openGraph article type + BreadcrumbList + TechArticle JSON-LD
- components/seo/json-ld.tsx: reusable JSON-LD emitter
- Fix domain inconsistency: agentskit.dev → agentskit.io across
  hero-demo + contribute docs (layout canonical was already .io)

- /api/og/route.tsx: accent top bar + section pill colored per section
  (getting-started=blue, examples=green, recipes=amber, contribute=red,
  concepts=violet, etc.), bottom-right domain badge in accent
- docs [[...slug]]/generateMetadata now injects
  /api/og?title=&description=&section= into openGraph.images and
  twitter.images so every docs page gets a unique share card
- layout.tsx: verification metadata scaffold for GSC + Bing codes

Main received the squash-merged #301 homepage rebuild; this branch
already contains that work plus follow-up polish (contribute hub,
animated brand, light mode, SEO, OG per-page, hero-demo scroll fix,
domain normalization). Keeping HEAD resolves every conflict since
HEAD is strictly newer.

…mplates

React + ink starters referenced react/jsx-runtime in TS but shipped no
@types/react in devDependencies, causing TS2307 errors in fresh scaffolds.
Runtime + multi-agent starters unchanged (pure Node).

…entskit.io

- Polished all 14 package READMEs: positioning hook, shields badges (npm,
  downloads, bundle, license, stability, stars), discoverability tags,
  benefit-focused Why sections, contrib.rocks graph.
- Expanded keywords in every package.json (9 → 16-20) for npm search:
  baseline ai/agents/llm/agentskit/openai/anthropic/claude/gemini/chatgpt
  plus package-specific tags.
- Root README gained extra badge row (stars, issues, PRs, last-commit).
- Migrated all doc URLs https://agentskit.io → https://www.agentskit.io
  across READMEs, CLI source (init, init-interactive), docs-next
  (layout, sitemap, robots, home, docs page).
- Removed obsolete demo assets (demo/, scripts/record-demo.sh,
  scripts/seed-good-first-issues.sh, public/demo-init.*).
- Added docs/DESIGN.md color-token canonical reference.