> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoodcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# HoodCloud Documentation

> Fully managed blockchain node infrastructure service

HoodCloud is a fully managed blockchain node infrastructure service. It provisions, monitors, and maintains non-validator blockchain nodes without requiring users to manage infrastructure, software upgrades, or monitoring.

## Architecture

<Columns cols={2}>
  <Card title="Architecture Overview" icon="sitemap" href="/architecture/overview">
    High-level system architecture, technology stack, and security boundaries.
  </Card>

  <Card title="Workflows & Lifecycle" icon="arrows-spin" href="/architecture/workflows">
    Request lifecycle, provisioning flow, and Temporal workflow patterns.
  </Card>

  <Card title="Domain Model" icon="database" href="/architecture/domain-model">
    Core domain objects, state machines, business rules, and database schema.
  </Card>

  <Card title="Health & Incidents" icon="heart-pulse" href="/architecture/health-and-incidents">
    Health evaluation pipeline, incident management, and notification dispatch.
  </Card>

  <Card title="Upgrade Rollout" icon="arrow-up-right-dots" href="/architecture/upgrade-rollout">
    Upgrade rollout system: manifests, strategies, Temporal workflows, and rollback tiers.
  </Card>

  <Card title="Extending HoodCloud" icon="puzzle-piece" href="/architecture/extending">
    Add new chains, providers, wallet types, and notification channels.
  </Card>
</Columns>

## Operations

<Columns cols={2}>
  <Card title="Deployment & Operations" icon="rocket" href="/operations/deployment-and-operations">
    Local development setup, day-to-day operations, and single-server staging.
  </Card>

  <Card title="Production Deployment" icon="server" href="/operations/production-deployment">
    Two-server production deployment for the full HoodCloud stack.
  </Card>

  <Card title="Environment Variables" icon="gear" href="/operations/environment-variables">
    Complete configuration reference for all services.
  </Card>

  <Card title="Vault Integration" icon="lock" href="/operations/vault">
    HashiCorp Vault setup for secrets management.
  </Card>

  <Card title="Clerk Authentication" icon="shield-halved" href="/operations/clerk-setup">
    Configure Clerk as an external authentication provider.
  </Card>

  <Card title="Developer Guide" icon="code" href="/architecture/developer-guide">
    How to read the codebase, debug, and run tests.
  </Card>
</Columns>