# Loki

Visual regression testing tool that screenshots Storybook stories and compares them with reference images.


Source: https://findsoftware.frbit.cloud/loki/
Last reviewed: 2026-10-28
Listed since: 2026-10-28

## Record

### Links

- home: https://loki.js.org/
- repository: https://github.com/oblador/loki
- docs: https://loki.js.org/getting-started.html

### Identity

- status: active
- maintainer: Joel Arvidsson
- maintainerType: individual
- parent: unknown
- firstRelease: 2017
- hqCountry: unknown

### Kind

- category: testing
- hosting: not applicable
- language: javascript
- runtime: node
- runtimeMin: not applicable
- basedOn: storybook

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: local
- renderingModes: not applicable
- installMethod: yarn add loki --dev, then yarn loki init

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 0
- latestReleaseDate: 2024-08-27

### Adoption

- githubStargazers: 1915
- packagistDownloads: not applicable
- npmWeeklyDownloads: 27338
- contributors: 62
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 315
- dependentPackages: 137

### Sources

- urls: https://loki.js.org/ (read 2026-10-28)
- urls: https://api.github.com/repos/oblador/loki (read 2026-10-28)
- urls: https://loki.js.org/getting-started.html (read 2026-10-28)
- maintainer: https://github.com/oblador/loki/blob/master/LICENSE (read 2026-10-28)
- language: https://api.github.com/repos/oblador/loki (read 2026-10-28)
- category: https://github.com/oblador/loki/blob/master/packages/loki/README.md (read 2026-10-28)
- basedOn: https://github.com/oblador/loki/blob/master/packages/loki/README.md (read 2026-10-28)
- runtime: https://loki.js.org/getting-started.html (read 2026-10-28)
- installMethod: https://loki.js.org/getting-started.html (read 2026-10-28)
- runsAs: https://loki.js.org/continuous-integration.html (read 2026-10-28)
- license: https://api.github.com/repos/oblador/loki (read 2026-10-28)
- licenseModel: https://github.com/oblador/loki/blob/master/LICENSE (read 2026-10-28)
- firstRelease: https://registry.npmjs.org/loki (read 2026-10-28)
- currentMajor: https://api.github.com/repos/oblador/loki/releases (read 2026-10-28)
- latestReleaseDate: https://api.github.com/repos/oblador/loki/releases (read 2026-10-28)
- githubStargazers: https://api.github.com/repos/oblador/loki (read 2026-10-28)
- contributors: https://api.github.com/repos/oblador/loki/contributors (read 2026-10-28)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-09-28:2026-10-04/loki (read 2026-10-28)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/loki (read 2026-10-28)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/loki (read 2026-10-28)

## Notes

Loki is a visual regression tester for Storybook stories. It captures a screenshot of each story and compares it with reference images that are checked into the project's git repository. It runs on Node and is added to a project with a package manager.

Loki does not start any servers, so the Storybook it tests has to be available when the tests run. The [continuous integration guide](https://loki.js.org/continuous-integration.html) describes it as built to run on a CI server. It renders stories with Chrome, either in Docker or as a local application, and the README also lists Chrome in AWS Lambda.

## Worth knowing

The Docker target needs Docker, the local Chrome target needs a Chrome installation, and the gm diffing engine needs GraphicsMagick.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0