gitwtfhub

wtf is playrun?

playruntests/playrun — explained in plain English

Analysis updated 2026-05-18

6TypeScriptAudience · developerComplexity · 4/5Setup · hard

TL;DR

A visual orchestrator that schedules and reports on Playwright test suites running as Kubernetes pods.

Mindmap

mindmap
  root((playrun))
    What it does
      Test orchestration
      Flow graphs
      Live reporting
    Tech stack
      Next.js
      Kubernetes
      PostgreSQL
      S3 storage
    Use cases
      Sharded test runs
      Smoke test gating
      Visual pipelines
    Audience
      QA engineers
      Platform teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Fan out a large Playwright test suite across many Kubernetes pods.

REASON 2

Build a visual flow graph that gates full test runs behind a smoke test.

REASON 3

Watch live test progress and reports without a separate Allure server.

What's in the stack?

Next.jsReactPostgreSQLKubernetesPrisma

How it stacks up

playruntests/playrunatomicstrata/atomicmemoryazerdsq131/mcpm
Stars666
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Real runs need a Kubernetes cluster, Postgres, and S3-compatible storage.

Wtf does this do

PlayRun is a tool for running large collections of Playwright browser tests on Kubernetes, with a visual interface for planning and watching those runs. Instead of a single long test script, you build a flow graph in the app: a smoke test that gates whether the rest should run, fanning out into per area test suites, all converging into a final notification step. A server side controller then turns that graph into Kubernetes jobs and streams the results back into the same app you built the flow in, so there is no separate reporting server to maintain. Under the hood it is a Next.js web application backed by a PostgreSQL database, with test results and recordings stored in any S3 compatible storage service. It talks to a Kubernetes cluster directly to schedule one pod per test run, and it supports logging in through Okta today, with more login providers planned. You can try the whole interface without installing anything beyond Docker: one command starts the app in a simulation mode where the UI and run history work against fake test progress, useful for exploring what it looks like. To see it schedule real Kubernetes pods and run actual Playwright tests on your own machine, a separate script sets up a small local cluster along with its own database and storage, using a public example test suite to demonstrate the flow. For a real deployment, PlayRun reads which tests exist directly from your Playwright repository on GitHub, authenticating with a personal token, an app installation, or nothing at all for public repositories. Configuration for things like the container image, test tags, and infrastructure settings lives in a single file that reloads automatically when changed, while secrets are kept separately in environment variables or your own secret manager. The project uses a source available license: you can use, modify, and self-host it freely, but you cannot resell it as a competing hosted product until two years after each release, at which point that version becomes fully open source.

Yoink these prompts

Prompt 1
Help me set up PlayRun's simulation mode to explore the UI without Kubernetes.
Prompt 2
Explain how PlayRun schedules Playwright tests as Kubernetes jobs.
Prompt 3
Show me how to configure playrun.yaml to connect my GitHub Playwright repo.
Prompt 4
Walk me through the local k3d setup for running real PlayRun tests.

Frequently asked questions

wtf is playrun?

A visual orchestrator that schedules and reports on Playwright test suites running as Kubernetes pods.

What language is playrun written in?

Mainly TypeScript. The stack also includes Next.js, React, PostgreSQL.

How hard is playrun to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is playrun for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.