sokko-storefront-template — Next.js 电商模板

这是 Sokko 官方提供的店面启动模板，定位很明确：把你在 Sokko 上的商品目录搬到自己域名下展示，交易环节仍由 Sokko 完成。技术栈是 Next.js App Router、TypeScript、Tailwind，加上 @sokkoke/storefront-react 这个无样式 SDK。克隆后填入一个 storefront id 就能跑起来，品牌定制集中在 theme.css、fonts.ts、site.ts 等少数几个文件里。

比较有辨识度的是它的主题系统。同一套组件树通过 design token 切换出 Minimal、Neobrutalist、Editorial、Soft 四种视觉身份，颜色、描边、圆角、阴影、字重都走 token，组件里不写死颜色和间距。商品页在服务端渲染，标题、价格、图片和结构化数据直接进 HTML，方便搜索引擎和社交分享抓取。加载、空、错误状态都有对应实现，/style 路由把全部 token 和状态集中在一页，方便快速检查改版效果。

需要提前了解的是，结账是整页跳转到 Sokko 的收银台，本站不接触支付、地址和库存，所以没有服务端密钥，环境变量都是 NEXT_PUBLIC_。价格以肯尼亚先令整数处理，媒体路径是根相对的需要重写，排序参数中只有 newest 是官方公布的，价格排序在本地完成。上线前建议核对 storefront id、站点 URL，并确认是否删除 /style 和主题演示组件。