ZShip
返回文档首页

web-nuxt 模板概览

说明 web-nuxt 当前已经具备什么，以及主要改动入口在哪里。

正文
下一篇

web-nuxt 是 ZShip 里的 Nuxt 4 前台方案，把 landing、pricing、auth、blog、docs 和 dashboard 放在同一个部署里。

当前已内置的能力

  • Nuxt SSR + Nitro BFF，server/api/* 已代理常见后端请求
  • 已接好 i18n、sitemap、robots、schema.org、ISR 路由规则和图片优化
  • 已有 landing UI、认证页、仪表盘页，以及多语言导航

主要改动入口

  • apps/web-nuxt/zship.app.json 负责 appKey、域名、品牌信息、analytics ID、dashboard.url 与 dashboard.features.*
  • apps/web-nuxt/app/config/site.ts 把 manifest 转成运行时 siteConfig
  • apps/web-nuxt/content/docs/* 是站内 Docs 的 Nuxt Content 内容源
  • apps/web-nuxt/server/api/* 用于扩展服务端代理路由

用 skills 做 prompt 驱动改造

如果你希望通过自然语言 + vibe coding 的方式直接改 web-nuxt，先看 Skills 与 vibe coding。这页会说明什么时候该直接改模板，什么时候应该先复制出独立 app，再继续定制。

如果某个仪表盘功能不想对外暴露，可以把 dashboard.features.checkin、dashboard.features.tickets 或 dashboard.features.referral 设为 false，对应入口会隐藏，直接访问路由也会被拦住。

什么时候适合选它

如果你的团队希望用一个 Nuxt 工程同时承载营销页、产品页和服务端代理，同时保留清晰的配置入口，把模板改造成自己的品牌前台，web-nuxt 很合适。