🎃 Add a shared EmptyState component and use it for the "No … yet" screens
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 55/100
- Issue 类型
- 功能
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- react, typescript
- 领域
- frontend
调研方向
Start with the reference empty state in packages/frontend/src/app/connectors/page.tsx:390-420, then read components/ui/stat-card.tsx for tone tokens and components/ui/button.tsx for CTA patterns. Build the shared component at components/ui/empty-state.tsx and convert the listed pages, preserving role and deployment branches. Run lint and the specified Playwright tests; done means all listed states use the component and the mobile test and CTA spec pass.
由索引模型根据 Issue 内容生成。
描述
Part of the October Challenge #846.
Why
Each page writes its own empty state. The Connectors page has a well-designed one (icon, title, explanation, three actions), while most other pages show a single grey line such as "No custom roles yet." with no next step. A new user on a fresh instance hits most of these screens, so they are effectively onboarding. One shared EmptyState (icon + title + description + action) makes them consistent and gives every one of them a next step. Linear, Vercel and GitHub all use one pattern for this.
Self-hosted vs Cloud
- Self-hosted: frontend-only, same in Community and Business.
- Cloud (
DEPLOYMENT_MODE=cloud): same. No data or API changes. Keep the Cloud/self-hosted branches that already exist (e.g. License page: "Start 7-Day Free Trial" on Cloud vs a key form on self-hosted). - Who can use it: everyone. Keep the existing role checks on actions. If a page already shows an admin-only action (
isAdminin Skills and Knowledge graph), keep it admin-only, and show the "ask an admin" text to everyone else. Never show a CTA that leads to a 403.
What to build
- Create
packages/frontend/src/components/ui/empty-state.tsx:
It must work in light and dark themes (use the CSS variables only), be responsive, and use semantic markup (a heading + paragraph is enough).<EmptyState icon={<ServerIcon />} // optional ReactNode; inline SVGs like the rest of the app tone="emerald" // optional, reuse the Tone tokens from ui/badge + stat-card.tsx title="No MCP servers yet" description="Group connectors into an endpoint your AI client can connect to." action={<Button onClick={…}>Create your first MCP server</Button>} // optional, 0..n actions variant="card" | "dashed" | "inline" // inline = compact, for use inside a card/table /> - Replace these inline empty states with it:
app/mcp-server/page.tsx:170-175: "No MCP servers configured yet." (already has icon + button: convert it).app/mcp-server/page.tsx:176-178: "No MCP servers match your search." → add a "Clear search" action.app/logs/page.tsx:290-313: the three states (end of log / filters / nothing yet). Link the "nothing yet" one to/mcp-server.app/settings/roles/page.tsx:295-297: "No custom roles yet." → CTA opens the existing create form.app/knowledge-graph/skills/page.tsx:235-250: "No skills yet" (keep the admin/non-admin text).app/knowledge-graph/page.tsx:322-326: "No graph yet" (keep the admin/non-admin text).app/settings/license/page.tsx:229-233: "No license registered yet." (keep the Cloud/self-hosted branch).app/connectors/store/page.tsx:462-463: "No adapters available yet."app/mcp-server/[id]/page.tsx:795-796: "No connectors available. Create a connector first." → link to/connectors/new.app/analytics/page.tsx:226and:281: "No data in range." (inline variant).app/page.tsx:290: dashboard "No health data yet" (inline variant).app/connectors/page.tsx:390-420: the existing rich one. Rebuild it with the component without changing how it looks.
- Do not convert
components/tool-editor/index.tsx:976("No parameters yet") or theemptyMessagestrings passed toMultiSelect. Those are form hints, not page empty states.
Where to look
packages/frontend/src/app/connectors/page.tsx:390-420: the reference design.packages/frontend/src/components/ui/stat-card.tsx:5-13: tone → color mapping to reuse.packages/frontend/src/components/ui/button.tsx:Button/buttonVariantsforLinkCTAs.packages/frontend/tests/e2e/mobile.spec.ts:295-299: asserts "No connectors yet" sits inside an ancestor with classborder-dashed. Keep that class on thedashedvariant, or update the test in the same PR.app/admin/roles/page.tsx:262-264is a duplicate of the settings roles page with no nav link. Leave it alone.
Acceptance criteria
-
EmptyStateexists withicon,title,description,action,variant, and is used in all the places listed above. - No CTA shown to a role that can't use it. Existing Cloud/self-hosted branches are preserved.
- Light/dark and phone width look right (attach before/after screenshots of 3+ pages).
- Playwright:
mobile.spec.tsstill passes. Add one spec that renders/mcp-serverwith a stubbed empty list (pattern:redesign.spec.ts) and clicks the CTA. Run withcd packages/frontend && npm run test:e2e.npm run lintis clean. - No docs change needed. Add a short JSDoc on the component.
Out of scope
- Illustrations or new icon libraries (
lucide-reactis installed but unused; stay with inline SVGs for consistency). - Rewriting copy beyond what the new layout needs.
- Loading skeletons and error states.
Size
M (1–2 days)
How to claim
Comment "I'd like to work on this" and we'll assign you. Rules in #846.
- 主要语言
- TypeScript
- 星标
- 856
- 派生
- 82
- 平均合并
- 6 小时 30 分钟
- 30 天内合并 PR
- 205
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
HelpCode-ai/anythingmcp 的其他 Issue
-
Docs: document all SMTP_* and other undocumented env vars for self-hosting可能已有人在做 @notlakshitha 于 6 天前认领。 未关闭enhancement
难度 2/5 1-3 小时 新手友好度 82/100
HelpCode-ai/anythingmcp#1049 · 3 条评论 ·
维护者通常 1 天内回复
-
good first issue hacktoberfest
难度 2/5 半天 新手友好度 70/100
HelpCode-ai/anythingmcp#996 ·
维护者通常 1 天内回复
-
good first issue hacktoberfest
难度 2/5 半天 新手友好度 72/100
HelpCode-ai/anythingmcp#995 ·
维护者通常 1 天内回复
-
enhancement good first issue hacktoberfest help wanted
难度 2/5 1-3 小时 新手友好度 78/100
HelpCode-ai/anythingmcp#982 · 2 条评论 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 18/100
HelpCode-ai/anythingmcp#1174 · 1 条评论 ·
维护者通常 1 天内回复
查看 HelpCode-ai/anythingmcp 的全部 Issue
相似的 Issue
-
engine-rs P3 review-deferral wasm
难度 2/5 1-3 小时 新手友好度 77/100
maniator/verticopolis#1154 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
维护者通常 1 天内回复
-
Bug
难度 2/5 1-3 小时 新手友好度 76/100
telerik/kendo-react#3861 ·
维护者通常 1 天内回复
-
[bug]: use-mobile.ts uses pixel logic, causing UI state de-sync with Tailwind CSS rem breakpoints未关闭bug
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
task
难度 2/5 1-3 小时 新手友好度 72/100