create-content-sdk-app 2.0.0 → 2.0.2-canary.0

package/dist/templates/nextjs/eslint.config.mjs

@@ -1,81 +1,81 @@
-// packages/create-content-sdk-app/src/templates/nextjs/eslint.config.mjs
-import { defineConfig } from 'eslint/config'
-import js from '@eslint/js'
-import * as nextEslintPlugin from '@next/eslint-plugin-next'
-import tsParser from '@typescript-eslint/parser'
-import * as tsEslintPlugin from '@typescript-eslint/eslint-plugin'
-import * as importEslintPlugin from 'eslint-plugin-import'
-import * as reactHooksEslintPlugin from 'eslint-plugin-react-hooks'
-import globals from 'globals'
-
-// Normalize ESM/CJS shapes to plugin objects
-const nextPlugin = nextEslintPlugin.default ?? nextEslintPlugin
-const tsPlugin = tsEslintPlugin.default ?? tsEslintPlugin
-const importPlugin = importEslintPlugin.default ?? importEslintPlugin
-const reactHooksPlugin = reactHooksEslintPlugin.default ?? reactHooksEslintPlugin
-
-export default defineConfig([
-  // ignores
-  { ignores: ['node_modules/**', '.next/**', 'dist/**', 'build/**', 'coverage/**'] },
-
-  // core ESLint recommended
-  js.configs.recommended,
-
-  // register plugins (applies to all files)
-  {
-    plugins: {
-      '@next/next': nextPlugin,
-      '@typescript-eslint': tsPlugin,
-      import: importPlugin,
-      'react-hooks': reactHooksPlugin,
-    },
-  },
-
-  // project rules
-  {
-    files: ['**/*.{js,jsx,ts,tsx}'],
-    languageOptions: {
-      parser: tsParser,
-      parserOptions: {
-        ecmaVersion: 2021,
-        sourceType: 'module',
-        ecmaFeatures: { jsx: true },
-      },
-      globals: {
-        ...(globals.node ?? {}),
-        ...(globals.browser ?? {}),
-        ...(globals.es2021 ?? {}), // guarded to avoid "Cannot convert undefined or null to object"
-        URL: 'readonly',
-      },
-    },
-    settings: {
-      'import/resolver': { typescript: {} },
-    },
-    rules: {
-      // Next.js
-      ...(nextPlugin.configs?.recommended?.rules ?? {}),
-      ...(nextPlugin.configs?.['core-web-vitals']?.rules ?? {}),
-      '@next/next/no-html-link-for-pages': 'off',
-      '@next/next/no-img-element': 'off',
-      '@next/next/no-sync-scripts': 'off',
-      '@next/next/no-assign-module-variable': 'off',
-
-      // TypeScript
-      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-      'no-unused-vars': 'off',
-      'no-undef': 'off',
-
-      // Plugins
-      'import/no-anonymous-default-export': 'error',
-      'react-hooks/exhaustive-deps': 'warn',
-      'react-hooks/rules-of-hooks': 'error',
-
-      // Preferences
-      'prefer-const': 'error',
-      'no-var': 'error',
-
-      // Temporary: ignore escapes in strings/regex to align with new-starter components
-      'no-useless-escape': 'off',
-    },
-  },
-])
+// packages/create-content-sdk-app/src/templates/nextjs/eslint.config.mjs
+import { defineConfig } from 'eslint/config'
+import js from '@eslint/js'
+import * as nextEslintPlugin from '@next/eslint-plugin-next'
+import tsParser from '@typescript-eslint/parser'
+import * as tsEslintPlugin from '@typescript-eslint/eslint-plugin'
+import * as importEslintPlugin from 'eslint-plugin-import'
+import * as reactHooksEslintPlugin from 'eslint-plugin-react-hooks'
+import globals from 'globals'
+
+// Normalize ESM/CJS shapes to plugin objects
+const nextPlugin = nextEslintPlugin.default ?? nextEslintPlugin
+const tsPlugin = tsEslintPlugin.default ?? tsEslintPlugin
+const importPlugin = importEslintPlugin.default ?? importEslintPlugin
+const reactHooksPlugin = reactHooksEslintPlugin.default ?? reactHooksEslintPlugin
+
+export default defineConfig([
+  // ignores
+  { ignores: ['node_modules/**', '.next/**', 'dist/**', 'build/**', 'coverage/**'] },
+
+  // core ESLint recommended
+  js.configs.recommended,
+
+  // register plugins (applies to all files)
+  {
+    plugins: {
+      '@next/next': nextPlugin,
+      '@typescript-eslint': tsPlugin,
+      import: importPlugin,
+      'react-hooks': reactHooksPlugin,
+    },
+  },
+
+  // project rules
+  {
+    files: ['**/*.{js,jsx,ts,tsx}'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2021,
+        sourceType: 'module',
+        ecmaFeatures: { jsx: true },
+      },
+      globals: {
+        ...(globals.node ?? {}),
+        ...(globals.browser ?? {}),
+        ...(globals.es2021 ?? {}), // guarded to avoid "Cannot convert undefined or null to object"
+        URL: 'readonly',
+      },
+    },
+    settings: {
+      'import/resolver': { typescript: {} },
+    },
+    rules: {
+      // Next.js
+      ...(nextPlugin.configs?.recommended?.rules ?? {}),
+      ...(nextPlugin.configs?.['core-web-vitals']?.rules ?? {}),
+      '@next/next/no-html-link-for-pages': 'off',
+      '@next/next/no-img-element': 'off',
+      '@next/next/no-sync-scripts': 'off',
+      '@next/next/no-assign-module-variable': 'off',
+
+      // TypeScript
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      'no-unused-vars': 'off',
+      'no-undef': 'off',
+
+      // Plugins
+      'import/no-anonymous-default-export': 'error',
+      'react-hooks/exhaustive-deps': 'warn',
+      'react-hooks/rules-of-hooks': 'error',
+
+      // Preferences
+      'prefer-const': 'error',
+      'no-var': 'error',
+
+      // Temporary: ignore escapes in strings/regex to align with new-starter components
+      'no-useless-escape': 'off',
+    },
+  },
+])

