Architecture

Technical architecture documentation for developers and contributors. For user-facing guides, see the User Guide.

Platforms

• Platform Architecture - Web app, CLI, and Apple app platform docs
• Web App Platform - SvelteKit product surface and docs generation
• CLI Platform - Terminal client and SDK surface
• Apple Platform - Native Apple app and web-parity model

Core Systems

• Servers - Docker Compose infrastructure, container architecture
• Security - Zero-knowledge encryption, Vault key management
• Encryption Architecture - Encrypted storage architecture
• Signup & Authentication - Auth flows, passkeys, 2FA
• Passkeys - WebAuthn/PRF implementation details
• Account Recovery - Account reset and recovery flows
• Account Backup - GDPR data export architecture
• Delete Account - Account deletion flow
• Chat Encryption Implementation - Encryption implementation details

Message Pipeline

• Message Processing - Full request/response pipeline with encryption
• Message Parsing - Client-side TipTap JSON parsing and rendering
• Message Input Field - Input field architecture and embed detection
• Message Previews Grouping - Dynamic embed grouping
• Embeds - First-class embed entity system

AI & Models

• AI Model Selection - Provider configuration and automatic routing
• Thinking Models - Support for reasoning models (Gemini, Claude, o-series)
• Hallucination Mitigation - Reducing AI hallucinations
• Preprocessing Model Comparison - Mistral model benchmarks
• Mates - Specialized AI assistant identities and routing
• Followup Suggestions - Post-processing follow-up generation

Privacy & Security

• Privacy and Security Architecture - Implemented privacy and security docs index
• PII Protection - Client-side PII detection and anonymization
• Prompt Injection - Defense-in-depth against prompt injection
• Sensitive Data Redaction - Redacting PII before LLM processing
• Email Privacy - Client-side email encryption

Data & Sync

• Sync - 3-phase multi-device synchronization system
• Device Sessions - Multi-device session management
• Translations - i18n system and translation workflow

Payments

• Payment Processing - Stripe integration and credit system
• Auto Top-Up - Automatic credit top-up system

Apps Architecture

Technical implementation details for the apps system. For user-facing app guides, see User Guide > Apps.

• App Skills - Skill registration, BaseSkill, app.yml schema
• Function Calling - LLM tool calling integration
• Focus Modes Implementation - Focus mode technical details
• Action Confirmation - User confirmation for destructive actions
• REST API - OpenAI-compatible API endpoints

CLI architecture lives under Platforms, not Apps, because the Apps section is reserved for the OpenMates apps model: apps, skills, focus modes, and memory types.

Frontend

• Web App - SvelteKit application architecture
• Native Apps - Apple-first native app strategy (iPhone, iPad, Mac, Watch)
• Docs Web App - Documentation rendering system
• Daily Inspiration - Curated daily prompts system
• Accessibility - WCAG compliance and a11y patterns

Infrastructure

• Health Checks - Service health monitoring
• Logging - Structured logging and OpenObserve
• Admin Console Log Forwarding - Client log forwarding
• Cronjobs - Scheduled tasks
• Developer Settings - API keys and developer mode
• File Upload Pipeline - Presigned URLs and S3 storage
• Analytics - Privacy-preserving analytics
• Status Page - Service status monitoring
• Luma API - Luma video generation API
• Media Generation - OG images and social media graphics

Contributing

• Contributing Guide - How to contribute to OpenMates