@twai/next

Helpers for working with Next.js projects in TWAI (Test With AI) tests:

• Start/stop a Next dev server programmatically
• Generate a Playwright preset (baseURL + dev server lifecycle)

startNext()

import { startNext } from "@twai/next";

const server = await startNext({
  cwd: "./examples/next-basic",
  port: 3000,
  reuseIfRunning: true,
});

console.log(server.baseUrl); // http://127.0.0.1:3000

// ...run tests...
await server.stop();

Playwright preset

import { defineConfig } from "@playwright/test";
import { createPlaywrightNextPreset } from "@twai/next";

const preset = createPlaywrightNextPreset({
  cwd: "./examples/next-basic",
  port: 3000,
});

export default defineConfig({
  ...preset,
  use: {
    ...preset.use,
    trace: "retain-on-failure",
  },
});

CLI integration

If you enable Next auto-start in aitest.config.ts, aitest run will start/stop the dev server automatically.