Skip to content

docs(site): categorized product grid for the family overview#108

Merged
suleimansh merged 3 commits into
mainfrom
suleimansh/feat/package-grid
Jul 2, 2026
Merged

docs(site): categorized product grid for the family overview#108
suleimansh merged 3 commits into
mainfrom
suleimansh/feat/package-grid

Conversation

@suleimansh

Copy link
Copy Markdown
Member

Closes #76.

Replaces the flat package table on the family overview with a categorized product grid, modeled on TanStack's family list.

Categories (grow as packages graduate):

  • AI runtime — ai-sdk, ai-skills, ai-autopilot, ai-mcp
  • Protocol & connectors — mcp, connectors, connector-github, connector-google-drive

Curation rule (from the issue): user-facing packages only — inclusion test is "would an app author npm i this directly?" Non-user-facing tooling/infra stays off so the list is signal, not noise. The data lives in one place in PackageGrid.vue; new graduates are one array entry.

New PackageGrid.vue component registered globally in the theme; cards are plain <a> links (SSR-rendered, work without JS) and style off VitePress theme vars so light/dark both look right. The "how they fit together" diagram and the two-MCP-packages explanation stay below the grid.

Verified: docs:build clean; the built packages/index.html contains both category sections and all 8 cards. No changeset (docs site is private).

…sor + runner + surfaces)

A runnable, offline (AiFake) example that composes all four epic layers into
one build-a-feature flow: a planner routes subtasks to stack personas, the
Supervisor dispatches them, each worker writes Vike/ORM files inside a runner
sandbox via runnerTools, and the surfaces render live progress + a background
handle. Doubles as the integration contract a real FlueRunner must satisfy.

Private workspace example (@gemstack/example-autopilot-quickstart), in turbo
typecheck+test. Capstone for epic #97.
Boots each workspace as a real temp dir on the host: real files
(node:fs, path-traversal guarded), real commands (child_process with
cwd/env/timeout), a localhost preview, and a dispose() that cleans up.
It is the reference the sandboxed adapters (WebContainer/Docker/Flue)
mirror. Runs unsandboxed on the host, so documented as trusted/CI-only.

Closes #106. Part of #97.
Replace the flat package table with a PackageGrid component grouping
the user-facing packages into AI runtime and Protocol & connectors.
Curation rule: only packages an app author would npm i directly.

Closes #76.
@suleimansh suleimansh added documentation Improvements or additions to documentation priority: medium Worth doing, not urgent labels Jul 2, 2026
@suleimansh suleimansh self-assigned this Jul 2, 2026
@suleimansh suleimansh merged commit 24623c4 into main Jul 2, 2026
2 checks passed
@suleimansh suleimansh deleted the suleimansh/feat/package-grid branch July 2, 2026 10:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation priority: medium Worth doing, not urgent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Site: present the GemStack family as a categorized product grid (user-facing only)

1 participant