Velin Block: App Shell 1.4.0

Official Velin-native Block manifest, install surface, and Adapt contract for app-shell.

Product boundary: Core Features are Velin-native. They do not extend Tailwind Compat/Migrate and do not port Shadcn, Radix, or Tailwind UI.

Purpose

App shell with sidebar navigation and main content region. Version 0.1.0; HTML framework; peer @birdapi/velinstyle ^1.4.0.

Install

velinstyle blocks info app-shell
velinstyle blocks add app-shell
velinstyle blocks add app-shell --dry-run
velinstyle blocks add app-shell --out my-blocks

Manifest inventory

Field	Value
Files	`app-shell.html`, `app-shell.css`, `README.md`
Components	`velin-drawer`, `velin-theme-toggle`
Tokens	`--velin-color-surface`, `--velin-space-4`, `--velin-surface-raised`

Adapt contract

{
  "roles": [
    "navbar",
    "dashboard"
  ],
  "density": [
    "compact",
    "comfortable",
    "spacious"
  ],
  "layout": [
    "stack",
    "split"
  ]
}

Accessibility contract

Navigation and main landmarks; skip-to-main; Escape closes a drawer when used.

Ownership and limits

The listed files are copied into the project and become user-owned source. Existing changed files fail by default; use --force only deliberately. The contract can narrow Adapt but never bypass validator or guardrails.