feros
Contributing

Development Workflow

Recommended contribution workflow for the feros monorepo.

Development Workflow

Baseline Expectations

  • Run lint/tests for changed services before opening a PR.
  • Keep changes scoped and reviewable.
  • Update tests when behavior changes.

Useful Root Targets

make lint
make test
make format

Service-Specific Loops

  • API: make api-serve, make lint-api, make test-api
  • Voice server: cd voice/server && cargo test
  • Voice engine: cd voice/engine && cargo test
  • Studio web: cd studio/web && pnpm lint

Docker Image Publishing

  • Multi-arch Docker image publishing runs on GitHub release publish.
  • Maintainers can also run the Docker workflow manually (workflow_dispatch).
  • Manual dispatch supports selecting a single image (studio-api, voice-server, or studio-web) instead of building all images.

On this page