SvelteKit + Cloudflare Workers

用 SvelteKit 交付 AI SaaS,不必从零重做认证与计费。

生产级 SvelteKit 模板:登录、访客模式、结账、积分、文档、博客与控制台已预接,后端契约与 Nuxt 栈一致。复制模板、配置品牌,部署到 Cloudflare。

AUTH_SERVICE /auth/login /auth/me /credits/balance

PAY_SERVICE /pricing/plans /stripe/checkout /user/orders

BLOG_SERVICE /blog/list /blog/get,支持 Markdown 本地兜底内容

AI_SERVICE /ai/models /ai/chat/completions,支持用户 API Key

SUPPORT + CHECKIN /feedback /tickets /checkin/status /checkin/claim

能力

SaaS 前台第一天就需要的能力。

品牌、SEO、Analytics 同意、Dashboard 功能开关与 Service Binding 都从一份 manifest 配置,营销站、产品台与文档一起交付。

运行时 Cloudflare
认证 HttpOnly
服务 Auth + Pay + AI
内容 Docs + Blog

认证与会话

邮箱、访客与 OAuth 就绪的 BFF,HttpOnly Cookie 会话。

计费与积分

套餐、结账、订单、订阅与积分余额,经 pay-service 代理。

工作台

API Key、工单、签到、邀请与 AI Playground,由 feature flag 控制。

文档、博客与合规

Markdown 内容、sitemap、robots 与政策页开箱即用。

SEO 与分析

manifest 驱动 title/OG;第三方脚本仅在 consent 后加载。

Cloudflare Workers

Auth、Pay、Blog、AI、Support 等 Service Binding 对齐。

工作流

从首次访问到付费使用。

认证

基于 Cookie 的会话

登录响应会把后端 token 保留在服务端,浏览器侧只拿到标准化后的账号数据。

支付

支付服务结账

价格和结账请求通过 service binding 或本地 Worker fallback 代理到 node3-pay-service。

工作台

产品工作流

控制台会在当前会话下读取余额、交易、订单、订阅、API Key、支持工单和每日签到状态。

内容

文档和博客

公开文档、博客 API、法律页面、sitemap、robots 和 llms.txt 随 SvelteKit 应用一起提供。

常见问题

分叉模板前的常见问题。

和 web-nuxt 有什么不同?

web-sveltekit 是并行的 SvelteKit 前台,共享同一套 ZShip BFF 契约。团队更偏好 Svelte 时选用本模板。

品牌和 SEO 在哪里配置?

编辑 apps/web-sveltekit/zship.app.json 中的 siteName、seo.landingTitle、seo.landingDescription、footer、analytics 与 dashboard feature flags。

Analytics 脚本何时加载?

默认永不加载。配置了 provider ID 且开启 consentBanner 后,仅在用户同意 Cookie 后才注入 GA / Plausible / Clarity。

如何隐藏 Dashboard 模块?

在 manifest 中将 dashboard.features.checkin、tickets、referral 或 enterpriseBilling 设为 false,即可隐藏入口并拦截直链。

开始使用

本周就能上线品牌化 SvelteKit AI SaaS 前台。

复制模板、设置 app key 与域名、接好 Service Binding,公开漏斗自带文档与定价页。