project-overview

Original：🇺🇸 English

Translated

Complete project architecture and structure guide. Use when exploring the codebase, understanding project organization, finding files, or needing comprehensive architectural context. Triggers on architecture questions, directory navigation, or project overview needs.

84installs

Sourcelobehub/lobe-chat

Added on2026-02-04

NPX Install

npx skill4agent add lobehub/lobe-chat project-overview

SKILL.md Content

View Translation Comparison →

LobeChat Project Overview

Project Description

Open-source, modern-design AI Agent Workspace: LobeHub (previously LobeChat).

Supported platforms:

Web desktop/mobile
Desktop (Electron)
Mobile app (React Native) - coming soon

Logo emoji: 🤯

Complete Tech Stack

Category	Technology
Framework	Next.js 16 + React 19
Routing	SPA inside Next.js with `react-router-dom`
Language	TypeScript
UI Components	`@lobehub/ui` , antd
CSS-in-JS	antd-style
Icons	lucide-react, `@ant-design/icons`
i18n	react-i18next
State	zustand
URL Params	nuqs
Data Fetching	SWR
React Hooks	aHooks
Date/Time	dayjs
Utilities	es-toolkit
API	TRPC (type-safe)
Database	Neon PostgreSQL + Drizzle ORM
Testing	Vitest

Complete Project Structure

Monorepo using

@lobechat/

namespace for workspace packages.

lobe-chat/
├── apps/
│   └── desktop/                 # Electron desktop app
├── docs/
│   ├── changelog/
│   ├── development/
│   ├── self-hosting/
│   └── usage/
├── locales/
│   ├── en-US/
│   └── zh-CN/
├── packages/
│   ├── agent-runtime/           # Agent runtime
│   ├── builtin-agents/
│   ├── builtin-tool-*/          # Builtin tool packages
│   ├── business/                # Cloud-only business logic
│   │   ├── config/
│   │   ├── const/
│   │   └── model-runtime/
│   ├── config/
│   ├── const/
│   ├── context-engine/
│   ├── conversation-flow/
│   ├── database/
│   │   └── src/
│   │       ├── models/
│   │       ├── schemas/
│   │       └── repositories/
│   ├── desktop-bridge/
│   ├── edge-config/
│   ├── editor-runtime/
│   ├── electron-client-ipc/
│   ├── electron-server-ipc/
│   ├── fetch-sse/
│   ├── file-loaders/
│   ├── memory-user-memory/
│   ├── model-bank/
│   ├── model-runtime/
│   │   └── src/
│   │       ├── core/
│   │       └── providers/
│   ├── observability-otel/
│   ├── prompts/
│   ├── python-interpreter/
│   ├── ssrf-safe-fetch/
│   ├── types/
│   ├── utils/
│   └── web-crawler/
├── src/
│   ├── app/
│   │   ├── (backend)/
│   │   │   ├── api/
│   │   │   ├── f/
│   │   │   ├── market/
│   │   │   ├── middleware/
│   │   │   ├── oidc/
│   │   │   ├── trpc/
│   │   │   └── webapi/
│   │   ├── [variants]/
│   │   │   ├── (auth)/
│   │   │   ├── (main)/
│   │   │   ├── (mobile)/
│   │   │   ├── onboarding/
│   │   │   └── router/
│   │   └── desktop/
│   ├── business/                # Cloud-only (client/server)
│   │   ├── client/
│   │   ├── locales/
│   │   └── server/
│   ├── components/
│   ├── config/
│   ├── const/
│   ├── envs/
│   ├── features/
│   ├── helpers/
│   ├── hooks/
│   ├── layout/
│   │   ├── AuthProvider/
│   │   └── GlobalProvider/
│   ├── libs/
│   │   ├── better-auth/
│   │   ├── oidc-provider/
│   │   └── trpc/
│   ├── locales/
│   │   └── default/
│   ├── server/
│   │   ├── featureFlags/
│   │   ├── globalConfig/
│   │   ├── modules/
│   │   ├── routers/
│   │   │   ├── async/
│   │   │   ├── lambda/
│   │   │   ├── mobile/
│   │   │   └── tools/
│   │   └── services/
│   ├── services/
│   ├── store/
│   │   ├── agent/
│   │   ├── chat/
│   │   └── user/
│   ├── styles/
│   ├── tools/
│   ├── types/
│   └── utils/
└── e2e/                         # E2E tests (Cucumber + Playwright)

Architecture Map

Layer	Location
UI Components	`src/components` , `src/features`
Global Providers	`src/layout`
Zustand Stores	`src/store`
Client Services	`src/services/`
REST API	`src/app/(backend)/webapi`
tRPC Routers	`src/server/routers/{async\|lambda\|mobile\|tools}`
Server Services	`src/server/services` (can access DB)
Server Modules	`src/server/modules` (no DB access)
Feature Flags	`src/server/featureFlags`
Global Config	`src/server/globalConfig`
DB Schema	`packages/database/src/schemas`
DB Model	`packages/database/src/models`
DB Repository	`packages/database/src/repositories`
Third-party	`src/libs` (analytics, oidc, etc.)
Builtin Tools	`src/tools` , `packages/builtin-tool-*`
Cloud-only	`src/business/` , `packages/business/`

Data Flow

React UI → Store Actions → Client Service → TRPC Lambda → Server Services → DB Model → PostgreSQL