# LeaVerou/bliss

Blissful JavaScript

Repository: https://github.com/LeaVerou/bliss
Canonical: https://ross.abutalabs.com/products/bliss
Homepage: http://blissfuljs.com
Language: JavaScript
License: MIT
License Family: permissive
Topics: dom, events, ajax, promises, oop, es5
Last push: 2025-12-21T13:10:48+00:00

## Health v2 (maintenance only)
Score: 49/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 58, release rhythm 8, longevity 100
- inputs: {"age_days": 4033, "days_push": 255, "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 2390, forks 98 (observed 2026-08-28T04:06:43.347076+00:00)

## What it is
Bliss is a tiny (3KB) JavaScript library that makes Vanilla JS DOM APIs more pleasant to use, without wrapper objects or prototype pollution. It provides helpers for DOM manipulation, events, AJAX with promises, and OOP utilities, adding only a single optional _ property to elements and arrays.

## Use cases
- simplify DOM queries and manipulation without jQuery
- attach event listeners with a cleaner API
- make AJAX requests with promises
- chain element methods without polluting prototypes
- learn how vanilla JavaScript APIs work under the hood
- add a lightweight helper layer to a vanilla JS project

## When to choose
- you want jQuery-like ergonomics with vanilla JS semantics and no wrapper objects
- you need a very small dependency (3KB gzipped) for DOM, events, and AJAX helpers
- you support legacy browsers like IE9+ with polyfills
- you want readable, extensible source code for learning

## When to avoid
- you need a reactive component framework or virtual DOM
- your project already uses a modern framework like React or Vue
- you require TypeScript definitions or a large ecosystem of plugins
- you want a library under heavy active development

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, http-client, middleware
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: vanilla-js, dom-manipulation, micro-library, es5, promises, events, ajax, oop-helpers, nodejs

## Member repositories
- LeaVerou/bliss (main) score 49

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:43.347076+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:34:29.248478+00:00, confidence not recorded.
  - readme: https://github.com/LeaVerou/bliss (fetched 2026-08-28T04:06:43.347076+00:00, sha 9e43585e76aa)
  - homepage: http://blissfuljs.com (fetched 2026-08-29T10:15:29.751063+00:00, sha 62850fae76da)
  - site_page: https://blissfuljs.com/docs (fetched 2026-08-29T10:15:29.760550+00:00, sha ac8edf13d70b)
- Data as of 2026-08-30T08:39:29.467469+00:00.