用途:本页说明 kickstart-next-ssg 项目的框架相关配置,适用于修改路由、构建时数据加载、全局样式或优化图片,以及厘清 App Router 与本仓库 Pages Router 的差异。
主要能力:项目在 pages/ 下使用 Pages Router,包括 pages/index.tsx、pages/_app.tsx、pages/_document.tsx。首页通过 getStaticProps 在构建时调用 @/lib/contentstack 的 getPage("/") 获取 / 页面条目。仅客户端的 Live Preview 逻辑(useEffect、ContentstackLivePreview.onEntryChange)位于同一页面组件中。全局样式表为 pages/globals.css,由 _app.tsx 导入;Tailwind CSS v4 通过 PostCSS 接入,配置文件为 postcss.config.mjs(@tailwindcss/postcss)。图片配置位于 next.config.mjs,包含 images.minimumCacheTTL 及针对 Contentstack 资源的 remotePatterns:images.contentstack.io、*-images.contentstack.com 或 NEXT_PUBLIC_CONTENTSTACK_IMAGE_HOSTNAME。
使用方式:运行时采用 npm run dev、npm run build、npm run start(参见 AGENTS.md)。
限制:仓库中没有 app/ 目录,除非迁移项目,否则不应假定使用 React Server Components 或 App Router 约定。