@approxima/wizard

One-shot installer for @approxima/playwright. Run it once in your project and it wires everything up.

Usage

From the root of an existing Playwright project:

npx @approxima/wizard

That's it. The wizard runs interactively, prompts for your Approxima API key, and exits. Nothing of the wizard itself ends up in your dependencies — it's a scaffolder, not a runtime.

What it does

1. Saves your API key to .env as APPROXIMA_API_KEY.
2. Installs @approxima/playwright as a dev dependency (auto-detects npm / yarn / pnpm / bun from your lockfile).
3. Rewrites test imports from @playwright/test to @approxima/playwright across your test files.
4. Patches playwright.config.* — adds the reporter, parameterizes defineConfig<ApproximaOptions>, and inserts the use.approxima block.
5. Drops an audit prompt at approxima-verify.md so your coding agent can sanity-check the install.

Our Promise

If you use Approxima and decide it's not for you, you can continue to use the Approxima wrapper on Playwright, it will continue to work just as your Playwright tests used to just without the Approxima magic.

Requirements

• Node >=20
• An existing project with a package.json and a playwright.config.{ts,js,mjs,cjs}
• Network access (to install the SDK and to reach Approxima's agent service at runtime)

Re-running

The wizard is roughly idempotent — re-running on a project that's already set up will skip the install (with an offer to reinstall), skip the config patch (if approxima: is already present), and overwrite approxima-verify.md. Safe to run again if something went sideways.

License

MIT