Skip to main content
We welcome contributions to cascadeflow. This guide covers development setup for both Python and TypeScript.

Monorepo Structure

Python Development

Setup

Code Style

  • Formatter: Black (line length 100)
  • Linter: Ruff
  • Type checker: mypy
  • Import sorting: isort

Testing

TypeScript Development

Setup

Code Style

  • Linter: ESLint
  • Language: TypeScript (strict mode)
  • Indentation: 2 spaces

Making Changes

  1. Create a branch from main
  2. Make changes with clear, descriptive commits
  3. Follow commit conventions: feat:, fix:, docs:, test:, refactor:, chore:
  4. Add tests for new functionality
  5. Ensure all tests pass

Pull Requests

  • All PRs require review approval
  • Linear history enforced (no merge commits)
  • CI must pass before merge