Quick start - Game Harness

Activate the runtime-only mute before the application restores saved audio preferences or creates anything that can play sound:

// src/silent-qa.ts
import { activateSilentQa } from 'game-harness/silent-qa';
import { Howler } from 'howler';

export const silentQaActive = activateSilentQa(() => Howler.mute(true));

Then use the shared Playwright config and open the game through the fail-closed navigation helper:

// playwright.config.ts
import { definePlaywrightConfig } from 'game-harness/playwright';

export default definePlaywrightConfig({
  port: 4391,
  webServerCommand: (port) =>
    `pnpm build && pnpm exec vite preview --host 127.0.0.1 --port ${port} --strictPort`,
});

// tests/e2e/boot.spec.ts
import { expect, test } from '@playwright/test';
import { openSilentGame } from 'game-harness/playwright';

test('boots the intended game silently', async ({ page }) => {
  await openSilentGame(page, '/my-game/', { scenario: 'new-game' });
  await expect(page.getByRole('heading', { name: 'My Game' })).toBeVisible();
  await expect(page.locator('canvas')).toBeVisible();
});

The application marker is part of the contract: openSilentGame() does not return until <html data-audio-mode="muted-test"> exists.

Continue to Entry points for the full map of subpath exports, or jump straight to the Playwright guide.