@raggle-ai/kennel-vitepress-plugin
v0.1.17
Published
Shared VitePress docs plugin for Kennel workspaces.
Readme
Kennel VitePress Plugin
Shared VitePress docs plugin for Kennel workspaces.
VitePress
Install from the public npm registry:
npm install -D @raggle-ai/kennel-vitepress-pluginThe @raggle-ai/kennel-vitepress-plugin package exposes a reusable VitePress layer:
@raggle-ai/kennel-vitepress-plugin/config@raggle-ai/kennel-vitepress-plugin/config-file@raggle-ai/kennel-vitepress-plugin/content@raggle-ai/kennel-vitepress-plugin/folder-index-data@raggle-ai/kennel-vitepress-plugin/site@raggle-ai/kennel-vitepress-plugin/theme
Consumers keep their own raggle.json and content folders. The package owns
folder discovery, nav/sidebar generation, folder index cards, and default card
styling. docs.config.json is still accepted as a legacy fallback.
Use content.mode in raggle.json to select the content shape:
schemaSections: schema-backed folders such asprojects/,partners/, andconnectors/.flatPages: ordinary Markdown pages and nested page folders.workspace: explicit folder sections without requiring schemas.
Cloudflare auth and deploy helpers are owned by @raggle-ai/kennel-cli, not
this public VitePress package. That keeps this package focused on static docs
configuration, data loaders, and theme components.
Publishing
The Kennel workspace .npmrc points the @raggle-ai scope at GitHub Packages
for private/internal packages. Use the explicit public publish scripts for this
package so the scope override is cleared:
npm run publish:public:dry-run
npm run publish:publicCloudflare protected deploys
Kennel can scaffold and deploy a Cloudflare Worker email-code gate for a docs workspace:
kennel publish init cloudflare .
kennel deploy .
kennel dp .The scaffold records the publish.auth intent in raggle.json and writes the
generated Worker and Wrangler config under .kennel/generated/. The deploy
command builds the docs, sets a generated KENNEL_AUTH_SECRET, deploys with
Wrangler, and smoke-tests the protected URL.
Set publish.cloudflare.token in raggle.json to centralize the Cloudflare API
token in Doppler; kennel deploy loads it automatically when configured.
kennel deploy infers the provider from publish.provider; kennel deploy
cloudflare remains available when the provider should be explicit.
