mirror of https://github.com/lobehub/lobehub.git synced 2026-03-27 13:29:15 +07:00

Files

CanisMinor 43578a9bcc 📝 docs: Polishing and improving product documentation (#12612 )

* 🔖 chore(release): release version v2.1.34 [skip ci]

* 📝 docs: Polish documents

* 📝 docs: Fix typo

* 📝 docs: Update start

* 📝 docs: Fix style

* 📝 docs: Update start

* 📝 docs: Update layout

* 📝 docs: Fix typo

* 📝 docs: Fix typo

---------

Co-authored-by: lobehubbot <i@lobehub.com>

2026-03-03 16:01:41 +08:00

2.3 KiB

Raw Blame History

GEMINI.md

Guidelines for using Gemini CLI in this LobeHub repository.

Tech Stack

Next.js 16 + React 19 + TypeScript
SPA inside Next.js with react-router-dom
@lobehub/ui, antd for components; antd-style for CSS-in-JS
react-i18next for i18n; zustand for state management
SWR for data fetching; TRPC for type-safe backend
Drizzle ORM with PostgreSQL; Vitest for testing

Project Structure

lobe-chat/
├── apps/desktop/           # Electron desktop app
├── packages/               # Shared packages (@lobechat/*)
│   ├── database/           # Database schemas, models, repositories
│   ├── agent-runtime/      # Agent runtime
│   └── ...
├── src/
│   ├── app/                # Next.js app router
│   ├── store/              # Zustand stores
│   ├── services/           # Client services
│   ├── server/             # Server services and routers
│   └── ...
└── e2e/                    # E2E tests (Cucumber + Playwright)

Development

Git Workflow

Branch strategy: canary is the development branch (cloud production); main is the release branch (periodically cherry-picks from canary)
New branches should be created from canary; PRs should target canary
Use rebase for git pull
Commit messages: prefix with gitmoji
Branch format: <type>/<feature-name>
PR titles with ✨ feat/ or 🐛 fix trigger releases

Package Management

pnpm for dependency management
bun to run npm scripts
bunx for executable npm packages

Testing

# Run specific test (NEVER run `bun run test` - takes ~10 minutes)
bunx vitest run --silent='passed-only' '[file-path]'

# Database package
cd packages/database && bunx vitest run --silent='passed-only' '[file]'

Tests must pass type check: bun run type-check
After 2 failed fix attempts, stop and ask for help

i18n

Add keys to src/locales/default/namespace.ts
For dev preview: translate locales/zh-CN/ and locales/en-US/
Don't run pnpm i18n - CI handles it

Quality Checks

MANDATORY: After completing code changes, run diagnostics on modified files to identify and fix any errors.

Skills (Auto-loaded)

Skills are available in .agents/skills/ directory. See CLAUDE.md for the full list.

2.3 KiB Raw Blame History