Dokkimi — Integration, E2E & Visual Regression Testing

Test Everything

The only testing framework that does integration, E2E, and visual regression testing. All without a staging environment.

Install Dokkimi and run your first test in minutes.

brew install dokkimi/tap/dokkimi

npm install -g dokkimi

Built for AI

Dokkimi was built to integrate seamlessly into your agentic coding workflow. Your agent already understands your application E2E, now you can let it test it properly.

JSON & YAML Definitions Structured config files that AI agents can read, write, and iterate on natively.

Built-in AI Context Ships with context files so your coding agent understands the tool from the start.

AI-Friendly CLI Commands designed for agents to invoke, parse, and act on without hand-holding.

Full Raw Output Complete test run output so AI can debug failures and iterate without guessing.

Why Dokkimi?

Unit tests mock away the interesting parts. Staging environments drift from reality. Dokkimi gives you production-like environments on demand.

Drive a real browser alongside your services. Click, type, navigate, and assert on what the user sees.

Screenshot any step, diff against baselines. Catch visual regressions before they ship.

Capture every HTTP call between services. Assert on exactly what was sent and received.

Intercept calls to external APIs such as Stripe, Auth0, Twilio, and more. Return controlled responses. No test accounts needed.

Every test run gets its own namespace with dedicated services, databases, and browser. No shared state. No corrupted tests.

Seed Postgres, MySQL, MongoDB, or Redis before tests with custom data. Query directly in assertions to verify content.

Dokkimi definitions are designed for coding agents. Let Claude, Cursor, or Copilot write and debug your tests.

Your services run unmodified. Dokkimi wires up sidecars, routing, DNS, browser, and cleanup.

Unmatched Coverage

Most tools only cover a slice. Dokkimi covers the whole picture.

How It Works

Define your services, databases, and tests in simple YAML/JSON. Dokkimi handles the rest.

# .dokkimi/blog/definitions/publish-post.yaml
name: author-publish-flow
items:
  - $ref: ../shared/web-app.yaml
  - $ref: ../shared/api-gateway.yaml
  - $ref: ../shared/post-service.yaml
  - $ref: ../shared/postgres-db.yaml
  - $ref: ../shared/mock-auth0-jwks.yaml

tests:
  - name: Publish a new post
    steps:
      # Drive the browser through the publish flow
      - action:
          type: ui
          url: http://web-app:3000/posts/new
          subSteps:
            - action: type
              selector: '#title'
              value: 'My new post'
            - action: click
              selector: '[data-testid="publish-btn"]'
            - action: waitForSelector
              selector: '[data-testid="success-toast"]'
            - action: screenshot
              name: post-published
        assertions:
          # Verify the API call went through correctly
          - match:
              origin: web-app
              method: POST
              url: api-gateway/v1/posts
            assertions:
              - path: response.status
                operator: eq
                value: 201

      # Query the database directly to verify
      - action:
          type: dbQuery
          database: postgres-db
          query: "SELECT title FROM posts WHERE title = 'My new post'"
        assertions:
          - assertions:
              - path: data.length
                operator: eq
                value: 1

Define

Declare services, databases, mocks, and UI flows in YAML. Reference shared fragments with $ref.

Run

dokkimi run deploys everything into an isolated K8s namespace — services, database, browser, and all.

Assert Everywhere

Assert on HTTP traffic between services, query the database directly, and diff screenshots against baselines for visual regression detection.

Learn More

Dive into the docs or follow a step-by-step tutorial.

Pricing

Free to run locally and in CI. Cloud pricing coming soon.

Run on your machine with Docker + Kubernetes
Unlimited test definitions and runs
E2E UI testing with headless Chromium
Visual regression with screenshot diffing
Traffic interception, mocks, and database assertions
CI/CD with the GitHub Action
CLI + AI agent integration

Get started

Zero infrastructure — no k3s, no cluster setup
Fast parallel execution across dedicated VMs
Test results dashboard and history
Flaky test detection and regression tracking
Visual baseline management UI

Join the waitlist