Architecture Overview

AgentPress follows a modern monorepo architecture with clear separation of concerns. This section covers the foundational layers of the application.

Core Documentation

Document	Description
Routing	Frontend (TanStack React Router) and backend (Hono) routing architecture
State Management	Zustand stores, React Query, and state patterns
Database	Drizzle ORM setup, schema organization, and query patterns
Authentication	Clerk (primary), Lucia Auth (legacy fallback), OAuth flows, and security
Custom Tool UI	Dynamic tool UI components, bundle compilation, and runtime loading

Technology Stack

Frontend

Build Tool: Vite
Framework: React 19 with TanStack Router
Styling: Tailwind CSS v4
UI Components: Radix UI
State Management: Zustand with React Query

Backend

Framework: Hono 4.x
Database: PostgreSQL with pgvector extension
ORM: Drizzle ORM
Authentication: Clerk (primary), Lucia Auth (legacy fallback), GitHub/Google OAuth

Monorepo Structure


AgentPress/
├── apps/
│   ├── console/            # Admin console (Vite + React)
│   ├── api/                # Hono API server
│   ├── portal/             # User-facing portal (Vite + React)
│   ├── dropin-chat/        # Embeddable chat widget
│   └── docs/               # This documentation site (Nextra)
├── packages/
│   ├── api/                # Core backend logic (@agentpress/api)
│   ├── lib/                # Shared library (@agentpress/lib)
│   ├── ui/                 # UI components (@agentpress/ui)
│   ├── custom/             # Custom implementations
│   └── cli/                # CLI tool
└── .docs/                  # Internal development documentation