Skip to content

Dashboard

The Raiken dashboard is a browser-based interface for generating tests and managing your test suite.

Overview

The dashboard connects to the CLI server via tRPC, enabling real-time streaming of generated tests.

Key features

Prompt composer

Write natural language descriptions of the tests you want to generate:

Test that a user can log in with valid credentials
and see their dashboard with a welcome message.

The prompt composer supports:

  • Multi-line input for complex scenarios
  • File references with @path/to/file.tsx
  • URL references like http://localhost:3000/login

Real-time streaming

Watch your test generate token-by-token:

Streaming Output
Generating test: "user login flow"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 78%
import { test, expect } from '@playwright/test';
test('user can log in with valid credentials', async ({ page }) => {
await page.goto('/login');
await page.getByLabel('Email').fill('user@example.com');

No waiting for completion — review as it writes and cancel early if needed.

Selector suggestions

The dashboard shows suggested selectors ranked by stability:

SelectorTypeStability
getByRole('button', { name: 'Sign in' })RoleHigh
getByLabel('Email')LabelHigh
getByTestId('login-form')Test IDMedium
locator('.btn-primary')CSSLow

Role-based and label-based selectors are preferred for their resilience to UI changes.

Interactive review

After generation:

  1. Review — Read through the generated test
  2. Edit — Make manual adjustments if needed
  3. Retry — Refine your prompt and regenerate
  4. Save — Save to your project’s test directory

Workflow

1. Start the dashboard

Terminal
raiken start

Open http://localhost:7101 in your browser.

2. Enter a prompt

Describe the test you want in natural language:

Generate tests for the Counter component that test
increment, decrement, and reset functionality.

3. Review the output

The test streams to the UI. Review it as it’s generated.

4. Save or refine

If the test looks good, save it. If not, add a follow-up prompt:

Add a test for the edge case where decrement is clicked
when the counter is already at zero.

5. Run your tests

Once saved, run tests with your usual workflow:

Terminal
npx playwright test

Tips

  • Be specific — Clear prompts produce better tests
  • Iterate — Start simple, then refine with follow-up prompts
  • Use file references@src/components/Login.tsx gives Raiken more context
  • Include URLs — Helps Raiken capture the right page for DOM context