Repository Guide

Last Verified: 2026-05-03

The Equa platform is split across several repositories, each handling a distinct concern. This guide explains what each repo does, its tech stack, and how they connect at runtime.

Repository Overview

Repository	GitHub	Purpose	Stack	Package Mgr	Dev Port
equa-web	`EQUAStart/equa-web`	Frontend application	React 16, Webpack 4, TypeScript 3.7	Yarn	8080
equa-server	`EQUAStart/equa-server`	Backend API	Express 4.16, TypeORM 0.2.24, PostgreSQL	Yarn (workspaces)	3000
equabot	`EQUAStart/equabot`	AI agent gateway	Node.js, TypeScript (ESM), multi-channel	pnpm 10	18789
equa-patternlib-nextjs	`EQUAStart/equa-patternlib-nextjs`	Design system / component library	Next.js 14, Storybook 8.4, React 18	npm	3333 / 6006
command-center-so	`EQUAStart/equanaut-command-center-main`	Full-screen Equanaut Command Center	Next.js 16, Tailwind CSS 4, React 19	npm	3001 (`/command-center`)
equa-desktop-app-mac-ios	—	Desktop and mobile apps (planned)	TBD	TBD	—

How Repos Connect at Runtime

Key connections:

equa-web proxies all /api/* requests to equa-server via webpack-dev-server (configured in webpack config, default target http://localhost:3000)
equa-web imports equa-patternlib as an npm dependency from GitHub: "equa-patternlib": "github:EQUAStart/equa-patternlib-nextjs#master" (Source: equa-web/package.json line 24)
equabot-gateway communicates with equa-server and external AI/messaging services via WebSocket and REST
Storybook runs independently as a visual component playground

Per-Repository Details

equa-web

Frontend single-page application for the Equa equity management platform.

equa-web/
├── src/
│   ├── modules/          # 24 feature modules
│   ├── shared/           # Shared components, helpers, styles
│   ├── app/              # App-level components and routing
│   ├── logic/            # Business logic and Redux (legacy)
│   ├── service/          # API service layer
│   ├── assets/           # Images, fonts
│   └── styles/           # Global styles and themes
├── lab/                  # Entry points (main-prod.ts)
├── e2e/                  # Playwright E2E tests
├── config/               # Webpack and app configuration
└── tslint.json           # TSLint config (deprecated)

Feature modules (24 under src/modules/): actions, admin, agreements, auth, captable, convertibles, documents, equanaut, esop, google-drive, guest, hh-finance, landing, organization, organization-dashboard, payments, profile, referrals, reports, roles, subscriptions, team-members, user-dashboard, welcome Source: equa-web/src/modules/ directory listing Path aliases (from equa-web/tsconfig.json):

Alias	Maps To
`@src/*`	`src/*`
`@modules/*`	`src/modules/*`
`@shared/*`	`src/shared/*`
`@components/*`	`src/shared/components/*`
`@helpers/*`	`src/shared/helpers/*`
`@styles/*`	`src/shared/styles/*`
`@image/*`	`src/assets/image/*`
`@config/*`	`config/*`
`@logic`	`src/logic/`

equa-server

Backend API server using a workspace-based modular monolith architecture.

equa-server/
├── modules/              # 20 workspace packages
│   ├── api/              # Main API entry point, endpoints, handlers
│   ├── auth/             # Authentication and authorization
│   ├── persistence/      # Database schema and queries (TypeORM)
│   ├── captable/         # Cap table business logic
│   ├── organizations/    # Organization management
│   ├── billing/          # Chargify integration
│   ├── file-storage/     # S3/GCS file management
│   ├── notifications/    # Email sending (SES, SMTP, Mandrill)
│   ├── agent/            # AI assistant (Equanaut) with Claude
│   ├── doc-gen/          # Document generation
│   ├── data-room/        # Data room functionality
│   ├── google-drive/     # Google Drive integration
│   ├── microsoft/        # Microsoft auth and files
│   ├── activity/         # Activity tracking
│   ├── admin/            # Admin functionality
│   ├── referral/         # Referral system
│   ├── common/           # Shared utilities, logging (Winston)
│   ├── api-helper/       # HTTP handler utilities
│   ├── raven/            # Raven addresses
│   └── wallet/           # Wallet functionality
├── docker-compose.yml    # PostgreSQL container for development
├── Dockerfile            # Production multi-stage build
├── ecosystem.config.js   # PM2 production config
└── cloudbuild.yaml       # Legacy Google Cloud Build / Cloud Run deployment path

Source: equa-server/modules/ directory listing; equa-server/package.json workspaces config

equabot (equabot-gateway)

AI agent infrastructure supporting multi-channel messaging, browser automation, and tool execution.

equabot/
├── src/                  # Core TypeScript source (ESM)
│   ├── agents/           # Agent framework and tools
│   ├── browser/          # Browser automation
│   ├── gateway/          # Gateway server and protocol
│   ├── cli/              # CLI wiring
│   └── commands/         # CLI commands
├── ui/                   # Lit-based web UI components
├── extensions/           # Channel plugins (Google Chat, etc.)
├── skills/               # Agent skill definitions
├── apps/                 # Native applications
│   ├── ios/              # iOS app
│   ├── android/          # Android app
│   └── macos/            # macOS menubar app
├── docs/                 # Documentation (11ty-based)
└── scripts/              # Build and utility scripts

Runtime: Node 22+ required (engines.node: ">=22.12.0" in package.json). Uses pnpm as package manager. Source: equabot-gateway/package.json

equa-patternlib-nextjs

Shared React component library and design system with Storybook for visual documentation.

equa-patternlib-nextjs/
├── src/
│   ├── components/       # React components
│   ├── tokens/           # Design tokens
│   └── index.ts          # Package exports
├── stories/              # Storybook stories
├── .storybook/           # Storybook configuration
└── vitest.config.js      # Test config (jsdom)

Consumed by equa-web as a GitHub dependency. Storybook runs on port 6006, Next.js dev server on port 3333. Source: equa-patternlib-nextjs/package.json

command-center-so

Internal operations dashboard for monitoring and managing the Equa platform and equabot infrastructure.

command-center-so/
├── src/
│   ├── app/              # Next.js App Router pages and API routes
│   ├── components/       # React components
│   └── lib/              # Shared utilities
├── e2e/                  # Playwright tests
├── test/                 # Unit tests
└── .specify/
    ├── specs/            # Feature specs ({id}-{slug}/ per spec)
    ├── templates/        # Artifact templates
    ├── memory/           # Constitution, persistent context
    └── queue/            # Portfolio queue, session briefs

Uses Next.js 16 with App Router, Tailwind CSS 4, and React 19. See Spequa Workflow for full details on the spec directory and pipeline. Source: command-center-so/package.json

equa-desktop-app-mac-ios

Planned repository for native desktop (macOS) and mobile (iOS) apps. Currently empty and not initialized — no source code, no package.json, no project files.

Inter-Repository Dependencies

Dependency	From	To	Mechanism
Component library	equa-web	equa-patternlib-nextjs	npm dependency from GitHub (`github:EQUAStart/equa-patternlib-nextjs#master`)
API proxy	equa-web (dev)	equa-server	webpack-dev-server proxy (`/api/*` -> `localhost:3000`)
AI integration	equa-server	equabot-gateway	WebSocket and REST calls
Database	equa-server	PostgreSQL	TypeORM connection via `docker-compose.yml`

Branching Conventions

Branching patterns vary across repositories. There is no single enforced standard.

Repository	Primary Branch	Observed Patterns	Protected Branches
equa-web	`main`	`feat/`, `fix/`, `docs/`, `chore/`, `ci/*`, `phase-`	`main`
equa-server	`staging`	`staging`, legacy `prod-deploy` CI trigger	`main`, `staging`
equabot-gateway	`main`	`fix/`, `feat/`, `issue-*`	`main`
equa-patternlib-nextjs	`master`	`staging`, `master`	`master`
command-center-so	`main`	`issue-`, `fix/`	`main`

Source: git status and GitHub Actions workflow trigger configurations across repos See PR and Commit Workflow for more detail on commit conventions and merge strategies.

Platform Architecture

Compliance & Security

Feature Specifications

Releases

Developer Onboarding

Business

Reference & Templates

Repository Guide

Repository Guide

Repository Overview

How Repos Connect at Runtime

Per-Repository Details

equa-web

equa-server

equabot (equabot-gateway)

equa-patternlib-nextjs

command-center-so

equa-desktop-app-mac-ios

Inter-Repository Dependencies

Branching Conventions

​Repository Guide

​Repository Overview

​How Repos Connect at Runtime

​Per-Repository Details

​equa-web

​equa-server

​equabot (equabot-gateway)

​equa-patternlib-nextjs

​command-center-so

​equa-desktop-app-mac-ios

​Inter-Repository Dependencies

​Branching Conventions

Repository Guide

Repository Overview

How Repos Connect at Runtime

Per-Repository Details

equa-web

equa-server

equabot (equabot-gateway)

equa-patternlib-nextjs

command-center-so

equa-desktop-app-mac-ios

Inter-Repository Dependencies

Branching Conventions