Pre-Commit Workflow

Overview

Before committing any changes, all three checks MUST pass. The same checks run in GitHub Actions CI, so failing locally means failing in CI.

Quick Command

bun run lint:fix && bun run typecheck && bun test

Required Checks

1. Lint (Biome)

Biome handles both linting and formatting:

bun run lint        # Check only — shows errors without fixing
bun run lint:fix    # Auto-fix fixable issues

Configuration is in biome.jsonc at the root.

2. TypeScript Check

Verify type safety across the entire monorepo:

bun run typecheck

3. Tests

Run all tests:

bun test                           # All tests
bun test packages/cex-wallets      # Specific package
bun test --watch                   # Watch mode

CI Workflows

GitHub Actions runs the same three checks automatically on every push and PR. Never merge code that fails any check.

Common Issues

Biome formatting

If lint:fix doesn't fix everything, check for complex cases manually. Single quotes, 100-character line width, 2-space indentation.

TypeScript errors after adding new files

Ensure new packages are included in tsconfig.json references at the root.

Tests failing due to missing mocks

Use as unknown as InterfaceType when casting mock objects to avoid TypeScript complaints while keeping type safety at the mock boundary.