lobehub

Use for Zustand stores: state shapes and type sources, state-only stores with xActions classes, replica-backed list/detail data (local-replica), selectors, optimistic writes, and legacy slice/internal action composition.

Use for TSX components, UI libraries, styling, state locality, layout, render performance and memoization.

Use for Drizzle schemas and queries: tables, indexes, relations, joins and inferred types. Rollout belongs to db-migrations.

Use for TypeScript style and type safety when editing TS/TSX/MTS, including imports, async code and error suppression.

Use for user-facing strings and react-i18next locale keys, namespaces, interpolation, translations or bun run i18n.

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

Use for Vitest tests, mocks, coverage and failing-test diagnosis.

Electron desktop development guide — IPC handlers, controllers, preload scripts, window/menu management.

Use for modals, dialogs and confirmations with createModal, confirmModal, ModalHost or base-ui modal APIs.

Add server-side environment variables that control default values for user settings.

Use for Linear issues, LOBE-xxx links, status updates, completion comments and sub-issue trees.

Use for keyboard shortcuts, registration, key combinations, scope, conflicts and shortcut tooltips.

Add documentation for a new AI provider — usage docs, env vars, Docker config, image resources.

UI copy and microcopy guidelines. Use for user-facing copy, buttons, errors, empty states, onboarding, i18n wording, translation, or copy improvements in Chinese or English.

Version release workflow — release process and GitHub Release notes (not docs/changelog pages).

Explicit compatibility entry for Zustand data-shape guidance.

Create a PR for the current branch (targets canary by default), including splitting one cross-layer branch into ordered stacked PRs so a lower layer (db / shared package / server TRPC) merges before its callers (desktop / CLI / UI). Use when the user asks to create / submit a PR, or to split a branch because clients call a server contract that isn't on the trunk yet. Triggers on 'pr', 'create pr', 'submit pr', 'open a PR', 'pull request', 'split this PR', 'stacked PR', 'backend should merge first', '提 PR', '提个 PR', '新建 PR', '拆 PR', '后端先合', '分层合并'.

Use for Upstash Workflow/QStash handlers, triggers, durable steps and async fan-out.

Debug package usage guide. Use when adding debug logging, understanding log namespaces, or implementing debugging features. Triggers on debug logging requests or logging implementation.

Guide for using Recent Data (topics, resources, pages). Use when working with recently accessed items, implementing recent lists, or accessing session store recent data. Triggers on recent data usage or implementation tasks.

Data fetching architecture guide using Service layer + Zustand Store + SWR. Use when implementing data fetching, creating services, working with store hooks, or migrating from useEffect. Triggers on data loading, API calls, service creation, or store data fetching tasks.

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.