project-overview

Maps the LobeHub monorepo structure, tech stack, and code-layer ownership for navigation.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SmallAi-API/smaihub --skill project-overview-smallai-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-overview
Source: https://github.com/SmallAi-API/smaihub/tree/main/.agents/skills/project-overview
Command: npx skills add https://github.com/SmallAi-API/smaihub --skill project-overview-smallai-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working in the LobeHub monorepo waste time hunting for where code lives across apps/, packages/, and src/. This Skill provides a curated repository map so you can locate the right layer, package, or ownership boundary immediately. ## Core Features & Use Cases - Repository Map: Curated directory listings of apps/, packages/, and src/ with annotations for key locations like agent-runtime, database, and builtin tools. - Architecture Lookup: A layer-to-location table covering UI components, SPA routes, zustand stores, tRPC routers, server services, and database schemas. - Tech Stack Reference: Documents the full stack including Next.js 16, React 19, TypeScript, Drizzle ORM, TRPC, and Vitest. - Use Case: When asked to fix a bug in a tRPC endpoint, consult this Skill to learn routers live in apps/server/src/routers and services with DB access live in apps/server/src/services. ## Quick Start Ask where the database schema definitions live in this repository and which package owns them.

Frequently Asked Questions about project-overview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find where a feature lives in the LobeHub monorepo?

Use the architecture map table to match the layer to its location. For example, UI components live in src/components and src/features, tRPC routers in apps/server/src/routers, and database schemas in packages/database/src/schemas.

What tech stack does the LobeHub repository use?

The stack includes Next.js 16 with React 19, TypeScript, zustand for state, TRPC for type-safe APIs, Neon PostgreSQL with Drizzle ORM, antd-style for CSS-in-JS, and Vitest for testing. Exact versions are in the root package.json.

Where are the database models and schemas located?

Database code lives in packages/database, split into src/schemas for Drizzle schema definitions, src/models for models, and src/repositories for repositories. Server services in apps/server/src/services can access the database.

Does this repo contain the cloud SaaS implementation code?

No. The cloud repo is private and consumes this repo as a git submodule. This repo ships open-source stubs in src/business/ and packages/business/, which the cloud repo overrides with real implementations.

Is the mobile app included in this monorepo?

No. The React Native mobile app lives in a separate repository and is already launched. This monorepo contains the web app, the Electron desktop app under apps/desktop, and the CLI under apps/cli.