create-tests - SKILL.md Agent Skill

name: create-tests description: This skill should be used when the user asks to "create tests", "write tests", "add unit tests", "add e2e tests", "test this component", or mentions testing, Vitest, Playwright, or test coverage. Covers unit tests with Vitest and e2e tests with Playwright including organization logic.

Create comprehensive tests for NowTS application using Vitest for unit tests and Playwright for e2e tests. Ensure proper mocking, organization logic handling, and test data management. Create unit test in `__tests__/` directory:

import { describe, expect, it, vi } from "vitest";
import { screen, waitFor } from "@testing-library/react";
import { setup } from "@test/setup";

describe("ComponentName", () => {
  it("should render correctly", async () => {
    const { user } = setup(<ComponentName />);

    expect(screen.getByText("Expected Text")).toBeInTheDocument();
  });
});

Run: pnpm test:ci

Create e2e test in `e2e/` directory:

import { expect, test } from "@playwright/test";
import { createTestAccount } from "./utils/auth-test";

test("user flow description", async ({ page }) => {
  const userData = await createTestAccount({
    page,
    callbackURL: "/orgs",
  });

  await page.waitForURL(/\/orgs\/.*/);
  expect(page.url()).toMatch(/\/orgs\/.*/);
});

Run: pnpm test:e2e:ci

**CRITICAL - Always use CI commands:**

pnpm test:ci - Unit tests (non-interactive)
pnpm test:e2e:ci - E2E tests (headless)

NEVER use interactive commands (pnpm test, pnpm test:e2e)

``` nowts/ ├── __tests__/ # Unit tests (Vitest) ├── e2e/ # E2E tests (Playwright) │ └── utils/ # E2E helpers ├── test/ │ ├── vitest.setup.ts # Global mocks │ └── setup.tsx # Render helper ``` | Test Type | Use For | Location | |-----------|---------|----------| | **Unit** | Utilities, components, stores, server actions | `__tests__/` | | **E2E** | User flows, auth, organization workflows | `e2e/` |

Unit tests: Fast, isolated, mock dependencies E2E tests: Real browser, real database, full user journeys

Global mocks available in `test/vitest.setup.ts`:

@/lib/prisma - Database mock
@/lib/auth-client - Auth client mock
@/lib/auth/auth-user - getUser, getRequiredUser
@/lib/organizations/get-org - getCurrentOrg, getRequiredCurrentOrg
sonner - Toast notifications
next/navigation - Router mocks

Use createTestSearchParams() for URL params testing.

For detailed patterns and complete examples:

references/unit-tests.md - Complete unit testing patterns with Vitest
references/integration-tests.md - E2E testing patterns with Playwright

- Tests are in correct directory (`__tests__/` or `e2e/`) - Use `setup()` helper for component tests - Mock external dependencies properly - E2E tests use `createTestAccount()` for auth - Tests pass with `pnpm test:ci` or `pnpm test:e2e:ci` - Test data cleaned up (e2e uses global teardown)