App Builder

AI-assisted startup development platform. It combines:

• an agent-driven backend orchestration layer
• a React Native starter app template
• a Next.js web portal for project/request operations

Monorepo Layout

• backend/ - Express API, queue workers, agent orchestration, Supabase integration
• app-template/ - Expo React Native starter template
• web-portal/ - Next.js 16 dashboard (next dev -p 3001)
• docs/ - project documentation
• scripts/ - root utility scripts

Architecture Overview

1. Backend receives request/task events and orchestrates agent workflows.
2. Workers + Queue process async jobs and webhook-driven pipelines.
3. Supabase stores project state, requests, tasks, and related metadata.
4. Web Portal manages projects/requests and admin workflows.
5. App Template is the mobile starter product surface.

Quick Start (Local)

Prerequisites

• Node.js 20+
• Docker
• Supabase CLI

1) Install dependencies

npm install
cd backend && npm install
cd ../app-template && npm install
cd ../web-portal && npm install

2) Configure environment files

• Backend: copy backend/env.example to backend/.env
• Web portal: copy web-portal/.env.local.example to web-portal/.env.local
• App template: create app-template/.env using values from app-template/.env.example

Use your own values only. Keep placeholders in committed files.

3) Start backend infrastructure

cd backend
npm run db:start
npm run queue:start

Optional checks:

npm run db:status
npm run queue:status

4) Start backend API

cd backend
npm run dev

Backend runs on http://localhost:3000.

5) Start web portal

cd web-portal
npm run dev

Web portal runs on http://localhost:3001.

6) Start app template

cd app-template
npm start

Workspace Commands

Root

npm run knip
npm run knip:fix
npm run validate-readme-exports

Backend

cd backend
npm run dev
npm run typecheck
npm run lint
npm run db:start
npm run db:reset
npm run db:generate-types

App Template

cd app-template
npm start
npm run ios
npm run typecheck
npm run lint
npm run db:local:start
npm run db:local:types:generate

Web Portal

cd web-portal
npm run dev
npm run build
npm run typecheck
npm run lint
npm run generate-db-types

Documentation Map

• Backend details: backend/README-style docs under backend/**/README.md
• GitHub integration setup: backend/github/README.md
• App template docs: app-template/README.md
• Web portal docs: web-portal/README.md
• Agent conventions and codebase guidance: AGENTS.md

Notes

• This root README is the canonical onboarding entrypoint.
• Keep sensitive values out of docs and examples.