Skip to main content

​
Architecture

Choco sits at the centre of the Dev4rno documentation ecosystem, connecting 19 organisations into a unified knowledge base.

​
System Overview

​
Core Components

​
Atlas Docs Engine

The primary documentation site, powered by Mintlify:
  • 17+ tabs covering every Dev4rno product
  • Sequoia theme with indigo branding
  • Contextual integrations — ChatGPT, Claude, Perplexity, MCP, Cursor, VS Code
  • Search — full-text across all tabs

​
Domain Health Monitor

Part of the Casa Devarno family-hub application:
  • Runs health probes (DNS, SSL, HTTP, redirect) against all 36 domains
  • Composite health scoring with weighted metrics
  • Alert evaluation and persistence
  • Cron-scheduled via /api/cron/domain-health

​
CI/CD Integration

Choco documentation deploys through GitHub Actions:
  1. PRs trigger preview builds
  2. Merge to main triggers production deploy
  3. API docs auto-regenerate from source repos
  4. Cross-references validate on build

​
Data Flow

1
Content authored
2
Documentation is written as .mdx files in the Atlas repository, organised by product tab.
3
Build triggered
4
GitHub Actions or local pnpm build runs Mintlify’s build pipeline.
5
Validation
6
Cross-references, broken links, and frontmatter are validated at build time.
7
Deploy
8
Production builds deploy to Mintlify’s CDN, served at atlas.devarno.cloud.
9
Monitor
10
Domain health checks verify that all documentation domains resolve correctly and certificates are valid.

​
Integration Points

SystemIntegrationProtocol
GitHubContent source, CI/CDGitHub App + Webhooks
MintlifyBuild, hosting, searchREST API
PlausiblePage analyticsJS snippet
Family HubDomain monitoringInternal cron
BetterAuthAdmin accessOIDC

​
Security

  • All documentation is public (no auth required for reading)
  • Admin operations (editing, deploys) require admin role via BetterAuth
  • Domain monitoring data is accessible to admin and member roles
  • No secrets in documentation content — all API keys reference environment variables