test-guide

Test Guide

Overview

Testing stack:

• Web: Vitest (unit/integration)
• API: pytest + pytest-asyncio
• Worker: pytest + pytest-asyncio
• Mobile: flutter_test

Quick Commands

Run All Tests

# All tests
mise test

# Or individually
mise //apps/api:test
mise //apps/web:test
mise //apps/worker:test
mise //apps/mobile:test

Watch Mode

# Web
cd apps/web && bun test:watch

# API (use pytest-watch)
cd apps/api && uv run ptw

Coverage

# Web
cd apps/web && bun test:coverage

# API
cd apps/api && uv run poe test:cov

# Flutter
cd apps/mobile && flutter test --coverage

Web Testing (Vitest)

Configuration

See apps/web/vitest.config.mts.

File Patterns

• Unit tests: **/*.test.{ts,tsx}
• Integration tests: **/*.spec.{ts,tsx}

Example Unit Test

// src/lib/utils.test.ts
import { describe, it, expect } from 'vitest';
import { cn } from './utils';

describe('cn', () => {
  it('should merge class names', () => {
    expect(cn('foo', 'bar')).toBe('foo bar');
  });

  it('should handle conditional classes', () => {
    expect(cn('foo', false && 'bar', 'baz')).toBe('foo baz');
  });
});

Example Component Test

// src/components/button.test.tsx
import { describe, it, expect } from 'vitest';
import { render, screen } from '@testing-library/react';
import { Button } from './button';

describe('Button', () => {
  it('should render children', () => {
    render(<Button>Click me</Button>);
    expect(screen.getByRole('button')).toHaveTextContent('Click me');
  });
});

Mocking

import { vi } from 'vitest';

// Mock module
vi.mock('@/lib/api-client', () => ({
  apiClient: {
    get: vi.fn(),
    post: vi.fn(),
  },
}));

// Mock function
const mockFn = vi.fn().mockResolvedValue({ data: 'test' });

API Testing (pytest)

Configuration

See apps/api/pyproject.toml [tool.pytest.ini_options].