From c48b9cdf4a0b78439b23bafa6fb1c280b264d1f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yuniel=20Acosta=20P=C3=A9rez?=
<33158051+yacosta738@users.noreply.github.com>
Date: Sun, 8 Mar 2026 23:08:57 +0100
Subject: [PATCH 1/4] docs(web): align marketing and docs with Corvus runtime
identity
---
.../content/docs/en/guides/architecture.md | 8 +-
.../docs/en/guides/architecture/overview.md | 10 +-
.../content/docs/en/guides/getting-started.md | 6 +-
.../src/content/docs/en/guides/release.md | 4 +-
.../apps/docs/src/content/docs/en/index.mdx | 22 +-
.../content/docs/es/guides/architecture.md | 8 +-
.../docs/es/guides/architecture/overview.md | 10 +-
.../content/docs/es/guides/getting-started.md | 6 +-
.../src/content/docs/es/guides/release.md | 4 +-
.../apps/docs/src/content/docs/es/index.mdx | 22 +-
.../src/layouts/MarketingLayout.astro | 2 +-
.../web/apps/marketing/src/pages/index.astro | 311 +++++--
.../web/apps/marketing/src/styles/global.css | 865 +++++++++++++-----
13 files changed, 919 insertions(+), 359 deletions(-)
diff --git a/clients/web/apps/docs/src/content/docs/en/guides/architecture.md b/clients/web/apps/docs/src/content/docs/en/guides/architecture.md
index c92a390de..e258d0ba2 100644
--- a/clients/web/apps/docs/src/content/docs/en/guides/architecture.md
+++ b/clients/web/apps/docs/src/content/docs/en/guides/architecture.md
@@ -117,9 +117,9 @@ For a more detailed view of the architecture, see the following C4 diagrams:
| Level | Diagram | Description | Diagram ID |
|-----------------|----------------------------------------------------------------------------|---------------------------------------------------|-----------------------------------|
-| C1 - Context | [System Context](/guides/architecture/diagrams/context/system-context.mmd) | High-level view of the system and external actors | `context/system-context.mmd` |
-| C2 - Containers | [Main Containers](/guides/architecture/diagrams/container/system-containers.mmd) | Applications and services that compose Corvus | `container/system-containers.mmd` |
-| C3 - Components | [Agent Core KMP](/guides/architecture/diagrams/component/agent-core-kmp.mmd) | Internal components of the core module | `component/agent-core-kmp.mmd` |
-| - | [Module Dependencies](/guides/architecture/diagrams/module-dependencies.mmd) | Gradle dependency relationships | `module-dependencies.mmd` |
+| C1 - Context | [System Context](./architecture/diagrams/context/system-context.mmd) | High-level view of the system and external actors | `context/system-context.mmd` |
+| C2 - Containers | [Main Containers](./architecture/diagrams/container/system-containers.mmd) | Applications and services that compose Corvus | `container/system-containers.mmd` |
+| C3 - Components | [Agent Core KMP](./architecture/diagrams/component/agent-core-kmp.mmd) | Internal components of the core module | `component/agent-core-kmp.mmd` |
+| - | [Module Dependencies](./architecture/diagrams/module-dependencies.mmd) | Gradle dependency relationships | `module-dependencies.mmd` |
See [Architecture Index](./overview/) for more details on how to visualize them.
diff --git a/clients/web/apps/docs/src/content/docs/en/guides/architecture/overview.md b/clients/web/apps/docs/src/content/docs/en/guides/architecture/overview.md
index 04671754b..15aab2f7b 100644
--- a/clients/web/apps/docs/src/content/docs/en/guides/architecture/overview.md
+++ b/clients/web/apps/docs/src/content/docs/en/guides/architecture/overview.md
@@ -12,7 +12,7 @@ Context, Container, Component, Code).
Shows the Corvus system as a black box and its interactions with actors and external systems.
-- **File**: [`context/system-context.mmd`](/guides/architecture/diagrams/context/system-context.mmd)
+- **File**: [`context/system-context.mmd`](./diagrams/context/system-context.mmd)
- **Format**: Mermaid
- **Description**: High-level view of the complete system, including users (Developer, End User) and
external systems (LLM Providers, Neo4j, Web Sources).
@@ -22,8 +22,8 @@ Shows the Corvus system as a black box and its interactions with actors and exte
Decomposes the system into main containers/applications and their interactions.
- **Files**:
- - [`container/system-containers.mmd`](/guides/architecture/diagrams/container/system-containers.mmd) (Mermaid)
- - [`container/system-containers.puml`](/guides/architecture/diagrams/container/system-containers.puml) (PlantUML)
+ - [`container/system-containers.mmd`](./diagrams/container/system-containers.mmd) (Mermaid)
+ - [`container/system-containers.puml`](./diagrams/container/system-containers.puml) (PlantUML)
- **Description**: Shows the main containers: Web Dashboard, Android App, iOS App, Agent Runtime,
Rust Sidecar, and Graph DB.
@@ -33,7 +33,7 @@ Decomposes individual containers into their internal components.
### Agent Core KMP
-- **File**: [`component/agent-core-kmp.mmd`](/guides/architecture/diagrams/component/agent-core-kmp.mmd)
+- **File**: [`component/agent-core-kmp.mmd`](./diagrams/component/agent-core-kmp.mmd)
- **Description**: Internal components of the core module: Domain, Use Cases, Interfaces, and
Infrastructure.
@@ -41,7 +41,7 @@ Decomposes individual containers into their internal components.
Additional diagram showing Gradle dependencies between modules.
-- **File**: [`module-dependencies.mmd`](/guides/architecture/diagrams/module-dependencies.mmd)
+- **File**: [`module-dependencies.mmd`](./diagrams/module-dependencies.mmd)
- **Description**: Shows how clients depend on the shared core and external frameworks.
## How to Visualize
diff --git a/clients/web/apps/docs/src/content/docs/en/guides/getting-started.md b/clients/web/apps/docs/src/content/docs/en/guides/getting-started.md
index 46a90b72e..02a743c98 100644
--- a/clients/web/apps/docs/src/content/docs/en/guides/getting-started.md
+++ b/clients/web/apps/docs/src/content/docs/en/guides/getting-started.md
@@ -101,6 +101,6 @@ corvus --help
## Next Steps
-- Review [Project Structure](../structure/).
-- Check [Features Checklist](../features/).
-- Continue with [Development](../development/).
+- Review [Project Structure](./structure/).
+- Check [Features Checklist](./features/).
+- Continue with [Development](./development/).
diff --git a/clients/web/apps/docs/src/content/docs/en/guides/release.md b/clients/web/apps/docs/src/content/docs/en/guides/release.md
index 28b46173f..848658398 100644
--- a/clients/web/apps/docs/src/content/docs/en/guides/release.md
+++ b/clients/web/apps/docs/src/content/docs/en/guides/release.md
@@ -9,7 +9,7 @@ GitHub Actions.
Before you can publish, ensure you have:
-1. **GPG Key configured**: Follow the [GPG Setup Guide](../gpg-setup/) to create and configure your
+1. **GPG Key configured**: Follow the [GPG Setup Guide](./gpg-setup.md) to create and configure your
signing key
2. **Maven Central access**: Repository secrets configured:
@@ -254,6 +254,6 @@ Use this checklist before publishing:
## See Also
-- [GPG Setup Guide](../gpg-setup/)
+- [GPG Setup Guide](./gpg-setup.md)
- [GitHub Workflows](https://github.com/dallay/corvus/blob/main/.github/workflows/README.md)
- [Contributing Guide](https://github.com/dallay/corvus/blob/main/.github/CONTRIBUTING.md)
diff --git a/clients/web/apps/docs/src/content/docs/en/index.mdx b/clients/web/apps/docs/src/content/docs/en/index.mdx
index e80800af7..9291e7697 100644
--- a/clients/web/apps/docs/src/content/docs/en/index.mdx
+++ b/clients/web/apps/docs/src/content/docs/en/index.mdx
@@ -1,9 +1,9 @@
---
title: Corvus
-description: Reactive agent platform for always-on orchestration on the JVM.
+description: Secure, pluggable documentation for the Rust-native runtime for autonomous AI agents.
template: splash
hero:
- tagline: Build long-running, proactive agents with Kotlin, Spring Boot, Neo4j, Rust sidecars, and a transparent control panel.
+ tagline: Build autonomous AI agents with a secure, pluggable Rust-native runtime that stays small, fast, and portable.
actions:
- text: Get Started
link: guides/getting-started/
@@ -21,17 +21,17 @@ import {Card, CardGrid, LinkCard} from '@astrojs/starlight/components';
## Why Corvus?
-
- Kotlin + Spring Boot + Coroutines/WebFlux for non-blocking, always-on workflows.
+
+ A small Rust binary with fast startup and low memory usage, built for laptops, servers, SBCs, and constrained environments.
-
- Knowledge-first architecture using Neo4j for connected context and durable memory.
+
+ Pairing, sandboxing, workspace scoping, allowlists, and encrypted secrets are part of the default posture.
-
- High-performance binaries for scraping and secure sandbox operations.
+
+ Swap providers, memory, tools, channels, tunnels, and runtime modes without rewriting your stack.
-
- Real-time observability through an Astro/Vue control surface and event streaming.
+
+ Run Corvus natively or in Docker with one runtime for chat, gateway, daemon, integrations, and automation.
@@ -45,6 +45,8 @@ import {Card, CardGrid, LinkCard} from '@astrojs/starlight/components';
href="guides/features/"/>
+
diff --git a/clients/web/apps/docs/src/content/docs/es/guides/architecture.md b/clients/web/apps/docs/src/content/docs/es/guides/architecture.md
index 2ae7b41b2..398df9a91 100644
--- a/clients/web/apps/docs/src/content/docs/es/guides/architecture.md
+++ b/clients/web/apps/docs/src/content/docs/es/guides/architecture.md
@@ -118,10 +118,10 @@ Para una vista más detallada de la arquitectura, consulta los siguientes diagra
| Nivel | Diagrama | Descripción | ID del Diagrama |
|-------------------|-------------------------------------------------------------------------------------|----------------------------------------------------|-----------------------------------|
-| C1 - Contexto | [Sistema Completo](/guides/architecture/diagrams/context/system-context.mmd) | Vista de alto nivel del sistema y actores externos | `context/system-context.mmd` |
-| C2 - Contenedores | [Contenedores Principales](/guides/architecture/diagrams/container/system-containers.mmd) | Aplicaciones y servicios que componen Corvus | `container/system-containers.mmd` |
-| C3 - Componentes | [Agent Core KMP](/guides/architecture/diagrams/component/agent-core-kmp.mmd) | Componentes internos del módulo core | `component/agent-core-kmp.mmd` |
-| - | [Dependencias entre Módulos](/guides/architecture/diagrams/module-dependencies.mmd) | Relaciones de dependencia de Gradle | `module-dependencies.mmd` |
+| C1 - Contexto | [Sistema Completo](./architecture/diagrams/context/system-context.mmd) | Vista de alto nivel del sistema y actores externos | `context/system-context.mmd` |
+| C2 - Contenedores | [Contenedores Principales](./architecture/diagrams/container/system-containers.mmd) | Aplicaciones y servicios que componen Corvus | `container/system-containers.mmd` |
+| C3 - Componentes | [Agent Core KMP](./architecture/diagrams/component/agent-core-kmp.mmd) | Componentes internos del módulo core | `component/agent-core-kmp.mmd` |
+| - | [Dependencias entre Módulos](./architecture/diagrams/module-dependencies.mmd) | Relaciones de dependencia de Gradle | `module-dependencies.mmd` |
Ver [Visión General de la Arquitectura](./overview/) para más detalles sobre cómo
visualizarlos.
diff --git a/clients/web/apps/docs/src/content/docs/es/guides/architecture/overview.md b/clients/web/apps/docs/src/content/docs/es/guides/architecture/overview.md
index 5eb54e979..464f5eecd 100644
--- a/clients/web/apps/docs/src/content/docs/es/guides/architecture/overview.md
+++ b/clients/web/apps/docs/src/content/docs/es/guides/architecture/overview.md
@@ -12,7 +12,7 @@ Context, Container, Component, Code).
Muestra el sistema Corvus como una caja negra y sus interacciones con actores y sistemas externos.
-- **Archivo**: [`context/system-context.mmd`](/guides/architecture/diagrams/context/system-context.mmd)
+- **Archivo**: [`context/system-context.mmd`](./diagrams/context/system-context.mmd)
- **Formato**: Mermaid
- **Descripción**: Vista de alto nivel del sistema completo, incluyendo usuarios (Developer, End
User) y sistemas externos (LLM Providers, Neo4j, Fuentes Web).
@@ -22,8 +22,8 @@ Muestra el sistema Corvus como una caja negra y sus interacciones con actores y
Descompone el sistema en contenedores/aplicaciones principales y sus interacciones.
- **Archivos**:
- - [`container/system-containers.mmd`](/guides/architecture/diagrams/container/system-containers.mmd) (Mermaid)
- - [`container/system-containers.puml`](/guides/architecture/diagrams/container/system-containers.puml) (PlantUML)
+ - [`container/system-containers.mmd`](./diagrams/container/system-containers.mmd) (Mermaid)
+ - [`container/system-containers.puml`](./diagrams/container/system-containers.puml) (PlantUML)
- **Descripción**: Muestra los contenedores principales: Web Dashboard, Android App, iOS App, Agent
Runtime, Rust Sidecar, y Graph DB.
@@ -33,7 +33,7 @@ Descompone contenedores individuales en sus componentes internos.
### Agent Core KMP
-- **Archivo**: [`component/agent-core-kmp.mmd`](/guides/architecture/diagrams/component/agent-core-kmp.mmd)
+- **Archivo**: [`component/agent-core-kmp.mmd`](./diagrams/component/agent-core-kmp.mmd)
- **Descripción**: Componentes internos del módulo core: Dominio, Casos de Uso, Interfaces e
Infraestructura.
@@ -41,7 +41,7 @@ Descompone contenedores individuales en sus componentes internos.
Diagrama adicional mostrando las dependencias de Gradle entre módulos.
-- **Archivo**: [`module-dependencies.mmd`](/guides/architecture/diagrams/module-dependencies.mmd)
+- **Archivo**: [`module-dependencies.mmd`](./diagrams/module-dependencies.mmd)
- **Descripción**: Muestra cómo los clientes dependen del core compartido y de frameworks externos.
## Cómo Visualizar
diff --git a/clients/web/apps/docs/src/content/docs/es/guides/getting-started.md b/clients/web/apps/docs/src/content/docs/es/guides/getting-started.md
index 89ebab95e..9b99f4a42 100644
--- a/clients/web/apps/docs/src/content/docs/es/guides/getting-started.md
+++ b/clients/web/apps/docs/src/content/docs/es/guides/getting-started.md
@@ -105,6 +105,6 @@ corvus --help
## Siguientes Pasos
-- Revisa la [Estructura del Proyecto](../structure/).
-- Consulta la [Lista de Funcionalidades](../features/).
-- Continúa con [Desarrollo](../development/).
+- Revisa la [Estructura del Proyecto](./structure/).
+- Consulta la [Lista de Funcionalidades](./features/).
+- Continúa con [Desarrollo](./development/).
diff --git a/clients/web/apps/docs/src/content/docs/es/guides/release.md b/clients/web/apps/docs/src/content/docs/es/guides/release.md
index 8b152c98d..0968323d4 100644
--- a/clients/web/apps/docs/src/content/docs/es/guides/release.md
+++ b/clients/web/apps/docs/src/content/docs/es/guides/release.md
@@ -9,7 +9,7 @@ usando GitHub Actions.
Antes de poder publicar, asegúrate de tener:
-1. **Clave GPG configurada**: Sigue la [Guía de Configuración GPG](../gpg-setup/) para crear y
+1. **Clave GPG configurada**: Sigue la [Guía de Configuración GPG](./gpg-setup.md) para crear y
configurar tu clave de firma
2. **Acceso a Maven Central**: Secrets del repositorio configurados:
@@ -259,6 +259,6 @@ Usa este checklist antes de publicar:
## Ver También
-- [Guía de Configuración GPG](../gpg-setup/)
+- [Guía de Configuración GPG](./gpg-setup.md)
- [GitHub Workflows](https://github.com/dallay/corvus/blob/main/.github/workflows/README.md)
- [Guía de Contribución](https://github.com/dallay/corvus/blob/main/.github/CONTRIBUTING.md)
diff --git a/clients/web/apps/docs/src/content/docs/es/index.mdx b/clients/web/apps/docs/src/content/docs/es/index.mdx
index c75f1e980..157fc8463 100644
--- a/clients/web/apps/docs/src/content/docs/es/index.mdx
+++ b/clients/web/apps/docs/src/content/docs/es/index.mdx
@@ -1,9 +1,9 @@
---
title: Corvus
-description: Plataforma reactiva de agentes siempre activos sobre JVM.
+description: Documentacion segura y pluggable para el runtime Rust-native de agentes autonomos.
template: splash
hero:
- tagline: Construye agentes proactivos y de larga duración con Kotlin, Spring Boot, Neo4j, sidecars en Rust y un panel transparente.
+ tagline: Construye agentes autonomos con un runtime Rust-native, seguro, pluggable, rapido y portable.
actions:
- text: Primeros Pasos
link: guides/getting-started/
@@ -21,17 +21,17 @@ import {Card, CardGrid, LinkCard} from '@astrojs/starlight/components';
## ¿Por qué Corvus?
-
- Kotlin + Spring Boot + Coroutines/WebFlux para flujos no bloqueantes y siempre activos.
+
+ Un binario pequeño en Rust con arranque rapido y bajo consumo de memoria para laptops, servidores, SBCs y entornos limitados.
-
- Arquitectura orientada a conocimiento con Neo4j para contexto conectado y memoria durable.
+
+ Pairing, sandboxing, aislamiento del workspace, allowlists y secretos cifrados forman parte de la postura por defecto.
-
- Binarios de alto rendimiento para scraping y operaciones seguras de sandbox.
+
+ Cambia providers, memoria, tools, canales, tunnels y runtime modes sin reescribir tu stack.
-
- Observabilidad en tiempo real con Astro/Vue y streaming de eventos.
+
+ Ejecuta Corvus en nativo o Docker con un solo runtime para chat, gateway, daemon, integraciones y automatizacion.
@@ -46,6 +46,8 @@ import {Card, CardGrid, LinkCard} from '@astrojs/starlight/components';
href="guides/features/"/>
+
diff --git a/clients/web/apps/marketing/src/layouts/MarketingLayout.astro b/clients/web/apps/marketing/src/layouts/MarketingLayout.astro
index 99b266f88..bf0b1262a 100644
--- a/clients/web/apps/marketing/src/layouts/MarketingLayout.astro
+++ b/clients/web/apps/marketing/src/layouts/MarketingLayout.astro
@@ -66,7 +66,7 @@ const ogImage = safeAbsoluteUrl(ogImageInput) ?? safeAbsoluteUrl("/og-image.png"
-
+
{canonical && }
{title}
diff --git a/clients/web/apps/marketing/src/pages/index.astro b/clients/web/apps/marketing/src/pages/index.astro
index 73b05e0ed..35672eb3b 100644
--- a/clients/web/apps/marketing/src/pages/index.astro
+++ b/clients/web/apps/marketing/src/pages/index.astro
@@ -1,105 +1,172 @@
---
import MarketingLayout from "../layouts/MarketingLayout.astro";
-const featureCards = [
+const conversionKeys = [
{
- title: "Secure by Default",
- body: "Pairing, sandboxed tools, explicit allowlists and workspace scoping are enabled from day one.",
+ title: "Lean by default",
+ body: "A small Rust binary, fast startup, and low memory usage make Corvus practical on laptops, servers, SBCs, and constrained edge hardware.",
},
{
- title: "Tiny Runtime",
- body: "Small Rust core with fast cold-start and low memory usage to run on edge hardware.",
+ title: "Secure by design",
+ body: "Pairing, sandboxing, workspace scoping, allowlists, encrypted secrets, and controlled public exposure are built into the runtime from day one.",
},
{
- title: "Swappable Stack",
- body: "Providers, channels, memory and tools are composable modules. Replace one layer without rewiring everything.",
+ title: "Pluggable at every layer",
+ body: "Providers, channels, tools, memory, tunnels, runtimes, and observability are trait-based and swappable, so your stack can evolve without rewrites.",
},
{
- title: "Production Signals",
- body: "Built-in doctor/status flows and deployment-friendly service commands for predictable operations.",
+ title: "No vendor lock-in",
+ body: "Use OpenRouter, OpenAI-compatible endpoints, local setups, or custom integrations without rebuilding your agent architecture.",
+ },
+ {
+ title: "Runs where you need it",
+ body: "Deploy natively or in Docker, from local-first development to secure remote gateway setups with tunnels and controlled exposure.",
+ },
+ {
+ title: "Built for real agent workflows",
+ body: "Chat, gateway, daemon, memory, channels, scheduled tasks, integrations, and service management ship as one coherent runtime.",
},
];
const testimonials = [
{
quote:
- "We moved from heavy orchestration to Corvus in two sprints and cut infra cost without giving up reliability.",
- author: "Platform Team, FinOps Startup",
+ "A small Rust binary, fast startup, low memory footprint, and a fully swappable architecture make Corvus practical as real agent infrastructure.",
+ author: "Architecture overview",
},
{
quote:
- "The onboarding flow made rollout easy. New developers go from zero to first task in minutes.",
- author: "Engineering Lead, Growth Studio",
+ "Pairing, sandboxing, allowlists, workspace scoping, and encrypted secrets are not optional extras. They are part of the default posture.",
+ author: "Security policy",
},
{
quote:
- "Finally an AI runtime that behaves like software infrastructure, not a fragile demo stack.",
- author: "CTO, B2B SaaS",
+ "Corvus ships with a 3.4MB optimized release build, boots in under 10ms, and supports 22+ providers with native or Docker runtime modes.",
+ author: "README benchmark snapshot",
+ },
+];
+
+const faqGroups = [
+ {
+ title: "Product and fit",
+ items: [
+ {
+ question: "What is Corvus?",
+ points: [
+ "Corvus is a Rust-native runtime for autonomous AI agents.",
+ "It combines model access, memory, tools, channels, and security controls into one portable system.",
+ "It is designed to behave like infrastructure, not a fragile demo stack.",
+ ],
+ ctaLabel: "Read the architecture",
+ ctaHref: "https://github.com/dallay/corvus",
+ },
+ {
+ question: "Who is it for?",
+ points: [
+ "Corvus fits developers, platform teams, and operators who want portable agent infrastructure.",
+ "It is a strong fit when security posture, runtime efficiency, and provider flexibility matter.",
+ "It helps teams avoid heavyweight stacks and unnecessary lock-in.",
+ ],
+ ctaLabel: "See the quick start",
+ ctaHref: "https://docs.profiletailors.com",
+ },
+ ],
+ },
+ {
+ title: "Security and operations",
+ items: [
+ {
+ question: "How does Corvus protect data and tools?",
+ points: [
+ "Pairing, sandboxing, workspace isolation, command allowlisting, and forbidden path protection are built in.",
+ "Gateway exposure is restrictive by default, with localhost binding and tunnel-aware controls.",
+ "Secrets can be encrypted locally and public access is never assumed.",
+ ],
+ ctaLabel: "Review security controls",
+ ctaHref: "https://docs.profiletailors.com",
+ },
+ {
+ question: "Where can it run?",
+ points: [
+ "Corvus runs as a native binary or in Docker.",
+ "It is built to stay practical across laptops, servers, SBCs, and constrained environments.",
+ "Its small binary size and fast startup make it viable beyond heavyweight cloud-only setups.",
+ ],
+ ctaLabel: "Explore runtime options",
+ ctaHref: "https://docs.profiletailors.com",
+ },
+ ],
},
];
+
+const hero = {
+ eyebrow: "RUST-NATIVE AGENT RUNTIME • SECURE BY DEFAULT • PORTABLE BY DESIGN",
+ title: "Run agents anywhere. Keep control everywhere.",
+ subtitle:
+ "Built in Rust, Corvus gives teams one runtime for chat, gateway, daemon, memory, channels, integrations, and secure execution, without the weight of a stitched-together stack.",
+ primaryCta: "Install Corvus",
+ secondaryCta: "Read the architecture",
+};
---
Corvus
-
-
Ship AI operators that stay fast, secure, and online.
-
- Corvus gives your team an operational runtime for agents: strict defaults, tiny footprint,
- and a distribution model that works from laptops to edge boxes.
-
Built for developers and teams who want agent infrastructure with strong defaults, real portability, and no unnecessary runtime weight.
@@ -254,7 +257,7 @@ const hero = {
Install Corvus, run your first agent workflow, and keep control over models, memory, tools, and deployment from day one.