Testing

What it does

This skill automates a comprehensive testing setup for Next.js applications, incorporating Neon database branching, Playwright browser tests, integration tests, and unit tests. It creates isolated test environments with automatic cleanup using TTL (Time-To-Live), streamlines server orchestration, and manages environment variables effectively. The goal is to ensure code quality by identifying potential issues quickly through a structured testing workflow.

When to use it

• When setting up automated regression tests for a Next.js application connected to a Neon Postgres database.
• For ensuring the reliability of API routes through direct handler imports in integration tests.
• To perform end-to-end browser testing, validating user interactions and visual feedback using Playwright.
• When needing isolated test environments with automatic cleanup for efficient development cycles.
• To establish a consistent testing strategy prioritizing Playwright for UI, integration tests for APIs, and unit tests for logic.

Key capabilities

• Neon database branching for isolated testing environments.
• Automatic TTL cleanup of schema-only branches.
• Unit testing with Bun's built-in test runner (Jest-compatible syntax).
• Integration testing by importing API handlers directly with Bun.
• Browser testing using Playwright for end-to-end automation.
• Parallel test execution with isolated data per suite.

Example prompts

• "Run the browser tests using Playwright."
• "Execute the integration tests for the API routes."
• "Start a new Neon test branch and run the unit tests."

Tips & gotchas

• This skill requires several prerequisite recipes to be completed first, including setting up type-safe environment configuration, connecting to Neon Postgres with Drizzle ORM, creating Neon test branches, configuring unit tests, and setting up integration and browser tests. Refer to the linked URLs for detailed instructions.
• The testing strategy prioritizes Playwright for UI testing, integration tests for APIs, and unit tests for logic; ensure your tests are structured accordingly.