0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/mastracode
History 2026-11-12 21:12:29 +00:00
..
factory chore: version - exit prerelease mode 2026-11-12 21:12:29 +00:00
factory-ui feat(factory-ui): one-page onboarding that explains every dead end (#30173) 2026-11-12 11:20:50 -08:00
mastra-factory chore: version - exit prerelease mode 2026-11-12 21:12:29 +00:00
sdk chore: version - exit prerelease mode 2026-11-12 21:12:29 +00:00
tui chore: version - exit prerelease mode 2026-11-12 21:12:29 +00:00
web chore(deps): Vanta 2026-11-12 — raise undici to 8.12.4 / 7.30.2 (#30205) 2026-11-12 07:20:12 -08:00
.gitignore test: add 70 Mastra Code e2e scenarios + in-process runner (#18102) 2026-06-18 01:46:00 +02:00
AGENTS.md docs(factory): document focused test commands for mastracode/factory (#29866) 2026-11-10 04:50:02 +00:00
README.md chore(mastracode): make one command bring the whole dev stack up (#21159) 2026-08-11 07:41:11 -07:00

MastraCode contributor guide

Use this guide to find the right package and run Factory locally.

Packages

Package Responsibility
factory Factory backend: storage, routes, rules, and integrations
factory-ui Factory React application and browser tests
web Local and deployable Factory host
sdk Shared coding-agent runtime
tui Terminal interface
mastra-factory create-factory scaffolder

Setup

From the repository root:

pnpm install
pnpm --dir mastracode/web install
pnpm --dir mastracode/web run prebuild

The web host is a separate pnpm project. prebuild builds the local packages it links to.

Run Factory

First complete the local GitHub App setup.

For backend work, run the API and bundled UI together:

pnpm --dir mastracode/web dev

Open http://localhost:5873.

For UI work with hot module replacement, run the Docker services, the API, and the Vite dev server together:

pnpm --dir mastracode/web dev:ui

Open http://localhost:5173. To run them in separate terminals instead, start the Docker services with pnpm --dir mastracode/web db:up, then run pnpm --dir mastracode/web api and pnpm --filter ./mastracode/factory-ui dev.