Prerequisite: Please install Node.js version 20 or higher before proceeding.

Migrating from V0? Please follow the migration guide instead.

Quick start

1

Get an API key

You will need an API key to authenticate against Momentic’s servers.

To automatically pass the key to all CLI invocations, you can export the key in your shell configuration file (usually .bashrc or .zshrc) like so:

export MOMENTIC_API_KEY=your-api-key

or pass it in as a flag to all CLI commands:

--api-key your-api-key
2

Initialize a Momentic project

Run the init command. This will start an interactive wizard that will guide you through initializing a momentic.config.yaml file in the current directory. This file lets Momentic identify your project root, under which all your Momentic tests, modules, environments, and other configuration files will live.

If you are using source control (e.g. Git, Subversion, Mercurial), you should commit this file so that all team members can share the same configuration.

3

Install browsers

By default, this will download the latest version of Chromium to your local machine. This is required to run tests locally.

In order to install other browsers, you can specify them after the command, for e.g.

Was this page helpful?