sindresorhus/cli-spinners

Spinners for use in the terminal

2,930

stars

97

commits

JavaScript

primary language

Feb 16, 2026

updated

README

cli-spinners

70+ spinners for use in the terminal




The list of spinners is just a JSON file and can be used wherever.

You probably want to use one of these spinners through the ora package.

Install

npm install cli-spinners

Usage

import cliSpinners from 'cli-spinners';

console.log(cliSpinners.dots);
/*
{
	interval: 80,
	frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
}
*/
  • interval is the intended time per frame, in milliseconds.
  • frames is an array of frames to show for the spinner.

Preview

The header GIF is outdated. See live demo.

API

cliSpinners

Each spinner comes with a recommended interval and an array of frames.

See the spinners.

randomSpinner()

Get a random spinner.

import {randomSpinner} from 'cli-spinners';

console.log(randomSpinner());
/*
{
	interval: 80,
	frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
}
*/

Contributors

(top 30 of 37)

sindresorhus

58 commits

Richienb

2 commits

derhuerst

2 commits

BendingBender

2 commits

sindresorhus/cli-spinners

Spinners for use in the terminal

2,930

stars

97

commits

JavaScript

primary language

Feb 16, 2026

updated

README

cli-spinners

70+ spinners for use in the terminal




The list of spinners is just a JSON file and can be used wherever.

You probably want to use one of these spinners through the ora package.

Install

npm install cli-spinners

Usage

import cliSpinners from 'cli-spinners';

console.log(cliSpinners.dots);
/*
{
	interval: 80,
	frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
}
*/
  • interval is the intended time per frame, in milliseconds.
  • frames is an array of frames to show for the spinner.

Preview

The header GIF is outdated. See live demo.

API

cliSpinners

Each spinner comes with a recommended interval and an array of frames.

See the spinners.

randomSpinner()

Get a random spinner.

import {randomSpinner} from 'cli-spinners';

console.log(randomSpinner());
/*
{
	interval: 80,
	frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
}
*/

Contributors

(top 30 of 37)

sindresorhus

58 commits

Richienb

2 commits

derhuerst

2 commits

BendingBender

2 commits

Languages

JavaScript

100.0%