Files
lobehub__lobehub/docs/usage/user-interface/appearance.mdx
YuTengjing 191f3fe776 📝 docs: fix outdated content across the docs site (#16964)
* 📝 docs: fix outdated content across the docs site

Audited docs/ against the current codebase and fixed stale content that
drifted after major refactors (Clerk/NextAuth → Better Auth, src/server →
apps/server, src/{config,envs,locales} → packages/*, model-bank updates).

- self-hosting/auth: mark removed NextAuth/Clerk pages with deprecation
  warnings; fix microsoft/zitadel alias claims and the Logto callback path
- environment-variables & advanced: correct wrong defaults (S3_SET_ACL,
  AI_IMAGE_DEFAULT_IMAGE_NUM, index/proxy URLs), drop non-existent env vars
  and fictional feature flags, fix OIDC config guidance
- development: update refactored paths, Better Auth, .mjs configs, remove
  the MSW section (msw is not a dependency)
- providers & model examples: replace retired model ids with in-bank ones;
  fix comfyui frontmatter corruption
- usage: rename Moderator→Orchestrator, GTD→Task, correct shortcut keys,
  channel capability tables, Feishu/Lark WebSocket mode
- platform/migration: fix dead links, docker service name, npx/npm → bun

EN and zh-CN pairs updated together.

* 📝 docs: fix Logto callback path and AUTH_SECRET deprecation guidance

- Revert Logto/Sealos callback URLs to /api/auth/callback/logto to match
  the runtime SSO redirectURI override
- Narrow legacy auth Callout: AUTH_SECRET remains required for Better Auth;
  mark NEXT_AUTH_SECRET as deprecated in zh-CN

* 📝 docs: refresh agent skills for locales, env, auth, and agentRun paths

Align OSS agent guidance with post-refactor layout:
- packages/locales/src/default + bun run i18n
- packages/env/src for env schemas (@/envs alias)
- spa-auth shell + src/routes/auth segments
- chat agentRun/transports/hetero instead of aiChat

* 📝 docs: document APP_URL as required for Better Auth base URL

Self-hosted auth uses appEnv.APP_URL as baseURL, not request-header
auto-detection. NEXT_PUBLIC_AUTH_URL remains deprecated.

* 📝 docs: note self-host search provider setup for web search

Built-in lobe-web-browsing needs no client plugin, but self-hosted
servers still require SEARCH_PROVIDERS / SEARXNG_URL (default SearXNG).

* 📝 docs: point feature guide welcome UI at AgentHome

Opening message/questions on the agent chat page live in
src/features/AgentHome, not Onboarding WelcomeMessage.
2026-07-10 17:50:03 +08:00

82 lines
3.6 KiB
Plaintext

---
title: Interface Appearance
description: >-
Customize LobeHub's look — theme, colors, language, code highlighting, and
Mermaid diagrams. Make it yours.
tags:
- LobeHub
- Appearance
- Theme
- Language
- Customization
---
# Interface Appearance
Appearance settings let you customize how LobeHub looks and feels. Switch themes, pick accent colors, set the default language for Agent responses, and tune code and diagram styling. All visual-related options are grouped here.
**How to access:** Click your user avatar in the top-right corner → **App Settings** → **Appearance**.
## Language
Switch the interface language. LobeHub supports multiple locales — choose the one that fits your workflow.
## Theme Mode
Three options:
| Mode | Best For |
| ----------------- | ------------------------------------------ |
| **Light** | Bright environments, daytime use |
| **Dark** | Low-light environments, reduced eye strain |
| **Follow System** | Match your OS preference (default) |
**Follow System** automatically switches between light and dark based on your operating system setting. Useful if you use LobeHub across different times of day or environments.
## Theme Colors
Beyond light and dark, you can set an **accent color** — the color used for buttons, highlights, links, and other interactive elements. LobeHub offers preset theme and neutral colors. Click a swatch to apply it; the interface updates immediately.
**Use cases:** Match your brand, reduce visual clutter with a neutral palette, or pick a color that helps you focus.
## Agent Language
Set the **default language for Agent responses**. Once selected, Agents will prioritize replying in that language unless you explicitly request another in the conversation.
**Example:** If you set "Chinese," the Agent will reply in Chinese by default. You can still say "Reply in English" for a specific message.
## Code Highlighting
When your conversation or document includes code blocks, you can choose a **syntax highlighting theme**. Choose one that complements your overall theme — light themes pair well with light code themes, dark with dark.
**Use cases:** Improve readability during code reviews, match your IDE's color scheme for consistency, or reduce eye strain in long coding sessions.
## Mermaid Theme
Mermaid is a text-based diagram tool. When your conversation or document includes Mermaid diagrams (flowcharts, sequence diagrams, etc.), you can choose a **Mermaid theme** for them. Align it with your overall theme so diagrams look consistent with the rest of the interface.
## Response Animation
Choose the animation speed used for the application's response actions (e.g. message streaming and transitions).
| Mode | Description |
| ----------- | --------------------------------- |
| **Off** | Disable response animations |
| **Agile** | Quick, snappy animation timing |
| **Elegant** | Smoother, slower animation timing |
## Right-Click Menu Mode
Choose whether the right-click context menu is enabled for some list items.
| Mode | Description |
| ------------ | --------------------------------------------------- |
| **Disabled** | No right-click menu on the supported list items |
| **Default** | Enable the right-click menu for the supported items |
<Cards>
<Card href={'/docs/usage/user-interface/shortcuts'} title={'Keyboard Shortcuts'} />
<Card href={'/docs/usage/agent/translate'} title={'Conversation Translation'} />
</Cards>