Back to Explore

sindresorhus/cli-spinners

GitHub
1 watchersOpen source

Last release: 4 months ago

Provides a set of 70+ terminal spinner animations for use in command-line apps, with each spinner defined by an interval (milliseconds) and an array of frames. Useful for showing progress indicators, and you can use the spinners directly or through the related `ora` package.

Project status

  • Actively maintained, with a recent upstream push on 2026-02-16 and multiple tagged updates in 2025 to 2026 (v3.2.1, v3.3.0, v3.4.0).
  • Update cadence appears moderate and development-focused, with updates spaced about 3 to 4 months between v3.3.0 (2025-09-25) and v3.4.0 (2026-01-13), and a smaller follow-up about a week after v3.2.1 (2025-09-17).

AI summary generated Today

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v3.4.0

    4 months ago

    Release v3.4.0 adds a new terminal spinner named `fish`. The code changes are limited to updating the spinner definitions in `spinners.json`, plus a package version bump.

    Features

  • v3.3.0

    8 months ago

    v3.3.0 adds a new spinner named `rollingLine`. The change updates the published spinner registry and the TypeScript type that enumerates valid spinner names.

    Features

  • v3.2.1

    8 months ago

    v3.2.1 makes a small fix related to the hearts spinner. The only actual spinner content change visible in the diff is an update to the heart emoji used in the hearts spinner frames.

  • v3.2.0

    9/7/2024

    v3.2.0 adds a new terminal spinner named `dotsCircle`. The update includes the spinner definition and extends the exported `SpinnerName` type to include the new name.

    Features

  • v3.1.0

    7/1/2024

    v3.1.0 adds a new terminal spinner named dots14. The release notes mention only the dots14 spinner, but the code changes also update the TypeScript types.

    Features

  • v3.0.0

    4/30/2024

    cli-spinners v3.0.0 is converted to a pure ESM package and updated to require Node.js 18. The implementation now imports spinner frames directly from spinners.json, and it changes the public API surface by moving “random spinner” behavior into a dedicated function rather than a property getter.

    BreakingFeatures

  • v2.9.2

    11/24/2023

    v2.9.2 primarily updates the TypeScript type definitions to include the `sand` spinner. The release notes only mention the missing types fix, while the diff also includes repository maintenance changes (GitHub Actions, funding file, and README updates) that are not described.

  • v2.9.1

    9/13/2023

    Release v2.9.1 makes a small fix to the bouncingBar spinner animation. The code change adds an additional animation frame in spinners.json and bumps the package version to 2.9.1.

  • v2.9.0

    5/2/2023

    v2.9.0 adds a new terminal spinner named `binary`. The release notes document the addition, and the code diff shows corresponding updates to the public TypeScript spinner name union and the underlying spinner definition data.

    Features

  • v2.8.0

    4/5/2023

    v2.8.0 primarily adds a new terminal spinner named dwarfFortress. The change is reflected in both the TypeScript type definitions and the spinner data source.

    Features