iPix

iPix is an AI-native operating system for fashion brands and production teams. This repository contains the Next.js operator application, CopilotKit/Mastra AI runtime, Supabase-backed domain workflows, and Cloudinary media integration.

Start here

Need	Source
Documentation home	docs/README.md
Product requirements	docs/prd.md
Routes and phases	docs/sitemap.md
Architecture decisions	docs/adr/README.md
Durable roadmap	docs/roadmap.md
Live execution status, blockers, sequencing	Linear v2-ipix
Documentation map	docs/docs-index.md

Repository: https://github.com/amoai-tech/ipixai

Development

npm ci
npm run dev:ui      # Next.js UI on :3000
npm run dev:agent   # Mastra on :4111, only when needed

Run the UI and agent in separate terminals. The combined npm run dev command is intentionally disabled while the watcher-stability issue remains open.

Useful verification commands:

npm run docs:check
npm run typecheck
npm test

Before running the production build, stop both development servers so ports 3000 and 4111 are free, then run:

npm run build

Architecture boundaries

• Supabase/Postgres owns durable application truth and tenant-protected domain state.
• Mastra owns agents, tools, workflows, memory orchestration, and resumable AI execution.
• CopilotKit / AG-UI owns the interactive AI experience.
• Cloudinary owns image/video bytes, transformations, and delivery.
• Consequential writes follow: AI proposes → human reviews → approved action executes → system records the result.

For runtime details, setup contracts, and domain-specific guidance, use docs/README.md. Do not duplicate live task status in this README; Linear owns current execution state.