🔥 NoFlake

AI-powered E2E tests that write themselves.

Three commands. Zero babysitting. NoFlake reads your codebase, generates Playwright E2E tests, runs them, and fixes them when they break.

Quick Start

npm install -D noflake
npx noflake init

The interactive init walks you through your entire testing stack setup.

AI Agent Mode

If you're using an AI coding agent (Copilot, Cursor, Cline, etc.), use the --ai flag for non-interactive setup:

# Show available options (for the AI to read)
npx noflake init --ai

# Run with flags (no prompts)
npx noflake init --ai --type=web --framework=next --e2e=playwright --unit=jest
npx noflake init --ai --type=mobile --mobile=react-native --e2e=detox --unit=jest
npx noflake init --ai --type=both --framework=next --mobile=react-native --sentry

Or pipe a JSON object if you already know the config:

echo '{"type":"web","framework":"next","e2e":"playwright","unit":"jest"}' | npx noflake init --ai

Auto-detects non-TTY environments and enters AI mode automatically.

Commands

| Command | Status | Description | |---------|--------|-------------| | noflake init | ✅ Available | Interactive project setup & testing stack install | | noflake write | ⏳ Coming soon | Generate a full E2E test suite from your codebase | | noflake update | ⏳ Coming soon | Patch tests based on code changes | | noflake run | ⏳ Coming soon | Execute tests and generate a report |

What init does

The interactive setup asks what you're building and installs the right tools:

| Your project | E2E testing | Unit testing | Error monitoring | |---|---|---|---| | Web (Next.js, React/Vite, Vue, Svelte, Express) | Playwright | Vitest or Jest (you choose) | Sentry | | Mobile — React Native | Detox | Jest | Sentry | | Mobile — Flutter | integration_test (built-in) | flutter_test (built-in) | sentry_flutter | | Mobile — Swift / SwiftUI | XCUITest (built-in) | XCTest (built-in) | Sentry Cocoa | | Mobile — Kotlin / Jetpack Compose | Espresso (built-in) | JUnit (built-in) | sentry-android | | Both | Playwright + mobile E2E | Vitest/Jest + mobile unit | Sentry |

What gets created

• .noflake/ — state directory for test tracking
• .noflakerc.json — config with your project type, framework, and preferences
• playwright.config.ts — if you chose Playwright E2E
• vitest.config.ts — if you chose Vitest unit testing
• jest.config.ts — if you chose Jest unit testing
• .detoxrc.js — if you chose Detox mobile E2E
• e2e/jest.config.js — Detox test runner config (auto-generated with .detoxrc.js)
• Sentry config files — matched to your framework (@sentry/nextjs, @sentry/react, etc.)
• tests/e2e/ and tests/unit/ — with starter test files
• Git post-commit hook (optional) — auto-runs noflake update on commit

Package version resolution

noflake init dynamically resolves the latest stable version of every package from the npm registry before installing. No stale pinned versions.

How It Works

1. noflake write — Scans your codebase, database schema, routes, and auth patterns. Generates E2E tests. Runs them. Self-heals if a test fails because the test is wrong.
2. noflake update — Reads git diff, identifies affected tests, patches them, verifies they pass. Auto-runs on commit via git hook.
3. noflake run — Runs your full suite, generates a markdown report with pass/fail, failure screenshots, and AI-suggested fixes.

What It Detects

• Frameworks — Next.js, React, Vue, Svelte, Express
• Database schemas — Prisma, Drizzle, Supabase, raw SQL
• Auth patterns — NextAuth, Clerk, Supabase Auth, Lucia, Firebase
• Routes — App Router pages, API routes, dynamic routes

Zero Dependencies

The noflake CLI itself has zero npm dependencies. It uses only Node.js built-in modules (readline, https, fs, child_process). The tools it installs (Playwright, Vitest, Sentry, etc.) are added to your project's devDependencies.

Coming Soon

NoFlake is currently in active development. Visit noflake.sh for updates.

Follow @noflake on X.

Built by Foxxception LLC.