project-overview
250
总安装量
250
周安装量
#1084
全站排名
安装命令
npx skills add https://github.com/lobehub/lobehub --skill project-overview
Agent 安装分布
opencode
176
claude-code
174
codex
168
gemini-cli
166
github-copilot
149
antigravity
116
Skill 文档
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