文章

web-sveltekit 快速开始

从首次访问到演示、控制台激活与上线前信任面检查。

本指南面向评估 SvelteKit 模板的团队，以及准备第一次公开上线的构建者。

1. 验证公开漏斗

  • 未登录打开落地页，确认 Hero CTA 可进入 /guest-demo 或 /login。
  • 登录后确认控制台入口打开 /dashboard。
  • 确认公开 Header 暴露定价、文档、支持与博客。
  • 确认 Footer 展示可用联系邮箱与支持入口。

2. 验证产品激活路径

  • 访问 /guest-demo 并确认真实访客会话已创建。
  • 进入 /dashboard/ai-playground，确认同一会话仍然有效。
  • 打开 /dashboard，确认首页更像激活页而不是纯账户摘要。

3. 验证认证与账号升级

  • 通过 /auth/register（或 /login）注册新账号。
  • 确认登录后跳转进入控制台，激活卡片仍然可见。
  • 确认访客可以升级为正式账号且不丢失主产品路径。

4. 验证积分与计费

  • 检查 /pricing 是否能加载真实套餐数据。
  • 打开控制台积分/订单相关面，确认余额与当前会话一致。
  • 在 pay-service 配置就绪时，用 sandbox 走完结账并检查订阅与订单状态。

5. 上线前清单

  • 更新 apps/web-sveltekit/zship.app.json 中的 domain、siteUrl、tagline、contactEmail。
  • 配置 footer 块；字段说明见 Footer configuration。
  • 检查 dashboard.url 与 dashboard.features.*，只暴露产品真正支持的流程。
  • 仔细审核 seo.landingTitle 与 seo.landingDescription——它们会成为首页主关键词信号；上线与提交 sitemap 前务必检查。
  • 仅在准备好时配置 analytics.*；开启 consent banner 后，脚本在用户同意前不会加载。
  • 替换 static/ 中的占位品牌资源。
  • 部署前运行 pnpm --filter @zship/web-sveltekit check 与 pnpm --filter @zship/web-sveltekit build。
  • 检查本帮助中心文档，使支持与计费预期与产品一致。

本地开发

pnpm --filter @zship/web-sveltekit dev

默认开发端口为 4329。

推荐继续阅读

  • Skills & vibe coding
  • Billing and credits
  • Footer configuration
  • Auth and guest mode
  • Analytics
  • AI playground
  • Support and refund
上一篇 下一篇