Spinner

A terminal spinner library with 109 animations, styling support, multi-spinner management, and interactive terminal integration via @visulima/interactive-manager.

Features

• 109 Spinners - Curated animations from cli-spinners, Rattles, and unicode-animations
• Styling - Declarative SpinnerStyle objects or custom (text) => string functions
• MultiSpinner - Display and manage multiple spinners concurrently
• Interactive Terminal - Coordinates with @visulima/interactive-manager for dynamic output
• Pause/Resume - Pause and resume spinner animation
• Custom Icons - Configure success, failure, warning, and info icons
• TypeScript - Full type support out of the box

Quick Example

import { InteractiveManager, InteractiveStreamHook } from "@visulima/interactive-manager";
import { Spinner } from "@visulima/spinner";

const stdoutHook = new InteractiveStreamHook(process.stdout);
const stderrHook = new InteractiveStreamHook(process.stderr);
const manager = new InteractiveManager(stdoutHook, stderrHook);

const spinner = new Spinner({ name: "dots" }, manager);

spinner.start("Loading...");
await doSomething();
spinner.succeed("Done!");

Next Steps

• Getting Started - Install and use in 30 seconds
• Usage Guide - Learn the Spinner API
• Spinner Reference - Explore all 109 spinners