Skip to content
Beef Docs

Flank

Flank

Responsibility

Flank is the TanStack Start visual workflow builder for media-generation workflows. It models workflows, adapters, secrets, and executions as configuration rather than provider-specific TypeScript branches.

Runtime

Flank runs on TanStack Start/Vinxi with ReactFlow in the UI. It uses Connect-es gRPC clients to sirloin and serves FlankExecutionService over gRPC from server/grpc-server.ts.

Primary Source Paths

  • apps/flank/app/routes/
  • apps/flank/app/components/flow/
  • apps/flank/app/lib/
  • apps/flank/server/engine/
  • apps/flank/server/grpc-server.ts
  • apps/flank/seeds/

Contracts And Generated References

  • FlankStorageService is implemented by sirloin from proto/sirloin/v5/flank.proto.
  • FlankExecutionService is implemented by flank from proto/flank/v1/flank.proto.
  • Workflows, adapters, secrets, and executions are stored through sirloin FlankStorageService.
  • FlankMCP lives under apps/sirloin/internal/app/flankmcp/.

Workflow-builder decisions live under docs/src/content/docs/decisions/ as they are migrated.

Operations

Seed files under apps/flank/seeds/ define adapters and workflows and should validate before deployment.

Local Commands

  • cd apps/flank && pnpm typecheck
  • cd apps/flank && pnpm lint
  • cd apps/flank && pnpm test
  • cd apps/flank && pnpm validate:seeds