Local Development

Branching

Create feature work on a branch and open a pull request into main. Do not push directly to main.

Useful commands

bun install
bun run format:check
bun run lint
bun run check-types
bun run test

Run app-specific checks while working:

bun --filter marketing lint
bun --filter marketing check-types
bun --filter platform lint
bun --filter platform check-types

Local ports

Generated files

Do not commit generated output:

• .next
• .turbo
• node_modules
• .source
• build output directories

High-risk areas

Add focused tests or manual smoke checks before changing:

• checkout creation and payment secrets,
• Stripe Connect, finance, and payout flows,
• shipping rates and local delivery zones,
• discounts and discount combinations,
• inventory reservations,
• invitations, login, signup, and onboarding redirects.