# vuejs/vue-web-component-wrapper

(Vue 2 only) Wrap a Vue component as a web component / custom element.

Repository: https://github.com/vuejs/vue-web-component-wrapper
Canonical: https://ross.abutalabs.com/products/vue-web-component-wrapper
Language: JavaScript
License Family: other
Last push: 2023-04-20T11:34:44+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3135, "days_push": 1231, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1062, forks 99 (observed 2026-08-28T04:03:26.195927+00:00)

## What it is
A Vue 2 library that wraps a Vue component as a standards-based web component (custom element) so it can be registered with customElements.define and used in any page or framework. It proxies props between the custom element and the inner Vue component, including attribute-to-prop mapping and boolean casting.

## Use cases
- wrap a Vue component as a custom element
- use Vue components in non-Vue pages via web components
- register a Vue component with customElements.define
- embed Vue widgets in plain HTML or other frameworks
- convert Vue 2 components to standards-based custom elements

## When to choose
- you are on Vue 2 and need to expose components as native custom elements
- you want to embed Vue components in pages or apps not built with Vue
- you need standards-based custom elements with prop/attribute proxying

## When to avoid
- you are using Vue 3, which has built-in defineCustomElement
- you need IE11 support
- you need active development or official maintenance guarantees

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, frontend-framework
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: vue, web-components, custom-elements, vue2, shadow-dom, javascript, web

## Member repositories
- vuejs/vue-web-component-wrapper (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:26.195927+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:56:47.303997+00:00, confidence not recorded.
  - readme: https://github.com/vuejs/vue-web-component-wrapper (fetched 2026-08-28T04:03:26.195927+00:00, sha 4c9a65f759f8)
- Data as of 2026-08-30T08:39:29.467469+00:00.