kevindebenedetti.github.io

Centralized documentation hub for all @KevinDeBenedetti open-source projects, built with VitePress and deployed to GitHub Pages.

Live site: https://kevindebenedetti.github.io

Features

• Auto-discovers opted-in repos via the GitHub API and sparse-clones their docs/ directory
• Regenerates VitePress nav, sidebar, and homepage cards from each project's docs/.vitepressrc.json
• Listens for repository_dispatch (docs-updated) — source repos trigger a re-sync automatically on push
• Custom Vue 3 theme with TypeScript scripts, tested with Vitest
• Fast linting with oxlint via prek; type-checked with vue-tsc
• Built with Bun as runtime, package manager, and test runner

Prerequisites

• Bun ≥ 1.2
• GITHUB_TOKEN — GitHub PAT with public_repo scope (optional, increases API rate limits)

Installation

bun install

Usage

bun run dev       # sync docs + generate config + start dev server
bun run build     # sync docs + generate config + build static site
bun run test      # run Vitest unit tests
bun run lint      # run oxlint
bun run typecheck # type-check with vue-tsc

→ Opt-in contract and dispatch setup: docs