# cerbere-ag/agentguard-shield architecture

> Architecture diagram of the GitHub repository cerbere-ag/agentguard-shield, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cerbere-ag/agentguard-shield
- Repository: https://github.com/cerbere-ag/agentguard-shield

## Overview

AgentGuard Shield is represented here as a public-facing product website, not the runtime-security SDK described in the pasted terminal transcript. A visitor reaches the landing page, documentation, or blog through the web app; the landing page presents integrations, a terminal-style demo, FAQs, and product/pricing information. The sampled code also shows router setup and server-side error handling. The README excerpt does not document these site internals, so relationships below rely on the source index or excerpts; the security engine and dashboard implementation are not present in the supplied tree.

Main entry points: [`src/routeTree.gen.ts`](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routeTree.gen.ts) (Route registry), [`src/routes/index.tsx`](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/index.tsx) (Landing page), [`src/components/Reveal.tsx`](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Reveal.tsx) (Reveal animation), [`src/routes/blog/detecting-prompt-injection-in-production.tsx`](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/blog/detecting-prompt-injection-in-production.tsx) (Security article)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Public content"]
  node_landing["Landing page<br/>[index.tsx]"]
  node_docs["Documentation<br/>[docs.tsx]"]
  node_blogindex["Blog index<br/>[index.tsx]"]
  node_blogpost["Security article"]
end

subgraph group_web["Web runtime"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route registry<br/>[routeTree.gen.ts]"]
  node_root_route["Root route<br/>[__root.tsx]"]
  node_server["Request handler<br/>[server.ts]"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Error response page<br/>[error-page.ts]"]
  node_error_reporting["Error reporting"]
end

subgraph group_shared["Shared components"]
  node_integrations["Integration showcase<br/>[Integrations.tsx]"]
  node_faq["FAQ<br/>[Faq.tsx]"]
  node_terminal["Terminal demo<br/>[Terminal.tsx]"]
  node_reveal["Reveal animation<br/>[Reveal.tsx]"]
  node_ui["UI primitives"]
end

node_visitor(("Website visitor"))

node_visitor -.->|"browses"| node_landing
node_router -->|"registers routes"| node_route_tree
node_route_tree -->|"includes"| node_root_route
node_route_tree -->|"registers"| node_landing
node_route_tree -->|"registers"| node_docs
node_route_tree -->|"registers"| node_blogindex
node_route_tree -->|"registers"| node_blogpost
node_landing -->|"renders"| node_integrations
node_landing -->|"renders"| node_faq
node_landing -->|"renders"| node_terminal
node_landing -->|"uses"| node_reveal
node_blogindex -->|"uses"| node_reveal
node_docs -->|"uses"| node_reveal
node_blogpost -->|"uses"| node_reveal
node_blogpost -->|"renders"| node_terminal
node_faq -->|"uses"| node_reveal
node_root_route -->|"uses"| node_error_reporting
node_server -->|"consumes captured error"| node_error_capture
node_server -->|"renders on failure"| node_error_page

click node_landing "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/index.tsx"
click node_docs "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/docs.tsx"
click node_blogindex "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/blog/index.tsx"
click node_blogpost "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/blog/detecting-prompt-injection-in-production.tsx"
click node_integrations "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Integrations.tsx"
click node_faq "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Faq.tsx"
click node_terminal "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Terminal.tsx"
click node_reveal "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Reveal.tsx"
click node_ui "https://github.com/cerbere-ag/agentguard-shield/tree/main/src/components/ui"
click node_router "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/router.tsx"
click node_route_tree "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routeTree.gen.ts"
click node_root_route "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/__root.tsx"
click node_server "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/server.ts"
click node_error_capture "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/error-capture.ts"
click node_error_page "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/error-page.ts"
click node_error_reporting "https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/lovable-error-reporting.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_landing,node_docs,node_blogindex,node_blogpost toneBlue
class node_router,node_route_tree,node_root_route,node_server,node_error_capture,node_error_page,node_error_reporting toneAmber
class node_integrations,node_faq,node_terminal,node_reveal,node_ui toneMint
class node_visitor toneIndigo
```

## Components

### Public content

- [Landing page](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Documentation](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/docs.tsx): `src/routes/docs.tsx`
- [Blog index](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/blog/index.tsx): `src/routes/blog/index.tsx`
- [Security article](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/blog/detecting-prompt-injection-in-production.tsx): `src/routes/blog/detecting-prompt-injection-in-production.tsx`

### Web runtime

- [Router setup](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/router.tsx): `src/router.tsx`
- [Route registry](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root route](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Request handler](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/server.ts): `src/server.ts`
- [Error capture](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error response page](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`
- [Error reporting](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/lib/lovable-error-reporting.ts): `src/lib/lovable-error-reporting.ts`

### Shared components

- [Integration showcase](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Integrations.tsx): `src/components/Integrations.tsx`
- [FAQ](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Faq.tsx): `src/components/Faq.tsx`
- [Terminal demo](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Terminal.tsx): `src/components/Terminal.tsx`
- [Reveal animation](https://github.com/cerbere-ag/agentguard-shield/blob/main/src/components/Reveal.tsx): `src/components/Reveal.tsx`
- [UI primitives](https://github.com/cerbere-ag/agentguard-shield/tree/main/src/components/ui): `src/components/ui`

### Other components

- **Website visitor**

## Connections

- Website visitor → Landing page: browses
- Router setup → Route registry: registers routes (evidence: `src/router.tsx`)
- Route registry → Root route: includes (evidence: `src/routeTree.gen.ts`)
- Route registry → Landing page: registers (evidence: `src/routeTree.gen.ts`)
- Route registry → Documentation: registers (evidence: `src/routeTree.gen.ts`)
- Route registry → Blog index: registers (evidence: `src/routeTree.gen.ts`)
- Route registry → Security article: registers (evidence: `src/routeTree.gen.ts`)
- Landing page → Integration showcase: renders (evidence: `src/routes/index.tsx`)
- Landing page → FAQ: renders (evidence: `src/routes/index.tsx`)
- Landing page → Terminal demo: renders (evidence: `src/routes/index.tsx`)
- Landing page → Reveal animation: uses (evidence: `src/routes/index.tsx`)
- Blog index → Reveal animation: uses (evidence: `src/routes/blog/index.tsx`)
- Documentation → Reveal animation: uses (evidence: `src/routes/docs.tsx`)
- Security article → Reveal animation: uses (evidence: `src/routes/blog/detecting-prompt-injection-in-production.tsx`)
- Security article → Terminal demo: renders (evidence: `src/routes/blog/detecting-prompt-injection-in-production.tsx`)
- FAQ → Reveal animation: uses (evidence: `src/components/Faq.tsx`)
- Root route → Error reporting: uses (evidence: `src/routes/__root.tsx`)
- Request handler → Error capture: consumes captured error (evidence: `src/server.ts`)
- Request handler → Error response page: renders on failure (evidence: `src/server.ts`)
