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 (Express.js) routing architecture
State Management	Zustand stores, React Query, and state patterns
Database	Drizzle ORM setup, schema organization, and query patterns
Authentication	Session-based auth with Lucia, OAuth flows, and security

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: Express.js 5.1.0
Database: PostgreSQL with pgvector extension
ORM: Drizzle ORM
Authentication: Lucia Auth with GitHub/Google OAuth

Monorepo Structure


AgentPress/
├── apps/
│   ├── console/            # Admin console (Vite + React)
│   ├── api/                # Express.js 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