# oskarkrawczyk/heyoffline

Warn your users when their network goes down. Make sure they don't lose anything.

Repository: https://github.com/oskarkrawczyk/heyoffline
Canonical: https://ross.abutalabs.com/products/heyoffline
Language: JavaScript
License Family: other
Topics: javascript, vanilla, offline
Last push: 2026-06-04T12:38:16+00:00

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

## Adoption (not part of the score)
Stars 1126, forks 66 (observed 2026-08-28T04:03:41.317923+00:00)

## What it is
Heyoffline is a framework-agnostic vanilla JavaScript library that shows a notification modal when a user's network connection goes down. It can optionally warn only when unsaved form fields have been modified, helping prevent data loss.

## Use cases
- warn users when their network goes down
- prevent users from losing unsaved form data when offline
- show an offline notification modal in a web app
- detect online/offline status changes in the browser
- monitor form fields and alert only when data would be lost

## When to choose
- you want a dependency-free vanilla JS offline warning with built-in styles
- you need to protect users from losing unsaved form input during outages
- you want a quick drop-in script or npm module without framework coupling

## When to avoid
- you need full offline functionality like service-worker caching or background sync
- you use a framework and prefer its native offline/notification ecosystem
- you need offline detection in non-browser environments

## Facets
- artifact type: library
- maturity: active
- function: ui-components, form-handling, developer-tools
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: offline-detection, vanilla-javascript, network-status, form-protection, notification-modal, javascript, nodejs

## Member repositories
- oskarkrawczyk/heyoffline (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:41.317923+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:39:12.917976+00:00, confidence not recorded.
  - readme: https://github.com/oskarkrawczyk/heyoffline (fetched 2026-08-28T04:03:41.317923+00:00, sha 693752370682)
  - registry_npm: https://registry.npmjs.org/heyoffline (fetched 2026-08-29T12:43:45.557496+00:00, sha e9d33a191380)
- Data as of 2026-08-30T08:39:29.467469+00:00.
