Skip to main content

Getting set up with frontend

Before we start

Make sure Infrahub Backend is up and running. If not, in your terminal execute:

invoke demo.destroy demo.start demo.load-infra-schema demo.load-infra-data

Infrahub is built with React and uses pnpm as its package manager. Make sure you're running Node.js 24+ and pnpm 10+, to verify, run:

node --version
pnpm --version

1. Install dependencies​

cd frontend/app
pnpm install

2. Start a local server​

pnpm start

You can access your local server at http://localhost:8080/. If you are not familiar with Infrahub, follow our Overview Guide.

3. Run all tests​

Unit & integration tests​

pnpm test

# same with coverage
pnpm test:coverage

E2E tests​

E2E tests live in tests/e2e/ and run from the repository root (not from frontend/app), against a locally built Infrahub image (uv run invoke dev.build):

INFRAHUB_TESTING_IMAGE_VER=local INFRAHUB_TESTING_DOCKER_PULL=false \
  uv run pytest -c tests/e2e/pytest.ini tests/e2e

All tests should succeed. For more information on testing, read Running & Writing Tests.