package/dist/templates/nextjs/gitignore

@@ -1,28 +1,28 @@
-# See https://help.github.com/ignore-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-
-# next.js
-/.next*/
-/out/
-
-# misc
-.DS_Store
-
-# local env files
-.env.local
-.env.*.local
-.env
-
-# Log files
-*.log*
-
-# vercel
-.vercel
-
-# sitecore temp files
-.sitecore/*
-# except for component-map
-!.sitecore/component-map.ts
-!.sitecore/import-map.ts
+# See https://help.github.com/ignore-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# next.js
+/.next*/
+/out/
+
+# misc
+.DS_Store
+
+# local env files
+.env.local
+.env.*.local
+.env
+
+# Log files
+*.log*
+
+# vercel
+.vercel
+
+# sitecore temp files
+.sitecore/*
+# except for component-map
+!.sitecore/component-map.ts
+!.sitecore/import-map.ts

package/dist/templates/nextjs/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "content-sdk-nextjs",
-  "description": "Application utilizing Content SDK and Next.js",
-  "version": "0.1.0",
-  "private": true,
-  "config": {
-    "appName": "content-sdk-nextjs",
-    "graphQLEndpointPath": "/sitecore/api/graph/edge",
-    "language": "en",
-    "template": "nextjs"
-  },
-  "author": {
-    "name": "Sitecore Corporation",
-    "url": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sitecore/content-sdk.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sitecore/content-sdk/issues"
-  },
-  "license": "Apache-2.0",
-  "dependencies": {
-    "@sitecore-cloudsdk/core": "^0.5.1",
-    "@sitecore-cloudsdk/events": "^0.5.1",
-    "@sitecore-content-sdk/nextjs": "<%- version %>",
-    "@sitecore-feaas/clientside": "^0.6.0",
-    "@sitecore/components": "~2.1.0",
-    "next": "^16.1.1",
-    "next-localization": "^0.12.0",
-    "react": "^19.2.1",
-    "react-dom": "^19.2.1"
-  },
-  "devDependencies": {
-    "@sitecore-content-sdk/cli": "<%- version %>",
-    "@types/node": "^24.10.4",
-    "@types/react": "^19.2.7",
-    "@types/react-dom": "^19.2.3",
-    "@stylistic/eslint-plugin": "^5.2.2",
-    "@typescript-eslint/eslint-plugin": "8.39.0",
-    "@typescript-eslint/parser": "8.39.0",
-    "cross-env": "~7.0.3",
-    "eslint": "^9.32.0",
-    "eslint-config-next": "15.5.3",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jsdoc": "52.0.3",
-    "eslint-plugin-prettier": "^5.5.3",
-    "eslint-plugin-react": "7.37.5",
-    "eslint-plugin-react-hooks": "5.2.0",
-    "npm-run-all2": "~8.0.1",
-    "prettier": "^3.6.2",
-    "typescript": "~5.8.3"
-  },
-  "scripts": {
-    "build": "cross-env NODE_ENV=production npm-run-all --serial sitecore-tools:generate-map sitecore-tools:build next:build",
-    "lint": "eslint ./src/**/*.tsx ./src/**/*.ts",
-    "next:build": "next build",
-    "next:dev": "cross-env NODE_OPTIONS='--inspect' next dev",
-    "next:start": "next start",
-    "sitecore-tools:generate-map": "sitecore-tools project component generate-map",
-    "sitecore-tools:generate-map:watch": "sitecore-tools project component generate-map --watch",
-    "sitecore-tools:build": "sitecore-tools project build",
-    "dev": "cross-env NODE_ENV=development npm-run-all --serial sitecore-tools:generate-map sitecore-tools:build --parallel next:dev sitecore-tools:generate-map:watch",
-    "start": "cross-env-shell NODE_ENV=production npm-run-all --serial build next:start"
-  }
-}
+{
+  "name": "content-sdk-nextjs",
+  "description": "Application utilizing Content SDK and Next.js",
+  "version": "0.1.0",
+  "private": true,
+  "config": {
+    "appName": "content-sdk-nextjs",
+    "graphQLEndpointPath": "/sitecore/api/graph/edge",
+    "language": "en",
+    "template": "nextjs"
+  },
+  "author": {
+    "name": "Sitecore Corporation",
+    "url": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sitecore/content-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sitecore/content-sdk/issues"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@sitecore-content-sdk/nextjs": "<%- version %>",
+    "@sitecore-content-sdk/analytics-core": "<%- version %>",
+    "@sitecore-content-sdk/events": "<%- version %>",
+    "@sitecore-feaas/clientside": "^0.6.0",
+    "@sitecore/components": "~2.1.0",
+    "next": "^16.1.1",
+    "next-localization": "^0.12.0",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1"
+  },
+  "devDependencies": {
+    "@sitecore-content-sdk/cli": "<%- version %>",
+    "@types/node": "^24.10.4",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@stylistic/eslint-plugin": "^5.2.2",
+    "@typescript-eslint/eslint-plugin": "8.39.0",
+    "@typescript-eslint/parser": "8.39.0",
+    "cross-env": "~7.0.3",
+    "eslint": "^9.32.0",
+    "eslint-config-next": "15.5.3",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-jsdoc": "52.0.3",
+    "eslint-plugin-prettier": "^5.5.3",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "5.2.0",
+    "npm-run-all2": "~8.0.1",
+    "prettier": "^3.6.2",
+    "typescript": "~5.8.3"
+  },
+  "scripts": {
+    "build": "cross-env NODE_ENV=production npm-run-all --serial sitecore-tools:generate-map sitecore-tools:build next:build",
+    "lint": "eslint ./src/**/*.tsx ./src/**/*.ts",
+    "next:build": "next build",
+    "next:dev": "cross-env NODE_OPTIONS='--inspect' next dev",
+    "next:start": "next start",
+    "sitecore-tools:generate-map": "sitecore-tools project component generate-map",
+    "sitecore-tools:generate-map:watch": "sitecore-tools project component generate-map --watch",
+    "sitecore-tools:build": "sitecore-tools project build",
+    "dev": "cross-env NODE_ENV=development npm-run-all --serial sitecore-tools:generate-map sitecore-tools:build --parallel next:dev sitecore-tools:generate-map:watch",
+    "start": "cross-env-shell NODE_ENV=production npm-run-all --serial build next:start"
+  }
+}

