Repository Map
Repositories
Repository Details
| Repository | Owner | Purpose | Stack | Branch Strategy | Deploy Target |
|---|---|---|---|---|---|
equa-web | EQUAStart | Frontend SPA | React 16, TypeScript 3.7, Webpack 4, Redux 4 | Feature branches → staging → main | Railway (nixpacks) |
equa-server | EQUAStart | Backend API | Express 4, TypeORM, PostgreSQL, Node 18 | Feature branches → staging → main | Google Cloud Run |
equa-patternlib-nextjs | EQUAStart | Design system + Storybook | React 18, Next.js 14, Storybook 8.4 | staging → main | Railway (Storybook static) |
equabot | EQUAStart | AI gateway CLI + source | TypeScript (ESM), Bun | Feature branches → main | npm publish / macOS app |
equabot-gateway | equabot | Gateway development | TypeScript, Lit Web Components | Feature branches → main | Bundled in equabot |
Comet-Bridge | Balancing-Rock | Persistent browser automation (Comet/Perplexity) | Node.js (ESM), MCP server, Playwright | main | npm (comet-mcp) / local tooling |
command-center-so | Balancing-Rock | Ops dashboard | Next.js 16, React 19, Tailwind 4 | Feature branches → main | (local dev only) |
stacks-ranking-priorities | Balancing-Rock | Task/priority tracking (includes auto-add flowchart and project-sync architecture docs) | Python scripts, JSON data | main | GitHub Actions |
equa-desktop-app-mac-ios | — | Desktop/mobile app | Planned: SwiftUI | — | — (empty) |
equa-docs | — | Platform documentation | Mintlify | main | docs.equa.cc |
What Lives Where
equa-web (Frontend)
| Path | Contents |
|---|---|
src/modules/ | 24 feature modules (auth, captable, esop, etc.) |
src/shared/components/ | Pattern library re-exports |
src/shared/helpers/ | Utility functions, validators, constants |
src/service/ | HTTP client and API service layer |
src/logic/ | Redux store, reducers, types |
src/styles/ | Styled Components theme, global styles |
src/app/ | App shell, routing, error boundary |
e2e/ | Playwright E2E tests |
lab/ | Production entry point |
equa-server (Backend)
| Path | Contents |
|---|---|
modules/api/ | Express server, endpoint registration, route definitions |
modules/auth/ | Authentication (password, OAuth, magic links), sessions, RBAC |
modules/persistence/ | TypeORM entities (92), database connection, schema |
modules/captable/ | Cap table business logic |
modules/organizations/ | Organization management |
modules/billing/ | Chargify billing integration |
modules/notifications/ | Email delivery (SES/SMTP) |
modules/file-storage/ | AWS S3 file operations |
modules/doc-gen/ | PDF certificate generation |
modules/data-room/ | Data room access control |
modules/google-drive/ | Google Drive sync |
modules/microsoft/ | Microsoft Graph integration |
modules/agent/ | Equanaut AI assistant |
modules/referral/ | Referral system |
modules/activity/ | Activity/event logging |
modules/admin/ | Admin-only operations |
modules/common/ | Shared types and utilities |
modules/raven/ | Raven blockchain integration |
docs/ | Cascading permission diagram |
Comet-Bridge (Browser Automation + MCP Servers)
| Path | Contents |
|---|---|
scripts/ | Core CLI commands (browse, search, scrape, interact, auto, etc.) |
scripts/cursor-comet.mjs | Unified comet wrapper with startup gating |
scripts/comet-bootstrap.mjs | Readiness checks (app, CDP, MCP, extension) |
scripts/tab-safety.mjs | Tab ownership and multi-agent isolation |
scripts/lifecycle-metadata.mjs | Lifecycle envelope creation and transition helpers |
scripts/lifecycle-mcp-adapter.mjs | MCP-to-lifecycle bridge for tool calls |
comet-mcp/ | MCP server for Cursor/Claude browser integration (16 tools) |
comet-mcp/extension/ | Chrome extension for tab group management |
gdrive-mcp/ | MCP server for Google Drive file operations (6 tools: list, search, info, mkdir, upload, download) |
docs/ | Setup, config schema, tab ownership protocol |
command-center-so (Ops Dashboard)
| Path | Contents |
|---|---|
src/app/ | Next.js app router pages |
src/app/api/comet/lifecycle/ | HTTP endpoint for cross-repo Comet run lifecycle sync |
src/components/ | React components (chat, settings, monitors) |
src/lib/ | Utility libraries, gateway client |
src/lib/taskThreads.ts | CometRun lifecycle adapter (start/update/complete/abort/fail), atomic file persistence |
src/data/comet-runs/ | Ephemeral per-run lifecycle state (gitignored) |
.specify/specs/ | Feature specifications (one directory per spec: {id}-{slug}/) |
.specify/specs/{id}-{slug}/diagrams/ | Mermaid .mmd visual diagrams (conditional) |
.specify/templates/ | Spec-kit artifact templates (spec, plan, tasks, checklist) |
.specify/memory/ | Project constitution and persistent context |
.specify/queue/ | Portfolio queue items and session briefs |
e2e/ | Playwright E2E tests |
Local Development Ports
See Environments and Config for the complete port map.| Port | Service |
|---|---|
| 3000 | equa-server |
| 3001 | command-center-so |
| 3333 | equa-patternlib (Next.js) |
| 3333 | equa-docs (Mintlify) |
| 5432 | PostgreSQL |
| 6006 | Storybook |
| 8080 | equa-web |
| 9222 | Comet-Bridge CDP (Comet browser) |
| 18789 | equabot Gateway |
| 18791 | equabot Browser Control |
| 19792 | Equanaut API |