Repository Guide

What each repository does and how they connect

Repository Guide

Last Verified: February 2026

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	Balancing-Rock/command-center-so	Internal operations dashboard	Next.js 16, Tailwind CSS 4, React 19	npm	3001
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       # Google Cloud Build deployment

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 Spec-Kit Workflow for full details on the .specify/ 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	staging	issue-*, feat/**, develop	main, staging
equa-server	staging	staging, prod-deploy	main, staging
equabot-gateway	main	fix/*, feat/*, issue-*	main
equa-patternlib-nextjs	staging	staging	staging
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.