# WickyNilliams/headroom.js

Give your pages some headroom. Hide your header until you need it

Repository: https://github.com/WickyNilliams/headroom.js
Canonical: https://ross.abutalabs.com/products/headroomjs
Homepage: https://wicky.nillia.ms/headroom.js/
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2023-10-25T11:50:31+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": 4774, "days_push": 1043, "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 10838, forks 795 (observed 2026-08-28T04:10:44.468850+00:00)

## What it is
Headroom.js is a lightweight, dependency-free JavaScript widget that hides fixed headers when scrolling down and reveals them when scrolling up by toggling CSS classes. It works with plain JS plus optional jQuery and AngularJS integrations.

## Use cases
- hide header on scroll down and show on scroll up
- make fixed navigation less obtrusive on small screens
- react to user scroll with CSS classes
- add slide in/out animation to page header
- free up vertical space for page content

## When to choose
- you want a tiny (~1.4KB gzipped) dependency-free scroll widget
- you prefer full styling control via CSS classes
- you need a universal build for script tags, CommonJS, or AMD

## When to avoid
- you need a full-featured scroll/animation library with many effects
- you want a framework component with native React/Vue bindings out of the box
- you need active development of new features

## Facets
- artifact type: library
- maturity: maintenance
- function: animation, ui-components, frontend-framework
- domain: web-development, frontend
- platform: browser
- tags: scroll, header, fixed-header, javascript, no-dependencies, css-classes, nodejs

## Member repositories
- WickyNilliams/headroom.js (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:44.468850+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-29T17:17:30.462872+00:00, confidence not recorded.
  - readme: https://github.com/WickyNilliams/headroom.js (fetched 2026-08-28T04:10:44.468850+00:00, sha 83242b3d0def)
  - homepage: https://wicky.nillia.ms/headroom.js/ (fetched 2026-08-29T08:16:49.393253+00:00, sha b2011acbdb5c)
  - registry_npm: https://registry.npmjs.org/headroom.js (fetched 2026-08-29T08:16:49.395905+00:00, sha eb722811413b)
- Data as of 2026-08-30T08:39:29.467469+00:00.