# mirari/v-viewer

Image viewer component for vue, supports rotation, scale, zoom and so on, based on viewer.js

Repository: https://github.com/mirari/v-viewer
Canonical: https://ross.abutalabs.com/products/v-viewer
Homepage: https://mirari.cc/v-viewer/
Language: Vue
License: MIT
License Family: permissive
Topics: vue, viewer, gallery, picture, img, image
Last push: 2026-02-02T06:40:52+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 65, release rhythm 36, longevity 100
- inputs: {"age_days": 3298, "days_push": 212, "days_rel": 212, "gap_med": 214, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2638, forks 299 (observed 2026-08-28T04:07:06.343099+00:00)

## What it is
v-viewer is an image viewer component and directive for Vue 2 and Vue 3, built on top of viewer.js. It supports rotation, scaling, zooming, and other image viewing features via a component, directive, and programmatic API.

## Use cases
- add a lightbox image viewer to a vue app
- zoom and rotate images in a vue gallery
- show full-size images from thumbnails on click
- view multiple images with a custom toolbar in vue
- programmatically open an image viewer from a button
- filter which images are viewable in a vue component

## When to choose
- you are building a Vue 2 or Vue 3 app and need interactive image viewing with zoom, rotate, and scale
- you want a lightweight wrapper around viewer.js with component, directive, and API usage styles
- you need gallery-style image browsing with thumbnails and callbacks

## When to avoid
- you are not using Vue (use viewer.js directly or a React equivalent)
- you need a full image editor with cropping or annotation rather than viewing
- you need server-side image processing

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, image-processing
- domain: frontend, web-development, image-processing
- platform: cross-platform
- tags: vue, vue3, vue2, image-viewer, lightbox, gallery, viewerjs, zoom, rotation, web-server, nodejs

## Member repositories
- mirari/v-viewer (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:06.343099+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-30T02:19:17.020859+00:00, confidence not recorded.
  - readme: https://github.com/mirari/v-viewer (fetched 2026-08-28T04:07:06.343099+00:00, sha 2ad1325ada10)
  - homepage: https://mirari.cc/v-viewer/ (fetched 2026-08-29T10:02:26.543100+00:00, sha 772fc8a16b20)
  - registry_npm: https://registry.npmjs.org/v-viewer (fetched 2026-08-29T10:02:26.552354+00:00, sha e79d7469d103)
- Data as of 2026-08-30T08:39:29.467469+00:00.