FOUNDRY

Describe it. Code it. Engineer it. Build it. Sell it.

FOUNDRY is a collaborative, AI-native workspace for taking a physical-product idea from an early brief to engineering artifacts, verification, launch media, a storefront, and commerce configuration.

Live application: https://foundry-web-3wiy.onrender.com/

Each project follows four connected stages:

1. Ideate — shape the product brief and requirements with an AI copilot.
2. Engineer — develop the assembly, mechanical CAD, schematic, PCB, code, repository files, and supporting design documents.
3. Verify — review validation checks, evidence, waivers, approvals, and release readiness.
4. Launch — prepare marketing media, generate and edit a storefront, and configure a Shopify-backed product listing and checkout.

The application also includes workspace membership, project folders, shared project navigation, account profiles, invitations, capability-based access, audit events, project chat, replies and reactions, background AI jobs, and multiplayer code editing.

• Project-aware copilot with streaming responses and tool execution
• Persistent chat runs, background processing, cancellation, recovery, and heartbeat handling
• Authored messages, reply threads, reactions, and message actions
• AI-assisted brief, requirements, engineering, and launch workflows

• Assembly and part-oriented product workspace
• KCL mechanical CAD with Zoo/KittyCAD generation and viewport integration
• CAD preview assembly, entity labels, hover selection, and rendered previews
• Schematic and PCB workspaces with circuit rendering
• Monaco code editor, repository file workspace, autosave, and project files
• Yjs/Hocuspocus multiplayer code collaboration with a single-player fallback

• Validation checks, status tracking, evidence, and waivers
• Approval gates and release records
• Capability checks and audit events for protected mutations

• Product image and video asset library
• Asynchronous media generation jobs and provider adapters
• Separate marketing approval and engineering-verification states
• v0-powered storefront creation, preview, iterative editing, and deployment
• Site media attachments and launch context
• Shopify Storefront integration, listings, seller identity, and hosted checkout

• Supabase or local authentication through AuthPort
• Supabase object storage through ObjectStoragePort
• Workspace, project, branch, folder, invitation, and membership management
• Capability-based permissions and structured audit logging
• Supabase presence and Hocuspocus collaboration services
• Render deployment blueprint for web, worker, and collaboration services

FOUNDRY is a pnpm/Turborepo TypeScript monorepo:

• Web application: Next.js App Router, React, tRPC, Tailwind CSS
• Database: PostgreSQL with Prisma
• Authentication and storage: Supabase behind typed ports
• Background work: BullMQ and Redis
• Realtime collaboration: Supabase Realtime plus Yjs/Hocuspocus
• Mechanical CAD: Zoo/KittyCAD and KCL
• AI: OpenAI-backed copilot and media generation
• Storefronts: v0 Platform API
• Commerce: Shopify Storefront API
• Validation: Zod, ESLint, Prettier, Vitest, and Playwright

External services are isolated behind package-level ports. Local or demo fallbacks remain explicitly labeled LOCAL, SIMULATED, or UNVERIFIED; their output must not be presented as verified production data.

• Node.js 22
• pnpm 9
• PostgreSQL, either through the local Docker service or a hosted Supabase project
• Redis for background chat and media jobs
• uv/uvx when using the Zoo MCP assembly tools

pnpm install

# Optional local PostgreSQL
docker compose -f infra/local/docker-compose.yml up -d

cp .env.example .env
# Configure the services needed for your environment.

pnpm db:generate
pnpm db:push
pnpm db:seed
pnpm dev

The local web application runs at http://localhost:3000. The seed creates:

• builder@foundry.local
• reviewer@foundry.local
• Password: demo-password

See .env.example for the full configuration and docs/runbooks/local-setup.md for additional setup guidance.

Open the repository root—not only apps/web—so VS Code can resolve every workspace package:

code .

In the integrated terminal, select Node.js 22 and pnpm 9, then run the same repository-level setup:

corepack enable
corepack prepare pnpm@9.15.4 --activate
pnpm install
cp .env.example .env
pnpm db:generate
pnpm db:push
pnpm db:seed
pnpm dev

Keep credentials in the ignored .env file rather than VS Code settings or source files. If Explorer appears empty or workspace imports cannot resolve, use File → Open Folder… and select the directory containing this README.md, package.json, and pnpm-workspace.yaml.

Shopify credentials are configured per site rather than as shared environment variables because each workspace may sell through a different store.

• apps/web — product UI, API routes, tRPC routers, render surfaces, and workers
• apps/realtime — Hocuspocus collaboration server
• packages/domain — entities, capabilities, states, and domain contracts
• packages/db — Prisma schema, database client, and seed
• packages/auth — authentication port and adapters
• packages/storage — object-storage port and Supabase adapter
• packages/realtime — presence port and adapters
• packages/collaboration — Yjs document and persistence helpers
• packages/cad — CAD port and Zoo/KittyCAD adapters
• packages/media — image/video generation port and adapters
• packages/sites — storefront builder port and v0 adapter
• packages/commerce — commerce port and Shopify adapter
• packages/config — validated environment configuration
• packages/ui — shared interface primitives
• packages/observability — logging and audit helpers
• infra/local — local infrastructure
• docs — architecture notes and operational runbooks

For the broader product background, see Foundry_PRD_Cursor.md and docs/proposal.md. Contributor and coding-agent rules live in AGENTS.md.