# Zizzamia/perfume.js

Web performance library for measuring all performance vitals metrics

Repository: https://github.com/Zizzamia/perfume.js
Canonical: https://ross.abutalabs.com/products/perfumejs
Homepage: https://zizzamia.github.io/perfume/
Language: TypeScript
License: MIT
License Family: permissive
Topics: web-performance, performance, monitorning, metrics, navigation-timing, resource-timing, network-information, performance-monitoring, ttfb, fcp, lcp, fid, tbt, cls
Last push: 2025-10-25T03:16:29+00:00

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

## Adoption (not part of the score)
Stars 3204, forks 111 (observed 2026-08-28T04:07:48.585952+00:00)

## What it is
Perfume.js is a tiny, zero-dependency TypeScript library for measuring web performance metrics like TTFB, FCP, LCP, FID, CLS, INP, and TBT using the latest browser Performance APIs. It collects real user measurement field data and reports it to any analytics tool of your choice.

## Use cases
- measure core web vitals like LCP and CLS in production
- collect real user monitoring data for my web app
- track first contentful paint and time to first byte
- report performance metrics to my analytics tool
- monitor total blocking time and interaction to next paint
- measure resource timing and element timing in the browser
- understand how users worldwide perceive my site's page speed

## When to avoid
- you need lab-based synthetic testing or load testing rather than field measurement
- you need server-side or backend performance monitoring
- you want a full RUM platform with dashboards rather than a metrics collection library

## Facets
- artifact type: library
- maturity: active
- function: monitoring, analytics
- domain: web-development, frontend, performance, analytics
- platform: browser
- tags: web-vitals, real-user-monitoring, performance-metrics, typescript, zero-dependencies, web-server

## Member repositories
- Zizzamia/perfume.js (main) score 44

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:48.585952+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-29T18:44:58.457717+00:00, confidence not recorded.
  - readme: https://github.com/Zizzamia/perfume.js (fetched 2026-08-28T04:07:48.585952+00:00, sha f83f1389d0b0)
  - homepage: https://zizzamia.github.io/perfume/ (fetched 2026-08-29T09:38:35.824314+00:00, sha 68422387cc75)
- Data as of 2026-08-30T08:39:29.467469+00:00.