CFX B2B Services

Getting Started

You need Homebrew and Node 26, the version in .nvmrc, from whichever version manager you use. Then run this once per machine, in your own terminal, since linking Podman's Docker socket (podman-mac-helper) asks for a sudo password:

sh scripts/setup.sh
Copy

It installs the CLI tools in the Brewfile (bun, rg, aws, pulumi, dbmate, Podman and the rest), creates the podman machine VM that local containers run in, runs bun install, removes any packages/<pkg>/node_modules left from an older install, and copies the shared AWS SSO profiles in scripts/aws/config to ~/.aws/config if you have none; one aws sso login --sso-session cfx then signs in every profile. It ends with a doctor that lists anything still missing; bun run setup:check runs the doctor alone, and bun run setup:prune-stale removes only the stale packages/<pkg>/node_modules, without brew. Local environment overrides live in each package's committed local.env, layered over dev's SSM secrets; -c dev / -c prod targets read SSM instead.

Re-running is safe: installed tools stay at their current version and an existing AWS config is never overwritten. docs/AGENT_SETUP.md covers setting up a coding agent.

Workspace-Wide Targets

Typecheck

nx run-many -t typecheck
Copy

Build All Non Next.js Projects

nx run-many -t build --exclude=tag:nextjs
Copy

Format

bun fmt
Copy

Lint

Checking:

nx run-many -t lint
Copy

Fixing:

nx run-many -t lint -c fix
Copy