AICodeRally|Documentation

Platform Overview

AICodeRally is a comprehensive AI-native platform with a sophisticated module-first architecture.

See Also: Unified System Architecture - Complete AICodeRally ecosystem including Rally Stack, Rally AI, Agent Protocol, and Franchise System

Architecture

Monorepo Structure

The platform uses Turborepo + pnpm workspaces for efficient monorepo management:

aicoderally-stack/
├── apps/              # Customer-facing applications
│   ├── studio/       # Entry-level workshop platform
│   ├── edge/         # SMB AI transformation
│   ├── summit/       # Enterprise platform
│   ├── website/      # Public marketing site
│   └── docs/         # This documentation site
├── packages/         # Shared code
│   ├── core/         # Type definitions and contracts
│   ├── modules/      # 86 reusable modules
│   ├── connectors/   # Integration adapters
│   └── ui/           # Shared UI components
├── prisma/           # Database schema
└── tools/            # Automation & helpers

Tech Stack

Frontend:

Backend:

Infrastructure:

Architecture 3.0: Four-Layer System

AICodeRally uses a 4-layer architecture that provides clear separation of concerns and enables powerful reuse:

Layer 1: Modules (Capability Library)

Location: packages/modules/* Purpose: Shared capability library (internal only)

Key Points:

Examples:

Layer 2: Ideation Studio (One Idea → One App)

Location: apps/studio URL: studio.aicoderally.com Tagline: One Idea → One App

Purpose: Turn a single idea into a working app (web, mobile, or website)

Focus:

Examples:

What it's NOT:

Layer 3: Edge Portal (Business Operations)

Location: apps/edge URL: edge.aicoderally.com Tagline: Run the Business Around Your Ideas

Purpose: Add business operations layer around apps

Features:

Edge Solutions:

Uses:

Layer 4: Summit Solutions (Enterprise Orchestration)

Location: apps/summit URL: summit.aicoderally.com Tagline: Custom. Cross-App. Cross-Business. Scale.

Purpose: Custom solutions spanning multiple Edge portals and Studio apps

Features:

Summit Solutions:

Target Customers:

The Power of This Architecture

This 4-layer structure provides:

  1. Clear Narrative - Easy for anyone to understand
  2. Technical Sanity - Scalable, maintainable system
  3. Zero Overlap - Each layer has distinct responsibilities
  4. Clean Value Chain - From idea → app → business → enterprise
  5. Module Reuse - Shared capabilities across all layers
  6. Clear Boundaries - For developers and AI agents
  7. Perfect Franchise Story - Sellable at every layer

See the Architecture 3.0 documentation for complete details.

Module System

Module Architecture

Every module exports standardized metadata:

export const module: RallyModule = {
  meta: {
    id: string,              // kebab-case
    name: string,
    description: string,
    version: string,         // semver
    category: string,
    route: string,
    tier: string[],          // studio, edge, summit
    domain?: string[],       // nonprofit, spm, dev, etc.
    connectors?: {
      database?: boolean,
      auth?: boolean,
      storage?: boolean,
      ai?: boolean,
      email?: boolean,
    }
  }
}

Module Categories

86 modules across 10 categories:

  1. Accounting & Finance (5 modules)
  2. Analytics & Intelligence (4 modules)
  3. Content & Marketing (8 modules)
  4. CRM & Sales (8 modules)
  5. Events & Community (3 modules)
  6. Nonprofit/Social Impact (15 modules)
  7. Operations & Logistics (8 modules)
  8. People & HR (8 modules)
  9. Planning & Governance (7 modules)
  10. Tools & Utilities (11 modules)

See the Module Reference for complete details.

Database Architecture

Prisma Schema

Total: 2,675 lines, 100+ tables

Key Areas:

Connection Strategy

Deployment Strategy

Development

Preview

Production

See the Deployment Guide for details.

Security

Authentication

Authorization

Best Practices

Performance

Optimization Strategies

Monitoring

Next Steps