Showcase

了解并移除 Showcase 演示 catalog。

Showcase 是一个可移除的能力 catalog。它适合评估模板、给团队讲解功能, 但它和核心服务保持隔离,所以你的产品可以删除它,而不需要拆掉认证、存储、 订阅或其他真实功能。

它提供什么

app/(tabs)/showcase.tsxCAPABILITY_CATALOG 渲染分组列表。带 href 的行会打开真实路由;信息行没有箭头。

Catalog 模型

模型有六个分类:

foundation -> authentication -> backendData -> commerce -> growth -> operations

当前 catalog 有 18 项:

分类条目
FoundationTheming、Onboarding、Haptics
AuthenticationSupabase Auth、Biometric Lock、Account Security
Backend & DataTodos、Storage Upload
CommercePaywall、Redeem Code、Manage Subscription
GrowthDeep Links、Referrals、Push Notifications、App Rating
OperationsPermissions、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/hapticsimpact、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()

删除 Showcase 路由

删除:

app/(tabs)/showcase.tsx
app/showcase/

删除 catalog 模型

删除:

lib/showcase/

然后 grep 确认没有残留导入:

rg "showcase|lib/showcase" app components lib

清理深层链接和文案

如果不希望旧链接继续解析,从 lib/deep-links.ts 移除 /showcase/showcase/* allow-list。再从 lib/i18n/en.jsonlib/i18n/zh.json 删除未使用的 tabs.showcasecapabilityCategorycapabilityStatusshowcase.* 文案。

保留真实功能

删除 Showcase 不要求删除:

  • app/todos.tsx
  • app/upload-sample.tsx
  • app/permissions.tsx
  • app/refer.tsx
  • app/paywall.tsx
  • app/redeem-code.tsx
  • app/manage-subscription.tsx
  • app/notifications.tsx
  • app/account-security.tsx
  • Component 标签页

这些是 Showcase 文件夹之外的应用界面或示例。只有在产品不再需要对应功能 时才删除它们。

相关页面

On this page