package/dist/templates/nextjs/sitecore.config.ts.example

@@ -1,40 +1,40 @@
-import { defineConfig } from '@sitecore-content-sdk/nextjs/config';
-/**
- * @type {import('@sitecore-content-sdk/nextjs/config').SitecoreConfig}
- * See the documentation for `defineConfig`:
- * https://doc.sitecore.com/xmc/en/developers/content-sdk/the-sitecore-configuration-file.html
- */
-export default defineConfig({
-  api: {
-    edge: {
-      contextId:
-        process.env.SITECORE_EDGE_CONTEXT_ID ||
-        process.env.NEXT_PUBLIC_SITECORE_EDGE_CONTEXT_ID ||
-        '',
-      clientContextId: process.env.NEXT_PUBLIC_SITECORE_EDGE_CONTEXT_ID,
-      edgeUrl:
-        process.env.NEXT_PUBLIC_SITECORE_EDGE_PLATFORM_HOSTNAME ||
-        process.env.SITECORE_EDGE_PLATFORM_HOSTNAME,
-    },
-    local: {
-      apiKey: process.env.NEXT_PUBLIC_SITECORE_API_KEY || '',
-      apiHost: process.env.NEXT_PUBLIC_SITECORE_API_HOST || '',
-    },
-  },
-  defaultSite: process.env.NEXT_PUBLIC_DEFAULT_SITE_NAME,
-  defaultLanguage: process.env.NEXT_PUBLIC_DEFAULT_LANGUAGE || 'en',
-  editingSecret: process.env.SITECORE_EDITING_SECRET,
-  redirects: {
-    enabled: true,
-    locales: ['en'],
-  },
-  multisite: {
-    enabled: true,
-    useCookieResolution: () => process.env.VERCEL_ENV === 'preview',
-  },
-  personalize: {
-    scope: process.env.NEXT_PUBLIC_PERSONALIZE_SCOPE,
-    edgeTimeout: parseInt(process.env.PERSONALIZE_PROXY_EDGE_TIMEOUT!, 10),
-    cdpTimeout: parseInt(process.env.PERSONALIZE_PROXY_EDGE_TIMEOUT!, 10),
-  },
-});
+import { defineConfig } from '@sitecore-content-sdk/nextjs/config';
+/**
+ * @type {import('@sitecore-content-sdk/nextjs/config').SitecoreConfig}
+ * See the documentation for `defineConfig`:
+ * https://doc.sitecore.com/xmc/en/developers/content-sdk/the-sitecore-configuration-file.html
+ */
+export default defineConfig({
+  api: {
+    edge: {
+      contextId:
+        process.env.SITECORE_EDGE_CONTEXT_ID ||
+        process.env.NEXT_PUBLIC_SITECORE_EDGE_CONTEXT_ID ||
+        '',
+      clientContextId: process.env.NEXT_PUBLIC_SITECORE_EDGE_CONTEXT_ID,
+      edgeUrl:
+        process.env.NEXT_PUBLIC_SITECORE_EDGE_PLATFORM_HOSTNAME ||
+        process.env.SITECORE_EDGE_PLATFORM_HOSTNAME,
+    },
+    local: {
+      apiKey: process.env.NEXT_PUBLIC_SITECORE_API_KEY || '',
+      apiHost: process.env.NEXT_PUBLIC_SITECORE_API_HOST || '',
+    },
+  },
+  defaultSite: process.env.NEXT_PUBLIC_DEFAULT_SITE_NAME,
+  defaultLanguage: process.env.NEXT_PUBLIC_DEFAULT_LANGUAGE || 'en',
+  editingSecret: process.env.SITECORE_EDITING_SECRET,
+  redirects: {
+    enabled: true,
+    locales: ['en'],
+  },
+  multisite: {
+    enabled: true,
+    useCookieResolution: () => process.env.VERCEL_ENV === 'preview',
+  },
+  personalize: {
+    scope: process.env.NEXT_PUBLIC_PERSONALIZE_SCOPE,
+    edgeTimeout: parseInt(process.env.PERSONALIZE_PROXY_EDGE_TIMEOUT!, 10),
+    cdpTimeout: parseInt(process.env.PERSONALIZE_PROXY_EDGE_TIMEOUT!, 10),
+  },
+});

