Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Loki

loki.js.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • iPhone and iPad
  • Android
  • Self-hosted
8.4 Club score Visit loki.js.org

What Loki is

Loki is a free, MIT-licensed tool for finding visual regressions in Storybook projects. It captures story screenshots and compares them with reference images, producing visual differences for review. Teams can create baseline images, run tests, examine changes, and approve revised references. Loki is designed for continuous integration, where a test can fail if its required reference images are missing. Capture targets include Chrome in Docker, local Chrome, Chrome in AWS Lambda, the iOS simulator, and the Android emulator; AWS Lambda rendering is available for large test suites. The getting started guide lists Node 16 or later as a prerequisite. Recent Storybook versions need no extra integration for projects other than React Native; React Native setup imports `loki/configure-react-native`. Loki does not launch Storybook or simulator and emulator servers, so those need to be running before a test. Its documented comparison engines are pixelmatch, gm, and looks-same, with GraphicsMagick required for gm.

Who it suits

Loki suits teams maintaining Storybook projects who want to check screenshots in a CI workflow. It also supports mobile simulator and emulator captures, provided those services are already running.

Good to know, and what to watch

  • Free and MIT-licensed.
  • Supports Chrome, iOS simulator, and Android emulator captures.
  • Can run on continuous integration servers.
  • Offers AWS Lambda rendering for large test suites.
  • Requires Node 16 or later.
  • Does not start Storybook or simulator servers.
  • Documented animation limits include GIFs and SVG animations.
  • The gm diff engine requires GraphicsMagick.

Loki

Free

Free plan

Getting started

  1. Open the Loki website and documentation
  2. Install Node 16 or later
  3. Prepare Storybook and any simulator or emulator servers before testing
  4. Use the default recent-Storybook integration, or import `loki/configure-react-native` for React Native
  5. Configure Loki in `package.json`, `.lokirc`, `.lokirc.json`, or `loki.config.js`
  6. Create reference screenshots, run comparisons, review differences, and approve updated references

Limits to check

Loki does not launch Storybook, simulator, or emulator servers for you. Documented comparison limitations include looping requestAnimationFrame animations, GIFs, SVG animations, native Lottie animations, and React Native Animated.

The verdict

Loki provides a reference-image workflow for checking Storybook changes, including CI runs and mobile captures. Teams need to manage their own Storybook and simulator or emulator servers, and account for its documented animation limits.

Questions people ask

How much does Loki cost?

The Loki plan is free. It is MIT-licensed open-source software, with a free plan and no free trial.

Which capture targets does Loki support?

Targets include Chrome in Docker, local Chrome, Chrome in AWS Lambda, the iOS simulator, and the Android emulator.

Does Loki work with continuous integration?

Yes. Loki is designed for continuous-integration servers and can fail tests when reference images are missing.

What Storybook setup does Loki require?

Recent Storybook versions need no extra integration for non-React Native projects. React Native setup imports `loki/configure-react-native` in `storybook/storybook.js`.

Which image-diff engines are documented?

The documented engines are pixelmatch, gm, and looks-same. The gm engine requires GraphicsMagick.

Who maintains Loki?

The repository lists Joel Arvidsson as author and Tomas Echeverri Valencia as maintainer.

What the maker publishes

Animation limits
Documented known animation limitations include looping requestAnimationFrame animations, GIFs, SVG animations, native Lottie animations, and React Native Animated. source
AWS Lambda
A remote renderer using AWS Lambda is available for large test suites. source
Browser targets
Supported browser targets include Chrome in Docker, local Chrome, and Chrome in AWS Lambda. source
CI
Loki is designed to run on continuous integration servers, where tests can require reference images. source
Continuous integration
Loki is designed to run on continuous integration servers and can fail tests when reference images are missing. source
Custom configuration
Projects can configure Loki through a `loki` section in `package.json` or through `.lokirc`, `.lokirc.json`, or `loki.config.js`. source
Image comparison
The documented diff engines are pixelmatch, gm, and looks-same; gm requires GraphicsMagick. source
Image comparison
Loki documents pixelmatch, GraphicsMagick, and looks-same as image comparison engines. source
License
The project repository identifies Loki as MIT licensed. source
License and maintainer
The repository identifies Loki as MIT-licensed and lists Joel Arvidsson as author and Tomas Echeverri Valencia as maintainer. source
Maintainer
The repository lists Joel Arvidsson as author and Tomas Echeverri Valencia as maintainer. source
Mobile targets
Loki supports screenshots from the iOS simulator and Android emulator. source
Optional dependencies
GraphicsMagick is optional for the `gm` diffing engine, and Docker is optional for the `chrome.docker` target. source
Prerequisite
The getting started guide lists Node 16 or later as a prerequisite. source
Prerequisite
The getting-started guide lists Node 16 or newer as a prerequisite. source
Purpose
Loki tests Storybook projects for visual regressions. source
Purpose
Loki tests Storybook projects for visual regressions by comparing screenshots with reference images. source
React Native integration
React Native projects can integrate Loki by importing `loki/configure-react-native` in `storybook/storybook.js`. source
Reference images
Loki compares screenshots of stories with reference images and creates visual diffs for review. source
Security
The AWS Lambda setup guide shows an example role restricted to denying all AWS access. source
Security
The command-line reference documents a `chromeDockerWithoutSeccomp` option, which defaults to false. source
Storybook integration
For recent Storybook versions, the documentation says no further integration is needed; older versions may require a React configuration import. source
Storybook setup
The getting started guide says recent Storybook versions need no extra integration for non React Native projects; React Native setup imports loki/configure-react-native. source
Support
The site links to documentation, guides, and a user showcase as project resources. source

Checked against the maker's pages on 5 Oct 2026.