# usablica/intro.js

Lightweight, user-friendly onboarding tour library

Repository: https://github.com/usablica/intro.js
Canonical: https://ross.abutalabs.com/products/introjs
Homepage: http://introjs.com
Language: TypeScript
License: NOASSERTION
License Family: other
Topics: introjs, html, javascript, guide, tour, ux, cdn, minify
Last push: 2026-08-07T09:25:25+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 94, longevity 100
- inputs: {"age_days": 4924, "days_push": 26, "days_rel": 43, "gap_med": 7, "n_releases_24m": 4}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 23455, forks 2550 (observed 2026-08-28T04:11:34.943776+00:00)

## What it is
Intro.js is a lightweight, dependency-free vanilla JavaScript and CSS library for creating step-by-step onboarding tours and hints on web pages. Steps are defined via data-intro/data-step HTML attributes or JSON configuration, and it ships with wrappers for frameworks like React, Angular, and Rails.

## Use cases
- add a step-by-step product tour to a web app
- create user onboarding walkthroughs for new users
- show contextual hints highlighting UI elements
- guide users through a new feature with tooltips
- add a first-visit introduction overlay to a website
- build onboarding flows in React or Angular apps

## When to choose
- you need a lightweight (~10kB) tour library with no dependencies
- you want to define tours declaratively via HTML attributes
- you need RTL support, progress bars, and theming out of the box
- you want a mature, widely adopted onboarding library

## When to avoid
- your project is not AGPL-compatible and you cannot purchase a commercial license
- you need a fully hosted, analytics-driven onboarding SaaS rather than a code library
- you need complex branching or conditional multi-flow onboarding logic

## Facets
- artifact type: library
- maturity: stable
- function: ui-components, frontend-framework
- domain: web-development, frontend, developer-tools
- platform: browser
- tags: onboarding, product-tour, user-onboarding, walkthrough, hints, agpl, vanilla-javascript, rtl-support, javascript, nodejs

## Member repositories
- usablica/intro.js (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:34.943776+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-29T16:56:28.081289+00:00, confidence not recorded.
  - readme: https://github.com/usablica/intro.js (fetched 2026-08-28T04:11:34.943776+00:00, sha c75d5032177a)
  - homepage: http://introjs.com (fetched 2026-08-29T07:54:44.386802+00:00, sha fe8f6851580c)
  - site_page: https://introjs.com/docs (fetched 2026-08-29T07:54:44.396653+00:00, sha 53630263d895)
  - site_page: https://introjs.com/docs/getting-started/install (fetched 2026-08-29T07:54:44.398669+00:00, sha ab7b2b60a654)
  - site_page: https://introjs.com/docs/examples/basic/hello-world (fetched 2026-08-29T07:54:44.402978+00:00, sha e066a7f7072c)
  - site_page: https://introjs.com/docs/examples/basic/floating-tooltip (fetched 2026-08-29T07:54:44.404889+00:00, sha dd77730d182f)
  - site_page: https://introjs.com/docs/examples/customizing/progress-bar (fetched 2026-08-29T07:54:44.406535+00:00, sha 13b64805ef44)
  - site_page: https://introjs.com/docs/examples/advanced/scrollable-element (fetched 2026-08-29T07:54:44.408002+00:00, sha cac0967b6aa4)
  - site_page: https://introjs.com/docs/community (fetched 2026-08-29T07:54:44.409636+00:00, sha 19de5a00578f)
  - registry_npm: https://registry.npmjs.org/intro.js (fetched 2026-08-29T07:54:44.411117+00:00, sha c149c43d08af)
- Data as of 2026-08-30T08:39:29.467469+00:00.