Loki
loki.js.org
- Free plan
- Windows
- macOS
- Linux
- Web
- iPhone and iPad
- Android
- Self-hosted
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.
Plans
Every plan and priceLoki
Free plan
Getting started
- Open the Loki website and documentation
- Install Node 16 or later
- Prepare Storybook and any simulator or emulator servers before testing
- Use the default recent-Storybook integration, or import `loki/configure-react-native` for React Native
- Configure Loki in `package.json`, `.lokirc`, `.lokirc.json`, or `loki.config.js`
- 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.