package/dist/templates/nextjs/src/Bootstrap.tsx

@@ -1,8 +1,8 @@
 import { useEffect, JSX } from 'react';
-import { CloudSDK } from '@sitecore-cloudsdk/core/browser';
-import { SitecorePageProps } from '@sitecore-content-sdk/nextjs';
-import '@sitecore-cloudsdk/events/browser';
+import { SitecorePageProps, initContentSdk } from '@sitecore-content-sdk/nextjs';
 import config from 'sitecore.config';
+import { eventsPlugin } from '@sitecore-content-sdk/events';
+import { analyticsBrowserAdapter, analyticsPlugin } from '@sitecore-content-sdk/analytics-core';
 
 /**
  * The Bootstrap component is the entry point for performing any initialization logic
@@ -26,16 +26,23 @@ const Bootstrap = (props: SitecorePageProps): JSX.Element | null => {
       console.debug('Browser Events SDK is not initialized in edit and preview modes');
     } else {
       if (config.api.edge?.clientContextId) {
-        CloudSDK({
-          sitecoreEdgeUrl: config.api.edge.edgeUrl,
-          sitecoreEdgeContextId: config.api.edge.clientContextId,
-          siteName: page.siteName || config.defaultSite,
-          enableBrowserCookie: true,
-          // Replace with the top level cookie domain of the website that is being integrated e.g ".example.com" and not "www.example.com"
-          cookieDomain: window.location.hostname.replace(/^www\./, ''),
-        })
-          .addEvents()
-          .initialize();
+        initContentSdk({
+          config: {
+            contextId: config.api.edge.clientContextId,
+            edgeUrl: config.api.edge.edgeUrl,
+            siteName: page.siteName || config.defaultSite,
+          },
+          plugins: [
+            analyticsPlugin({
+              options: {
+                enableCookie: true,
+                cookieDomain: window.location.hostname.replace(/^www\./, ''),
+              },
+              adapter: analyticsBrowserAdapter(),
+            }),
+            eventsPlugin(),
+          ],
+        });
       } else {
         console.error('Client Edge API settings missing from configuration');
       }

package/dist/templates/nextjs/src/byoc/index.tsx

@@ -1,6 +1,6 @@
 import React, { JSX } from 'react';
 import * as FEAAS from '@sitecore-feaas/clientside/react';
-import * as Events from '@sitecore-cloudsdk/events/browser';
+import * as Events from '@sitecore-content-sdk/events';
 import { LayoutServicePageState, SitecoreProviderReactContext } from '@sitecore-content-sdk/nextjs';
 import '@sitecore/components/context';
 import dynamic from 'next/dynamic';

package/dist/templates/nextjs/src/components/content-sdk/CdpPageView.tsx

@@ -1,6 +1,6 @@
 import { CdpHelper, useSitecore } from '@sitecore-content-sdk/nextjs';
 import { useEffect, JSX } from 'react';
-import { pageView } from '@sitecore-cloudsdk/events/browser';
+import { pageView } from '@sitecore-content-sdk/events';
 import config from 'sitecore.config';
 
 /**

package/dist/templates/nextjs/tsconfig.json

@@ -1,40 +1,40 @@
-{
-  "compilerOptions": {
-    "baseUrl": ".",
-    "paths": {
-      "components/*": ["src/components/*"],
-      "lib/*": ["src/lib/*"],
-      "temp/*": ["src/temp/*"],
-      "assets/*": ["src/assets/*"],
-      <%_ if (helper.isDev) { _%>
-      "react": ["node_modules/react"],
-      "next/*": ["node_modules/next/*"],
-      <%_ } _%>
-    },
-    "target": "es5",
-    "types": ["node"],
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "strictFunctionTypes": false,
-    "downlevelIteration": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "node",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "preserve",
-    "allowSyntheticDefaultImports": true,
-    "noImplicitReturns": true,
-    "noImplicitAny": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "incremental": true,
-    "forceConsistentCasingInFileNames": false
-  },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
-  "exclude": ["node_modules"]
-}
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "components/*": ["src/components/*"],
+      "lib/*": ["src/lib/*"],
+      "temp/*": ["src/temp/*"],
+      "assets/*": ["src/assets/*"],
+      <%_ if (helper.isDev) { _%>
+      "react": ["node_modules/react"],
+      "next/*": ["node_modules/next/*"],
+      <%_ } _%>
+    },
+    "target": "es5",
+    "types": ["node"],
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "strictFunctionTypes": false,
+    "downlevelIteration": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "allowSyntheticDefaultImports": true,
+    "noImplicitReturns": true,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "incremental": true,
+    "forceConsistentCasingInFileNames": false
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/dist/templates/nextjs-app-router/.agents/skills/content-sdk-component-data-strategy/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: content-sdk-component-data-strategy
+description: Component data for App Router: layout data from getPage (or getPreview/getDesignLibraryData in editing). No getComponentData; pass site and locale from route params. Server Components use the client in server context; Client Components receive serializable props. Use when wiring component data or BYOC.
+---
+
+# Content SDK Component Data Strategy (App Router)
+
+This app does **not** use getComponentData. Page and layout data come from **getPage** (or getPreview/getDesignLibraryData in editing). Component props are derived from the layout/placeholders; pass site and locale from route params.
+
+## When to Use
+
+- User asks how to pass data to components, wire component props, or integrate custom/BYOC components.
+- Task involves component props, server vs client components, or BYOC.
+- User mentions "component data," "props," "BYOC," "server component," or "client component."
+
+## How to perform
+
+- Fetch at page/layout with getPage (or getPreview/getDesignLibraryData in draft). Pass site and locale from route params. Server Components use the client in server context; Client Components receive serializable props only. Register BYOC in the correct component map and pass props from layout.
+
+## Hard Rules
+
+- **Data source:** Page and layout from `client.getPage(path ?? [], { site, locale })` in the catch-all page (or getPreview/getDesignLibraryData when draftMode() is enabled). All Sitecore-driven data flows from this single fetch at the route level.
+- **Server Components:** Use the same SitecoreClient in server context (e.g. in the page or layout). Pass data as props to children.
+- **Client Components:** Receive **serializable** props from parent (no functions or non-serializable values). Do not create a new client inside components. Pass data from page/layout level into components.
+- **BYOC or custom components:** Must be registered in the appropriate component map (.sitecore/component-map.ts or component-map.client.ts) and receive props in the shape the layout expects (e.g. fields, params).
+- Do not fetch layout or page data inside a child component (e.g. another getPage call); fetch at page/layout level and pass props.
+
+## Stop Conditions
+
+- Stop if the user wants to fetch page/layout data inside a child component; recommend fetching at page/layout level and passing props.
+- Stop if server/client boundary is ambiguous and the change could cause "use client" or serialization issues; clarify and follow Next.js and app conventions.
+- Do not introduce getComponentData or duplicate getPage logic; this app uses getPage-only data flow.
+
+## References
+
+- content-sdk-graphql-data-fetching and [AGENTS.md](../../../AGENTS.md) for getPage and data flow.
+- [Official Content SDK docs](https://doc.sitecore.com/xmc/en/developers/content-sdk/sitecore-content-sdk-for-xm-cloud.html).