Showcase
了解并移除 Showcase 演示 catalog。
Showcase 是一个可移除的能力 catalog。它适合评估模板、给团队讲解功能, 但它和核心服务保持隔离,所以你的产品可以删除它,而不需要拆掉认证、存储、 订阅或其他真实功能。
它提供什么
app/(tabs)/showcase.tsx 从 CAPABILITY_CATALOG 渲染分组列表。带 href
的行会打开真实路由;信息行没有箭头。
Catalog 模型
模型有六个分类:
foundation -> authentication -> backendData -> commerce -> growth -> operations当前 catalog 有 18 项:
| 分类 | 条目 |
|---|---|
| Foundation | Theming、Onboarding、Haptics |
| Authentication | Supabase Auth、Biometric Lock、Account Security |
| Backend & Data | Todos、Storage Upload |
| Commerce | Paywall、Redeem Code、Manage Subscription |
| Growth | Deep Links、Referrals、Push Notifications、App Rating |
| Operations | Permissions、Update Gate、Observability |
Component gallery 不是 Showcase 行。它是独立标签页,由
lib/component/component-catalog.ts 驱动。
状态标签
| 状态 | 含义 |
|---|---|
liveDemo | 打开可运行路由;因为已有箭头,所以不显示绿色 badge |
configured | 由构建或 env 配置驱动,比如版本门禁 |
deviceOnly | 需要真机能力,比如生物识别 |
requiresKeys | 需要服务 key,比如 RevenueCat、PostHog 或 Sentry |
这些标签只是展示元数据。真正的功能门禁仍然在各自 provider 和 screen 中。
演示路由
| 路由 | 展示内容 |
|---|---|
/showcase/theming | 主题切换、语言切换、token 预览和示例控件 |
/showcase/haptics | impact、notification、selection haptic helper |
/showcase/auth | 只读 Supabase session inspector |
/showcase/deep-links | 允许的应用内链接、createAppLink()、URL 解析和 openDeepLink() |
/showcase/rating | 应用内评分触发器和评分保护规则 |
其他 catalog 行会打开真实 app screen,例如 /todos、/upload-sample、
/paywall、/redeem-code、/manage-subscription、/notifications、
/permissions 和 /account-security。
依赖规则
核心应用代码不应该从 lib/showcase 导入。当前模板里,只有 Showcase 标签页
导入它。首页刻意保留了一份本地的六分类入口,然后跳转到 /showcase;它
不消费 catalog 数据模型。
这个单向依赖让删除过程很可控。
删除 Showcase
移除标签页
从 app/(tabs)/_layout.tsx 删除 showcase <Tabs.Screen>,并从侧边抽屉
Discover 区域删除 showcase 项。
移除首页链接
在 app/(tabs)/index.tsx 删除 "What's inside" 分类区域,或者改成打开你
自己的产品路由。如果没有其他地方使用,也删除 openShowcase()。
清理深层链接和文案
如果不希望旧链接继续解析,从 lib/deep-links.ts 移除 /showcase 和
/showcase/* allow-list。再从 lib/i18n/en.json 和 lib/i18n/zh.json
删除未使用的 tabs.showcase、capabilityCategory、capabilityStatus 和
showcase.* 文案。
保留真实功能
删除 Showcase 不要求删除:
app/todos.tsxapp/upload-sample.tsxapp/permissions.tsxapp/refer.tsxapp/paywall.tsxapp/redeem-code.tsxapp/manage-subscription.tsxapp/notifications.tsxapp/account-security.tsx- Component 标签页
这些是 Showcase 文件夹之外的应用界面或示例。只有在产品不再需要对应功能 时才删除它们。
