Github
Release notes

2.2.0

Angular and Vue catalog items, built with the framework version of your workspace, and builds that fail when a component fails.

Released 2026-11-17.

Handoff now documents Angular and Vue components. It builds their previews with the framework version your project already uses, so the docs show what you ship. You install only the tooling for the frameworks you document.

New

Angular

  • Catalog items from handoff-app/angular. The implementation is a standalone component class, and the preview args are its inputs. See Catalog items.
  • Handoff compiles each component with the Angular version of the workspace. The workspace needs Angular 19 or later, @angular/compiler-cli, @angular/build, and @analogjs/vite-plugin-angular 2.9 or a later 2.x.
  • Previews render in the browser. The property table and the usage snippet cover signal inputs, model() inputs, and @Input() properties.
  • start rebuilds a component when its template or stylesheet changes.

Vue

  • Catalog items from handoff-app/vue. The implementation is a Vue 3 single-file component, and the preview args are its props. See Catalog items.
  • Handoff compiles each component with the Vue version of the workspace. The workspace needs Vue 3.3 or a later 3.x, and @vitejs/plugin-vue 6.
  • Previews render in the browser. The property table and the usage snippet cover <script setup> props, the Options API, and defineModel().
  • start rebuilds a component when its .vue file, or a file that a block loads with src, changes.

Builds, start, and publish

  • A component that does not build, or a declaration that does not load, now fails the build with exit code 1. Handoff builds the rest first and lists what failed. See Builds.
  • publish uploads every item that built, then exits with code 1. A pattern that composes a failed component is not published.
  • start logs the error and keeps running. A declaration that did not load loads again when you save it.
  • start and publish follow every file that a component's last build read, such as an imported file. start rebuilds when one changes, and publish uploads the text files in the item directory.

Smaller changes

  • Build errors show the message and the location. The stack trace shows only with --debug.
  • start no longer rebuilds in a loop when a global entry is in the project root.
  • checkout writes Angular and Vue declarations.
  • The MCP server reports version 2.2.0. The tools did not change.

Breaking changes

None in the API. Two behaviors change for CI:

  • A build with a failed component used to exit with code 0. It now exits with code 1, so a CI job that ignored broken components now fails.
  • With pnpm, a declaration whose package does not depend on handoff-app used to be skipped. It now fails the build with Could not resolve "handoff-app/react".

Upgrade

  1. Install handoff-app@2.2.0.
  2. Run the build once and fix any component it reports as failed.
  3. To document Angular or Vue components, install their tooling in the workspace. See Catalog items.
  4. Rebuild and redeploy the registry, so it labels and highlights Angular and Vue code. No database migration is needed.

On this page