kitfly 0.1.2 → 0.2.0

package/dist/content-index.json

@@ -0,0 +1,540 @@
+{
+  "version": "0.2.0",
+  "generated": "2026-02-15T17:49:07.318Z",
+  "title": "Kitfly Docs",
+  "baseUrl": "/",
+  "rawMarkdownPath": "/_raw",
+  "pages": [
+    {
+      "path": "/content/guide/approaches",
+      "htmlPath": "/content/guide/approaches.html",
+      "rawPath": "/_raw/content/guide/approaches.md",
+      "title": "Approaches",
+      "section": "Guide",
+      "source": "content/guide/approaches.md",
+      "description": "Three ways to use kitfly"
+    },
+    {
+      "path": "/content/guide/features",
+      "htmlPath": "/content/guide/features.html",
+      "rawPath": "/_raw/content/guide/features.md",
+      "title": "Features",
+      "section": "Guide",
+      "source": "content/guide/features.md",
+      "description": "What kitfly can do"
+    },
+    {
+      "path": "/content/guide/getting-started",
+      "htmlPath": "/content/guide/getting-started.html",
+      "rawPath": "/_raw/content/guide/getting-started.md",
+      "title": "Getting Started",
+      "section": "Guide",
+      "source": "content/guide/getting-started.md",
+      "description": "Set up your first kitfly site"
+    },
+    {
+      "path": "/content/guide/kitfly-overview",
+      "htmlPath": "/content/guide/kitfly-overview.html",
+      "rawPath": "/_raw/content/guide/kitfly-overview.md",
+      "title": "Kitfly Overview",
+      "section": "Guide",
+      "source": "content/guide/kitfly-overview.md",
+      "description": "What Kitfly is, how it works, and the philosophy behind it"
+    },
+    {
+      "path": "/content/templates/crucible",
+      "htmlPath": "/content/templates/crucible.html",
+      "rawPath": "/_raw/content/templates/crucible.md",
+      "title": "Crucible Template",
+      "section": "Templates",
+      "source": "content/templates/crucible.md",
+      "description": "Information architecture SSOT with specs, schemas, config, and governance"
+    },
+    {
+      "path": "/content/templates/handbook",
+      "htmlPath": "/content/templates/handbook.html",
+      "rawPath": "/_raw/content/templates/handbook.md",
+      "title": "Handbook Template",
+      "section": "Templates",
+      "source": "content/templates/handbook.md",
+      "description": "Team documentation with overview, guides, and reference sections"
+    },
+    {
+      "path": "/content/templates/minimal",
+      "htmlPath": "/content/templates/minimal.html",
+      "rawPath": "/_raw/content/templates/minimal.md",
+      "title": "Minimal Template",
+      "section": "Templates",
+      "source": "content/templates/minimal.md",
+      "description": "The base template that all others extend"
+    },
+    {
+      "path": "/content/templates/overview",
+      "htmlPath": "/content/templates/overview.html",
+      "rawPath": "/_raw/content/templates/overview.md",
+      "title": "Templates Overview",
+      "section": "Templates",
+      "source": "content/templates/overview.md",
+      "description": "How kitfly templates work and the layering model"
+    },
+    {
+      "path": "/content/templates/pipeline",
+      "htmlPath": "/content/templates/pipeline.html",
+      "rawPath": "/_raw/content/templates/pipeline.md",
+      "title": "Pipeline Template",
+      "section": "Templates",
+      "source": "content/templates/pipeline.md",
+      "description": "Data pipeline operations with stages, sources, destinations, and manifests"
+    },
+    {
+      "path": "/content/templates/productbook",
+      "htmlPath": "/content/templates/productbook.html",
+      "rawPath": "/_raw/content/templates/productbook.md",
+      "title": "Productbook Template",
+      "section": "Templates",
+      "source": "content/templates/productbook.md",
+      "description": "Product and domain documentation for complex greenfield engagements"
+    },
+    {
+      "path": "/content/templates/runbook",
+      "htmlPath": "/content/templates/runbook.html",
+      "rawPath": "/_raw/content/templates/runbook.md",
+      "title": "Runbook Template",
+      "section": "Templates",
+      "source": "content/templates/runbook.md",
+      "description": "Operational procedures, troubleshooting, and incident response"
+    },
+    {
+      "path": "/content/templates/servicebook",
+      "htmlPath": "/content/templates/servicebook.html",
+      "rawPath": "/_raw/content/templates/servicebook.md",
+      "title": "Servicebook Template",
+      "section": "Templates",
+      "source": "content/templates/servicebook.md",
+      "description": "Professional services catalog with offerings, methodology, and delivery documentation"
+    },
+    {
+      "path": "/content/reference/configuration",
+      "htmlPath": "/content/reference/configuration.html",
+      "rawPath": "/_raw/content/reference/configuration.md",
+      "title": "Configuration",
+      "section": "Reference",
+      "source": "content/reference/configuration.md",
+      "description": "Customize your kitfly site"
+    },
+    {
+      "path": "/content/reference/design-catalog",
+      "htmlPath": "/content/reference/design-catalog.html",
+      "rawPath": "/_raw/content/reference/design-catalog.md",
+      "title": "Design Catalog (Shapes and Figures)",
+      "section": "Reference",
+      "source": "content/reference/design-catalog.md",
+      "description": "Deterministic layout building blocks for slides (and when to use diagram engines instead)"
+    },
+    {
+      "path": "/content/reference/environment-variables",
+      "htmlPath": "/content/reference/environment-variables.html",
+      "rawPath": "/_raw/content/reference/environment-variables.md",
+      "title": "Environment Variables",
+      "section": "Reference",
+      "source": "content/reference/environment-variables.md",
+      "description": "A beginner-friendly primer (with copy-paste examples)"
+    },
+    {
+      "path": "/content/reference/glossary",
+      "htmlPath": "/content/reference/glossary.html",
+      "rawPath": "/_raw/content/reference/glossary.md",
+      "title": "Glossary",
+      "section": "Reference",
+      "source": "content/reference/glossary.md",
+      "description": "Quick definitions for common Kitfly terms"
+    },
+    {
+      "path": "/content/reference",
+      "htmlPath": "/content/reference.html",
+      "rawPath": "/_raw/content/reference.md",
+      "title": "Reference",
+      "section": "Reference",
+      "source": "content/reference/index.md",
+      "description": "Key concepts and lookup docs for Kitfly"
+    },
+    {
+      "path": "/content/reference/key-concepts",
+      "htmlPath": "/content/reference/key-concepts.html",
+      "rawPath": "/_raw/content/reference/key-concepts.md",
+      "title": "Key Concepts",
+      "section": "Reference",
+      "source": "content/reference/key-concepts.md",
+      "description": "Mental models for how Kitfly works"
+    },
+    {
+      "path": "/content/reference/plugins",
+      "htmlPath": "/content/reference/plugins.html",
+      "rawPath": "/_raw/content/reference/plugins.md",
+      "title": "Plugins",
+      "section": "Reference",
+      "source": "content/reference/plugins.md",
+      "description": "Enable small add-ons (CSS/JS) for docs and slides"
+    },
+    {
+      "path": "/content/reference/structure",
+      "htmlPath": "/content/reference/structure.html",
+      "rawPath": "/_raw/content/reference/structure.md",
+      "title": "Folder Structure",
+      "section": "Reference",
+      "source": "content/reference/structure.md",
+      "description": "What lives where in a kitfly project"
+    },
+    {
+      "path": "/content/deployment",
+      "htmlPath": "/content/deployment.html",
+      "rawPath": "/_raw/content/deployment.md",
+      "title": "Deployment",
+      "section": "Deployment",
+      "source": "content/deployment/index.md",
+      "description": "Publish a Kitfly site safely (with beginner-friendly guardrails)"
+    },
+    {
+      "path": "/content/deployment/preflight",
+      "htmlPath": "/content/deployment/preflight.html",
+      "rawPath": "/_raw/content/deployment/preflight.md",
+      "title": "Preflight and Rollback",
+      "section": "Deployment",
+      "source": "content/deployment/preflight.md",
+      "description": "A beginner-safe checklist before you publish"
+    },
+    {
+      "path": "/content/deployment/recipes/aws-s3",
+      "htmlPath": "/content/deployment/recipes/aws-s3.html",
+      "rawPath": "/_raw/content/deployment/recipes/aws-s3.md",
+      "title": "Recipe: AWS S3",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/aws-s3.md",
+      "description": "Static hosting on S3 (sync `dist/`)"
+    },
+    {
+      "path": "/content/deployment/recipes/cloudflare-pages",
+      "htmlPath": "/content/deployment/recipes/cloudflare-pages.html",
+      "rawPath": "/_raw/content/deployment/recipes/cloudflare-pages.md",
+      "title": "Recipe: Cloudflare Pages",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/cloudflare-pages.md",
+      "description": "Beginner-friendly Cloudflare hosting for static `dist/` output"
+    },
+    {
+      "path": "/content/deployment/recipes/cloudflare-r2",
+      "htmlPath": "/content/deployment/recipes/cloudflare-r2.html",
+      "rawPath": "/_raw/content/deployment/recipes/cloudflare-r2.md",
+      "title": "Recipe: Cloudflare R2",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/cloudflare-r2.md",
+      "description": "Advanced: publish `dist/` using Cloudflare storage and edge routing"
+    },
+    {
+      "path": "/content/deployment/recipes/fly-io",
+      "htmlPath": "/content/deployment/recipes/fly-io.html",
+      "rawPath": "/_raw/content/deployment/recipes/fly-io.md",
+      "title": "Recipe: Fly.io",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/fly-io.md",
+      "description": "Host your built site as a tiny app (Docker-based)"
+    },
+    {
+      "path": "/content/deployment/recipes/github-pages",
+      "htmlPath": "/content/deployment/recipes/github-pages.html",
+      "rawPath": "/_raw/content/deployment/recipes/github-pages.md",
+      "title": "Recipe: GitHub Pages",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/github-pages.md",
+      "description": "Publish `dist/` on GitHub Pages"
+    },
+    {
+      "path": "/content/deployment/recipes/netlify",
+      "htmlPath": "/content/deployment/recipes/netlify.html",
+      "rawPath": "/_raw/content/deployment/recipes/netlify.md",
+      "title": "Recipe: Netlify",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/netlify.md",
+      "description": "Beginner-friendly: upload `dist/` and go"
+    },
+    {
+      "path": "/content/deployment/recipes/vercel",
+      "htmlPath": "/content/deployment/recipes/vercel.html",
+      "rawPath": "/_raw/content/deployment/recipes/vercel.md",
+      "title": "Recipe: Vercel",
+      "section": "Deployment",
+      "source": "content/deployment/recipes/vercel.md",
+      "description": "Deploy `dist/` to Vercel with CDN and custom domains"
+    },
+    {
+      "path": "/content/deployment/secrets-and-env-vars",
+      "htmlPath": "/content/deployment/secrets-and-env-vars.html",
+      "rawPath": "/_raw/content/deployment/secrets-and-env-vars.md",
+      "title": "Secrets and Environment Variables",
+      "section": "Deployment",
+      "source": "content/deployment/secrets-and-env-vars.md",
+      "description": "How to deploy without leaking credentials"
+    },
+    {
+      "path": "/docs/userguide/cli/build",
+      "htmlPath": "/docs/userguide/cli/build.html",
+      "rawPath": "/_raw/docs/userguide/cli/build.md",
+      "title": "build",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/build.md"
+    },
+    {
+      "path": "/docs/userguide/cli/bundle",
+      "htmlPath": "/docs/userguide/cli/bundle.html",
+      "rawPath": "/_raw/docs/userguide/cli/bundle.md",
+      "title": "bundle",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/bundle.md"
+    },
+    {
+      "path": "/docs/userguide/cli/dev",
+      "htmlPath": "/docs/userguide/cli/dev.html",
+      "rawPath": "/_raw/docs/userguide/cli/dev.md",
+      "title": "dev",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/dev.md"
+    },
+    {
+      "path": "/docs/userguide/cli/init",
+      "htmlPath": "/docs/userguide/cli/init.html",
+      "rawPath": "/_raw/docs/userguide/cli/init.md",
+      "title": "init",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/init.md"
+    },
+    {
+      "path": "/docs/userguide/cli",
+      "htmlPath": "/docs/userguide/cli.html",
+      "rawPath": "/_raw/docs/userguide/cli.md",
+      "title": "README",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/README.md"
+    },
+    {
+      "path": "/docs/userguide/cli/servers",
+      "htmlPath": "/docs/userguide/cli/servers.html",
+      "rawPath": "/_raw/docs/userguide/cli/servers.md",
+      "title": "servers",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/servers.md"
+    },
+    {
+      "path": "/docs/userguide/cli/stop",
+      "htmlPath": "/docs/userguide/cli/stop.html",
+      "rawPath": "/_raw/docs/userguide/cli/stop.md",
+      "title": "stop",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/stop.md"
+    },
+    {
+      "path": "/docs/userguide/cli/update",
+      "htmlPath": "/docs/userguide/cli/update.html",
+      "rawPath": "/_raw/docs/userguide/cli/update.md",
+      "title": "update",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/update.md"
+    },
+    {
+      "path": "/docs/userguide/cli/version",
+      "htmlPath": "/docs/userguide/cli/version.html",
+      "rawPath": "/_raw/docs/userguide/cli/version.md",
+      "title": "version",
+      "section": "User Guide",
+      "source": "docs/userguide/cli/version.md"
+    },
+    {
+      "path": "/docs/userguide/sharing",
+      "htmlPath": "/docs/userguide/sharing.html",
+      "rawPath": "/_raw/docs/userguide/sharing.md",
+      "title": "Sharing Your Docs",
+      "section": "User Guide",
+      "source": "docs/userguide/sharing.md",
+      "description": "How to send, host, and deploy kitfly output"
+    },
+    {
+      "path": "/docs/decisions/ADR-0001-minimalist-site-code",
+      "htmlPath": "/docs/decisions/ADR-0001-minimalist-site-code.html",
+      "rawPath": "/_raw/docs/decisions/ADR-0001-minimalist-site-code.md",
+      "title": "ADR-0001: Minimalist Site Code",
+      "section": "Decisions",
+      "source": "docs/decisions/ADR-0001-minimalist-site-code.md",
+      "description": "Defines thresholds for the site code that kitfly copies to user projects"
+    },
+    {
+      "path": "/docs/decisions/ADR-0002-ai-accessibility",
+      "htmlPath": "/docs/decisions/ADR-0002-ai-accessibility.html",
+      "rawPath": "/_raw/docs/decisions/ADR-0002-ai-accessibility.md",
+      "title": "ADR-0002: AI Accessibility for Published Sites",
+      "section": "Decisions",
+      "source": "docs/decisions/ADR-0002-ai-accessibility.md",
+      "description": "Standard for making kitfly sites consumable by AI agents"
+    },
+    {
+      "path": "/docs/decisions/ADR-0003-single-file-bundle",
+      "htmlPath": "/docs/decisions/ADR-0003-single-file-bundle.html",
+      "rawPath": "/_raw/docs/decisions/ADR-0003-single-file-bundle.md",
+      "title": "ADR-0003: Single-File Bundle Output",
+      "section": "Decisions",
+      "source": "docs/decisions/ADR-0003-single-file-bundle.md",
+      "description": "Kitfly produces a self-contained HTML file as an alternative to static site build"
+    },
+    {
+      "path": "/docs/decisions/ADR-0004-bun-runtime",
+      "htmlPath": "/docs/decisions/ADR-0004-bun-runtime.html",
+      "rawPath": "/_raw/docs/decisions/ADR-0004-bun-runtime.md",
+      "title": "ADR-0004: Bun Runtime",
+      "section": "Decisions",
+      "source": "docs/decisions/ADR-0004-bun-runtime.md",
+      "description": "Kitfly uses Bun as its runtime instead of Node.js"
+    },
+    {
+      "path": "/docs/decisions/ADR-0005-plugin-contract-and-distribution",
+      "htmlPath": "/docs/decisions/ADR-0005-plugin-contract-and-distribution.html",
+      "rawPath": "/_raw/docs/decisions/ADR-0005-plugin-contract-and-distribution.md",
+      "title": "ADR-0005: Plugin Contract and Distribution Strategy",
+      "section": "Decisions",
+      "source": "docs/decisions/ADR-0005-plugin-contract-and-distribution.md",
+      "description": "Defines plugin contract stability, versioning policy, and in-repo-first distribution with extraction path"
+    },
+    {
+      "path": "/docs/decisions/DDR-0001-viewport-locked-layout",
+      "htmlPath": "/docs/decisions/DDR-0001-viewport-locked-layout.html",
+      "rawPath": "/_raw/docs/decisions/DDR-0001-viewport-locked-layout.md",
+      "title": "DDR-0001: Viewport-Locked Layout with Fixed Footer Ribbon",
+      "section": "Decisions",
+      "source": "docs/decisions/DDR-0001-viewport-locked-layout.md",
+      "description": "Defines the kitfly page layout model: fixed chrome (header/footer) with scrollable middle band"
+    },
+    {
+      "path": "/docs/decisions/DDR-0002-theme-system",
+      "htmlPath": "/docs/decisions/DDR-0002-theme-system.html",
+      "rawPath": "/_raw/docs/decisions/DDR-0002-theme-system.md",
+      "title": "DDR-0002: Two-Layer Theme System",
+      "section": "Decisions",
+      "source": "docs/decisions/DDR-0002-theme-system.md",
+      "description": "Defines the kitfly theming model: theme.yaml semantic tokens → generated CSS variables → styles.css fallbacks"
+    },
+    {
+      "path": "/docs/decisions/DDR-0003-bounded-logo-slot",
+      "htmlPath": "/docs/decisions/DDR-0003-bounded-logo-slot.html",
+      "rawPath": "/_raw/docs/decisions/DDR-0003-bounded-logo-slot.md",
+      "title": "DDR-0003: Bounded Logo Slot",
+      "section": "Decisions",
+      "source": "docs/decisions/DDR-0003-bounded-logo-slot.md",
+      "description": "Logo rendering uses a bounded bounding-box model supporting both square icons and wide wordmarks"
+    },
+    {
+      "path": "/docs/decisions/DDR-0004-slides-rendering-model",
+      "htmlPath": "/docs/decisions/DDR-0004-slides-rendering-model.html",
+      "rawPath": "/_raw/docs/decisions/DDR-0004-slides-rendering-model.md",
+      "title": "DDR-0004: Slides Rendering Model",
+      "section": "Decisions",
+      "source": "docs/decisions/DDR-0004-slides-rendering-model.md",
+      "description": "Defines slides mode rendering, segmentation, and navigation behavior across dev/build/bundle"
+    },
+    {
+      "path": "/docs/decisions/DDR-0005-deterministic-layout-boundary",
+      "htmlPath": "/docs/decisions/DDR-0005-deterministic-layout-boundary.html",
+      "rawPath": "/_raw/docs/decisions/DDR-0005-deterministic-layout-boundary.md",
+      "title": "DDR-0005: Deterministic Layout Boundary",
+      "section": "Decisions",
+      "source": "docs/decisions/DDR-0005-deterministic-layout-boundary.md",
+      "description": "Defines the boundary between CSS layout primitives/figures and diagramming engines for slide visual composition"
+    },
+    {
+      "path": "/schemas/plugin-registry.schema",
+      "htmlPath": "/schemas/plugin-registry.schema.html",
+      "rawPath": "/_raw/schemas/plugin-registry.schema.md",
+      "title": "plugin-registry.schema",
+      "section": "Schemas",
+      "source": "schemas/plugin-registry.schema.json"
+    },
+    {
+      "path": "/schemas/plugin-schemas-notes",
+      "htmlPath": "/schemas/plugin-schemas-notes.html",
+      "rawPath": "/_raw/schemas/plugin-schemas-notes.md",
+      "title": "Plugin Schema Notes",
+      "section": "Schemas",
+      "source": "schemas/plugin-schemas-notes.md",
+      "description": "Rationale and validation rules for plugin.yaml and registry/plugins.yaml schemas"
+    },
+    {
+      "path": "/schemas/plugin.schema",
+      "htmlPath": "/schemas/plugin.schema.html",
+      "rawPath": "/_raw/schemas/plugin.schema.md",
+      "title": "plugin.schema",
+      "section": "Schemas",
+      "source": "schemas/plugin.schema.json"
+    },
+    {
+      "path": "/schemas/plugins.schema",
+      "htmlPath": "/schemas/plugins.schema.html",
+      "rawPath": "/_raw/schemas/plugins.schema.md",
+      "title": "plugins.schema",
+      "section": "Schemas",
+      "source": "schemas/plugins.schema.json"
+    },
+    {
+      "path": "/schemas",
+      "htmlPath": "/schemas.html",
+      "rawPath": "/_raw/schemas.md",
+      "title": "Kitfly Schemas",
+      "section": "Schemas",
+      "source": "schemas/README.md",
+      "description": "Schema versioning policy for site.yaml and theme.yaml"
+    },
+    {
+      "path": "/schemas/v0/common.schema",
+      "htmlPath": "/schemas/v0/common.schema.html",
+      "rawPath": "/_raw/schemas/v0/common.schema.md",
+      "title": "common.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/common.schema.json"
+    },
+    {
+      "path": "/schemas/v0/plugin-registry.schema",
+      "htmlPath": "/schemas/v0/plugin-registry.schema.html",
+      "rawPath": "/_raw/schemas/v0/plugin-registry.schema.md",
+      "title": "plugin-registry.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/plugin-registry.schema.json"
+    },
+    {
+      "path": "/schemas/v0/plugin.schema",
+      "htmlPath": "/schemas/v0/plugin.schema.html",
+      "rawPath": "/_raw/schemas/v0/plugin.schema.md",
+      "title": "plugin.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/plugin.schema.json"
+    },
+    {
+      "path": "/schemas/v0/plugins.schema",
+      "htmlPath": "/schemas/v0/plugins.schema.html",
+      "rawPath": "/_raw/schemas/v0/plugins.schema.md",
+      "title": "plugins.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/plugins.schema.json"
+    },
+    {
+      "path": "/schemas/v0/site.schema",
+      "htmlPath": "/schemas/v0/site.schema.html",
+      "rawPath": "/_raw/schemas/v0/site.schema.md",
+      "title": "site.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/site.schema.json"
+    },
+    {
+      "path": "/schemas/v0/theme.schema",
+      "htmlPath": "/schemas/v0/theme.schema.html",
+      "rawPath": "/_raw/schemas/v0/theme.schema.md",
+      "title": "theme.schema",
+      "section": "Schemas",
+      "source": "schemas/v0/theme.schema.json"
+    }
+  ]
+}