whatisgithub

What is hint.css?

chinchang/hint.css — explained in plain English

Analysis updated 2026-06-24

8,446CSSAudience · developerComplexity · 1/5LicenseSetup · easy

In one sentence

hint.css is a tiny CSS-only tooltip library that adds accessible hover tooltips to any web page by adding a CSS class and an aria-label attribute, no JavaScript required.

Mindmap

mindmap
  root((hint.css))
    What it does
      CSS-only tooltips
      No JavaScript needed
      Accessible by default
    Tooltip Options
      Position above/below/sides
      Color themes
      Always-visible mode
    Tech
      CSS classes
      aria-label attribute
      SCSS source
    Audience
      Web developers
      Frontend designers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add hover tooltips to buttons, icons, or links on any web page without writing any JavaScript.

USE CASE 2

Display accessible warning, error, or info labels on UI elements using built-in color modifier classes.

USE CASE 3

Create screen-reader-friendly tooltips using the standard aria-label attribute rather than the title attribute.

What is it built with?

CSSSCSS

How does it compare?

chinchang/hint.cssbarryclark/jekyll-nowhubspot/offline
Stars8,4468,3948,585
LanguageCSSCSSCSS
Setup difficultyeasyeasyeasy
Complexity1/51/51/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Free to use for any purpose, personal or commercial, as long as you keep the copyright notice.

So what is it?

hint.css is a small CSS library that adds tooltips (small popup labels that appear when you hover over an element) to any website, without requiring any JavaScript. You attach a tooltip to an HTML element by adding a CSS class that controls where the tooltip appears, and an aria-label attribute that holds the text to display. The library handles the rest through CSS alone, using pseudo-elements and CSS transitions to show and hide the label on hover. Because it uses aria-label, which is a standard HTML accessibility attribute designed to describe elements for screen readers, the tooltips are accessible to users who rely on assistive technology. This is a deliberate design choice stated in the README. Tooltips can be positioned to appear above, below, to the left, or to the right of the element. Modifiers let you control the color (info, warning, error, success), the size, whether the tooltip always stays visible, whether it has rounded corners, whether animation is disabled, and several other visual properties. You combine class names to mix these options. Installation is straightforward: download the CSS file, reference it via a CDN, or install it through npm. Once the file is linked in your page, no further setup is needed. The library comes in full and base builds, the base build strips out color themes and extra effects for a smaller file size. The project is written in SCSS (a CSS preprocessor) and the source files are available in the repository if you want to customize the class name prefix or add new tooltip variants. It is MIT licensed and free for personal and commercial use. A list of companies and projects that use hint.css is included in the README, including Fiverr and Webflow Playground.

Copy-paste prompts

Prompt 1
Show me the HTML markup and CSS class names to add a red error tooltip that appears above a button using hint.css.
Prompt 2
How do I install hint.css via npm and import it into a Sass build to change the default class name prefix?
Prompt 3
I want a tooltip that is always visible (not just on hover) on an icon in my nav bar, which hint.css modifier class does that?
Prompt 4
Replace all title attribute tooltips on a page with hint.css aria-label tooltips positioned to the right of each element.

Frequently asked questions

What is hint.css?

hint.css is a tiny CSS-only tooltip library that adds accessible hover tooltips to any web page by adding a CSS class and an aria-label attribute, no JavaScript required.

What language is hint.css written in?

Mainly CSS. The stack also includes CSS, SCSS.

What license does hint.css use?

Free to use for any purpose, personal or commercial, as long as you keep the copyright notice.

How hard is hint.css to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is hint.css for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.