# Repository Map

Explains the layout of the LobeHub repository and which package owns each part.

- Repository: https://github.com/lobehub/lobehub (83676 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lobehub/lobehub --skill project-overview -g -a claude-code -y`
Codex: `npx skills add lobehub/lobehub --skill project-overview -g -a codex -y`
Cursor: `npx skills add lobehub/lobehub --skill project-overview -g -a cursor -y`
Gemini CLI: `npx skills add lobehub/lobehub --skill project-overview -g -a gemini-cli -y`

## Description

Use for the OSS repository map, code-layer lookup, apps/packages/src ownership and business stubs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# LobeHub Project Overview

> The directory listings below are a **curated map of key locations**, not an
> exhaustive tree. `packages/`, `src/store/`, route groups etc. grow over time, > run `ls` against the real directory for the current set.

## Project Description

Open-source, modern-design AI Agent Workspace: **LobeHub** (previously LobeChat).
This repo is the **open-source root** (`github.com/lobehub/lobehub`, package `@lobehub/lobehub`).

**Supported platforms:**

- Web desktop/mobile
- Desktop (Electron), `apps/desktop`
- Mobile app (React Native), **separate repo, already launched** (not in this monorepo)

**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`                              |
| CSS-in-JS     | `@lobehub/ui` `createStaticStyles`         |
| 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                                     |

> Exact versions live in the root `package.json`, check there, not here.

## Monorepo Layout

Flat layout, `apps/`, `packages/`, and `src/` all sit at the repo root. No
git submodules.

The rest: https://github.com/lobehub/lobehub/blob/HEAD/.agents/skills/project-overview/SKILL.md