intro.js README

The project's README from github.com/usablica/intro.js. As one markdown file: README.md.

Intro.js

Build Status npm

User Onboarding and Product Walkthrough Library

Where to get

You can obtain your local copy of Intro.js from:

1) This GitHub repository, using git clone https://github.com/usablica/intro.js.git

2) Using yarn yarn add intro.js

3) Using npm npm install intro.js --save

4) Download it from CDN (1, 2)

How to use

Intro.js can be added to your site in three simple steps:

1) Include intro.js and introjs.css (or the minified version for production) in your page. Use introjs-rtl.min.css for Right-to-Left language support.

CDN hosted files are available at jsDelivr (click Show More) & cdnjs.

2) Add data-intro and data-step to your HTML elements. To add hints you should use data-hint attribute.

For example:

<a href='http://google.com/' data-intro='Hello step one!'></a>

See all attributes here.

3) Call this JavaScript function:

introJs().start();

Optionally, pass one parameter to introJs function to limit the presentation section.

For example introJs(".introduction-farm").start(); runs the introduction only for elements with class='introduction-farm'.

Documentation

Please visit Documentation.

Using with:

Intro.js has many wrappers for different purposes. Please visit Documentation for more info.

Build

First you should install nodejs and npm, then first run this command: npm install to install all dependencies.

Now you can run this command to minify all static resources:

npm run build

Contributors ✨


Afshin Mehrabani

💻 📖

bozdoz

💻 📖

Support/Discussion

License

Commercial license

If you want to use Intro.js for a commercial application, theme or plugin the commercial license is the appropriate license. With this option, your source code is kept proprietary. Purchase a commercial license at introjs.com

Open-source license

GNU AGPLv3

intro.js (usablica/intro.js)

Searching Database…

23.5K ·GitHub
What is this?Intro.js is a lightweight user-onboarding and product-walkthrough library for the web — it adds guided, step-by-step tours that introduce a site or app to its users.
Is this a hosted service or something I embed in my own pages?Something you embed: it's a client-side JavaScript library (written in TypeScript) that ships as one intro.js file plus introjs.css — no service or account involved.
How do I add a tour to my site?Get it via npm or yarn, or from a CDN (jsDelivr/cdnjs); include intro.js and introjs.css, mark elements with data-intro and data-step attributes, then call introJs().start().
Do I need anything special to run it?No — it runs in the browser with zero runtime dependencies: just the intro.js script and its stylesheet. Node and npm are only needed to build from source.
Can I use it in a commercial project for free?It's dual-licensed: GNU AGPLv3 for open-source use, but commercial applications, themes or plugins require a paid commercial license purchased at introjs.com.
Can I limit a tour to just one section of a page?Yes — pass a selector to introJs(): introJs('.introduction-farm').start() runs the introduction only for elements with that class.
Does it offer anything lighter than a full tour?Yes, hints: add a data-hint attribute to elements to show hint callouts on them, separate from the ordered data-intro/data-step tour steps.
What about right-to-left languages?Supported — include introjs-rtl.min.css instead of the default stylesheet to get right-to-left language support.
Are there ready-made wrappers for frontend frameworks?The README says Intro.js has many wrappers for different purposes and points to its documentation for details, without naming specific frameworks there.
Creator
usablica
Size
52.3 MB
Stars
23.5K
Age
13y
Commits · 90 Days