Skip to main content

Developer Guide

This section is for developers who are evaluating Routa more deeply, configuring it beyond the first-run path, or running it in their own environment.

Start Here​

Configuration Set up providers, models, and environment variables so Routa can actually run useful work. Administration Use self-hosting, deployment, and release-oriented docs when you are operating Routa for a team or internal environment. Project Structure Learn how the desktop app, CLI, web runtime, and server pieces fit together. Architecture Read the canonical system boundaries, runtime topology, and dual-backend invariants. Testing Understand the validation flow and fitness tiers when changing or running Routa yourself. Local Overlay Sync Keep a self-hosted Routa checkout upgradeable when you also carry local-only patches and upstream PR branches. Deployment Use this when you are taking the web surface or supporting services into a real environment.

What This Section Is For​

Use this section when you need more than the normal end-user path:

  • configuring providers and deployment environments
  • understanding how the product surfaces fit together technically
  • running Routa in a team or self-hosted environment
  • extending Routa after the user-facing path is already clear
  1. Read Configuration to get one provider and one working model path.
  2. Read Administration if you are operating Routa for a team or internal environment.
  3. Read Project Structure and Architecture for deeper technical context.
  4. Read Testing and Deployment when you need validation or rollout guidance.
  5. Read Local Overlay And Upstream Sync if you run Routa locally with long-lived local patches and still need clean upstream updates.

Maintainer-Only Material​

Most readers do not need these on day one: