create-content-sdk-app 2.4.1 → 2.4.2

package/dist/templates/angular/.agents/docs/AGENTS-angular-specifics.md

@@ -35,16 +35,17 @@ Optional, on-demand detail. The compact guide is [AGENTS.md](../../AGENTS.md).
 2. `createSitecoreRevalidateMiddleware({ cache, defaultLocale, sites })` — `POST /api/revalidate`
 3. `createSitemapMiddleware({ client, sites })` — `/sitemap.xml`, `/sitemap-:id.xml`
 4. `createRobotsMiddleware({ client, sites })` — `/robots.txt`
-5. `createEditingConfigMiddleware({ components, metadataImport })` — `/api/editing/config`
-6. `createExperimentalFeaturesMiddleware()` — `/api/editing/experimental`
-7. `createEditingRenderMiddleware()` — `/api/editing/render`
-8. `createMultisiteMiddleware(...)` — resolves the site onto `req.scParams`
-9. `createBotTrackingMiddleware(...)` — sets the `sc_bot` cookie **before** personalize decides to skip
-10. `createRedirectsMiddleware(...)` — short-circuits before any CDP call
-11. `createPersonalizeMiddleware(...)` — reads the site resolved in step 8
-12. `createLoaderDataServiceMiddleware(config, { loaders: LOADERS, cache })` — `POST /_data`
-13. `express.static(browserDistFolder, ...)`
-14. `angularApp.handle(req, { cache: loaderCache, req, res })` — SSR
+5. `createLlmsTxtMiddleware({ client, sites })` — `/llms.txt`
+6. `createEditingConfigMiddleware({ components, metadataImport })` — `/api/editing/config`
+7. `createExperimentalFeaturesMiddleware()` — `/api/editing/experimental`
+8. `createEditingRenderMiddleware()` — `/api/editing/render`
+9. `createMultisiteMiddleware(...)` — resolves the site onto `req.scParams`
+10. `createBotTrackingMiddleware(...)` — sets the `sc_bot` cookie **before** personalize decides to skip
+11. `createRedirectsMiddleware(...)` — short-circuits before any CDP call
+12. `createPersonalizeMiddleware(...)` — reads the site resolved in step 9
+13. `createLoaderDataServiceMiddleware(config, { loaders: LOADERS, cache })` — `POST /_data`
+14. `express.static(browserDistFolder, ...)`
+15. `angularApp.handle(req, { cache: loaderCache, req, res })` — SSR
 
 Why it matters: multisite must precede personalize (personalize reads the resolved site); bot tracking must precede personalize (the cookie gates the skip); redirects must precede personalize (avoid a wasted CDP call); editing endpoints must precede static and SSR; `/_data` must precede the SSR catch-all handler.
 
@@ -118,6 +119,15 @@ Angular has no framework ISR. This app caches **loader results** instead:
 - **`angular.json`** — `@angular/build:application` builder, `outputMode: "server"`, SSR entry `src/server.ts`, environment `fileReplacements` per configuration, and `allowedCommonJsDependencies`. Lint covers `src/**/*.ts`, `src/**/*.html` and `sitecore.config.ts`.
 - **`tsconfig.json`** — path aliases `client/*`, `components/*`, `lib/*`, `.sitecore/*`; includes `sitecore.config.ts`, `sitecore.cli.config.ts` and `.sitecore/**/*.ts`.
 
+## Page metadata and structured data
+
+`src/app/shared/layout.component.ts` renders two SDK components that write to `<head>` and render no DOM of their own:
+
+- `<sc-page-meta-tags [route]="scRoute()" />` — `<title>` (from the route `Title` field, falling back to `'Page'`) plus metadata and Open Graph `<meta>` tags from the route's `baseMetadata*` / `baseOg*` fields (`RouteFields extends PageMetadataFields`). A field with no value omits only its own tag; tags left from the previous route are removed on navigation.
+- `<sc-json-ld-schema [page]="page()" />` — one `<script type="application/ld+json">` with the Layout Service's `sitecore.context.schemas`. Rendered only in normal mode (not in editing or preview).
+
+Both work during SSR and on client-side navigation and clean up when destroyed. For metadata outside a component template, inject `PageMetadataService` / `JsonLdSchemaService` and call `apply(...)` directly. Do not set `<title>` or these `<meta>` tags manually elsewhere — the services own them.
+
 ## Differences from the Next.js templates
 
 Useful when porting guidance or code from a Next.js head app:
@@ -132,3 +142,4 @@ Useful when porting guidance or code from a Next.js head app:
 | Component map | `SITECORE_COMPONENT_MAP` injection token | Props / `SitecoreProvider` |
 | Field rendering | Structural directives (`*scText`) | Components (`<Text>`) |
 | Locale | URL segment + `scLocaleMatcher` | `context.locale` from Next.js i18n |
+| Page metadata / JSON-LD | `<sc-page-meta-tags>` / `<sc-json-ld-schema>` (Angular `Meta` / `Title` services) | `generateMetadata` + `getPageMetadata` or `<PageMetaTags>`; `<JsonLdSchema>` |

package/dist/templates/angular/.agents/docs/AGENTS-key-concepts.md

@@ -6,7 +6,7 @@ Optional, on-demand detail. The compact guide is [AGENTS.md](../../AGENTS.md).
 
 - **Where:** `src/content-sdk/client/sitecore-client.ts` exports `getClient()` — a **lazy singleton** that constructs `new SitecoreClient(scConfig)` on first use. It is lazy on purpose: build-time route extraction runs without credentials, and eager construction would throw.
 - **Use for:** `getPage`, `getDictionary`, `getPreview`, `getErrorPage`, `getPagePaths`, `getSiteMap`, `getHeadLinks`.
-- **Consumed by:** loaders (`getClient()` directly), `provideSitecoreAngular({ sitecoreClient: getClient() })` in `app.config.ts`, and the Express middleware in `server.ts` (sitemap, robots).
+- **Consumed by:** loaders (`getClient()` directly), `provideSitecoreAngular({ sitecoreClient: getClient() })` in `app.config.ts`, and the Express middleware in `server.ts` (sitemap, robots, llms.txt).
 - **In components:** inject `SITECORE_CLIENT_TOKEN` (as `LayoutComponent` does for `getHeadLinks`). Do **not** call `new SitecoreClient(...)` anywhere else.
 
 ## Loaders

package/dist/templates/angular/.agents/docs/AGENTS-overview.md

@@ -1,6 +1,6 @@
 # Project overview (Angular)
 
-This is a **Sitecore Content SDK** application built with **Angular** (standalone components, signals, Angular SSR) and **TypeScript**. AI agents work as developer assistants within this scaffolded head application. The app integrates with Sitecore AI / XM Cloud for content, supports i18n, multisite, personalization and analytics, and serves SSR through an Express server that also hosts the Content SDK middleware (sitemap, robots, editing, redirects, revalidation, loader data).
+This is a **Sitecore Content SDK** application built with **Angular** (standalone components, signals, Angular SSR) and **TypeScript**. AI agents work as developer assistants within this scaffolded head application. The app integrates with Sitecore AI / XM Cloud for content, supports i18n, multisite, personalization and analytics, and serves SSR through an Express server that also hosts the Content SDK middleware (sitemap, robots, llms.txt, editing, redirects, revalidation, loader data).
 
 **Scope:** This file applies to **this application only** (a scaffolded head app). It is **not** the Content SDK monorepo — for SDK package development use that repo's `AGENTS.md`. Here we edit app code and config (`src/app/`, `src/content-sdk/`, `src/server.ts`, `sitecore.config.ts`); we do not modify SDK packages or CI.
 

package/dist/templates/angular/.agents/skills/content-sdk-sitemap-robots/SKILL.md

@@ -1,20 +1,21 @@
 ---
 name: content-sdk-sitemap-robots
-description: Sitemap and robots Express middleware in src/server.ts with sites from .sitecore/sites.json.
+description: Sitemap, robots and llms.txt Express middleware in src/server.ts with sites from .sitecore/sites.json.
 ---
 
-# Sitemap and robots (Angular)
+# Sitemap, robots and llms.txt (Angular)
 
 **Detail:** [AGENTS-angular-specifics.md#express-server-and-middleware-order](../../docs/AGENTS-angular-specifics.md#express-server-and-middleware-order)
 **Read first:** `src/server.ts`
 
 ## When
 
-- Sitemap, robots.txt, or other SEO / well-known file handlers
+- Sitemap, robots.txt, llms.txt, or other SEO / well-known file handlers
 
 ## Rules
 
-- Use `createSitemapMiddleware({ client: getClient(), sites })` mounted at `/sitemap.xml` and `/sitemap-:id.xml`, and `createRobotsMiddleware({ client: getClient(), sites })` at `/robots.txt`
+- Use `createSitemapMiddleware({ client: getClient(), sites })` mounted at `/sitemap.xml` and `/sitemap-:id.xml`, `createRobotsMiddleware({ client: getClient(), sites })` at `/robots.txt`, and `createLlmsTxtMiddleware({ client: getClient(), sites })` at `/llms.txt`
+- llms.txt content is managed via SitecoreAI configuration; Content SDK only consumes/serves it. A site without llms.txt content gets a `404` with a minimal default llms.txt
 - `sites` comes from `.sitecore/sites.json` — never hardcode the site list
 - Register these before `express.static` and the SSR handler
 - These are plain Express routes; there is no rewrite layer to keep in sync (unlike the Next.js templates)

package/dist/templates/angular/.agents/skills/content-sdk-ssr-express-middleware/SKILL.md

@@ -16,7 +16,7 @@ description: Express middleware chain in src/server.ts; fixed order and the serv
 
 ## Rules
 
-- Order is fixed: `express.json()` → revalidate → sitemap → robots → editing (config, experimental, render) → multisite → bot tracking → redirects → personalize → `/_data` loader middleware → static → `angularApp.handle`
+- Order is fixed: `express.json()` → revalidate → sitemap → robots → llms.txt → editing (config, experimental, render) → multisite → bot tracking → redirects → personalize → `/_data` loader middleware → static → `angularApp.handle`
 - Multisite before personalize; bot tracking before personalize; redirects before personalize; editing before static and SSR; `/_data` before the SSR handler
 - New endpoints register before `express.static`; add app-specific exemptions to `middlewareMatcher.excludePaths`
 - Pass the **same** `loaderCache` instance to the revalidate middleware, the `/_data` middleware, and `angularApp.handle(req, { cache, req, res })`

package/dist/templates/angular/Skills.md

@@ -20,7 +20,7 @@ Angular head app: catch-all route behind `scLocaleMatcher`, Sitecore data throug
 | [content-sdk-multisite-management](.agents/skills/content-sdk-multisite-management/SKILL.md) | Site resolution and `.sitecore/sites.json` |
 | [content-sdk-personalization-and-analytics](.agents/skills/content-sdk-personalization-and-analytics/SKILL.md) | Variants, CDP, analytics events, bot tracking |
 | [content-sdk-site-setup-and-env](.agents/skills/content-sdk-site-setup-and-env/SKILL.md) | `sitecore.config.ts` and the `CSDK_PUBLIC_*` env split |
-| [content-sdk-sitemap-robots](.agents/skills/content-sdk-sitemap-robots/SKILL.md) | Sitemap and robots middleware |
+| [content-sdk-sitemap-robots](.agents/skills/content-sdk-sitemap-robots/SKILL.md) | Sitemap, robots and llms.txt middleware |
 | [content-sdk-upgrade-assistant](.agents/skills/content-sdk-upgrade-assistant/SKILL.md) | Upgrading SDK or Angular packages |
 
 Do **not** load every skill at session start. Open [AGENTS.md](AGENTS.md) first; add one skill when the task matches a row above.

package/dist/templates/angular/src/app/shared/layout.component.ts

@@ -1,23 +1,27 @@
 import { Component, PLATFORM_ID, Renderer2, input, computed, effect, inject } from '@angular/core';
-import { Title } from '@angular/platform-browser';
 import { DOCUMENT, isPlatformBrowser } from '@angular/common';
 import {
   Page,
   Field,
+  PageMetadataFields,
   RouteData,
+  ScJsonLdSchemaComponent,
+  ScPageMetaTagsComponent,
   ScPlaceholderComponent,
   SITECORE_CLIENT_TOKEN,
 } from '@sitecore-content-sdk/angular';
 
-interface RouteFields {
+export interface RouteFields extends PageMetadataFields {
   [key: string]: unknown;
   Title?: Field<string>;
 }
 
 @Component({
   selector: 'app-layout',
-  imports: [ScPlaceholderComponent],
+  imports: [ScPlaceholderComponent, ScPageMetaTagsComponent, ScJsonLdSchemaComponent],
   template: `
+      <sc-page-meta-tags [route]="scRoute()" />
+      <sc-json-ld-schema [page]="page()" />
       <div [attr.class]="layoutClassAttr()">
         <header class="w-full">
           <div id="header">
@@ -51,7 +55,9 @@ interface RouteFields {
 export class LayoutComponent {
   readonly page = input.required<Page>();
 
-  readonly scRoute = computed(() => this.page().layout?.sitecore?.route as RouteData | null);
+  readonly scRoute = computed(
+    () => this.page().layout?.sitecore?.route as RouteData<RouteFields> | null
+  );
 
   readonly layoutClassAttr = computed(() => {
     const editing = this.page().mode?.isEditing;
@@ -59,22 +65,12 @@ export class LayoutComponent {
     return editing ? `${base} editing-mode` : `${base} prod-mode`;
   });
 
-  private readonly titleService = inject(Title);
   private readonly sitecoreClient = inject(SITECORE_CLIENT_TOKEN, { optional: true });
   private readonly document = inject(DOCUMENT);
   private readonly renderer = inject(Renderer2);
   private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
 
   constructor() {
-    effect(() => {
-      const route = this.scRoute();
-      if (route) {
-        const fields = route.fields as RouteFields | undefined;
-        const title = fields?.Title?.value ?? 'Content SDK Page';
-        this.titleService.setTitle(title);
-      }
-    });
-
     effect(() => {
       if (this.isBrowser || !this.sitecoreClient) return;
       const layout = this.page().layout;

package/dist/templates/angular/src/server.ts

@@ -16,6 +16,7 @@ import {
   createLoaderCache,
   createLoaderDataServiceMiddleware,
   createRobotsMiddleware,
+  createLlmsTxtMiddleware,
   createMultisiteMiddleware,
   createPersonalizeMiddleware,
   createRedirectsMiddleware,
@@ -81,6 +82,15 @@ app.use(
   })
 );
 
+/** llms.txt at `/llms.txt` */
+app.use(
+  '/llms.txt',
+  createLlmsTxtMiddleware({
+    client: getClient(),
+    sites,
+  })
+);
+
 /**
  * Editing config endpoint (`/api/editing/config`). Replies with the registered
  * component map keys and `editMode: 'metadata'` so Sitecore Pages can negotiate

package/dist/templates/nextjs/next.config.js

@@ -13,6 +13,18 @@ const nextConfig = {
     turbopackFileSystemCacheForDev: true,
   },
 
+  turbopack: {
+    rules: {
+      // Strip out getComponentServerProps from components in the client bundle
+      '*.tsx': {
+        condition: {
+          all: ['browser', { not: 'foreign' }, { path: /(^|\/)src\/components\// }],
+        },
+        loaders: ['@sitecore-content-sdk/nextjs/component-props-loader'],
+      },
+    },
+  },
+
   i18n: {
     // These are all the locales you want to support in your application.
     // These should generally match (or at least be a subset of) those in Sitecore.
@@ -80,8 +92,8 @@ const nextConfig = {
     if (!options.isServer) {
       // Add a loader to strip out getComponentServerProps from components in the client bundle
       config.module.rules.unshift({
-        test: /src\\components\\.*\.tsx$/,
-        use: ['@sitecore-content-sdk\\nextjs\\component-props-loader'],
+        test: /[\\/]src[\\/]components[\\/].*\.tsx$/,
+        use: ['@sitecore-content-sdk/nextjs/component-props-loader'],
       });
     } else {
       // Force use of CommonJS on the server for FEAAS SDK since Content SDK also uses CommonJS entrypoint to FEAAS SDK.

package/dist/templates/nextjs/package.json

@@ -17,6 +17,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@sitecore-content-sdk/analytics-core": "<%- versions['@sitecore-content-sdk/analytics-core'] %>",
+    "@sitecore-content-sdk/personalize": "<%- versions['@sitecore-content-sdk/personalize'] %>",
     "@sitecore-content-sdk/events": "<%- versions['@sitecore-content-sdk/events'] %>",
     "@sitecore-content-sdk/nextjs": "<%- versions['@sitecore-content-sdk/nextjs'] %>",
     "@sitecore-feaas/clientside": "^0.6.0",

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

@@ -3,9 +3,8 @@
  */
 import { JSX } from 'react';
 import Head from 'next/head';
-import { Placeholder, DesignLibrary, Page, PageMetaTags } from '@sitecore-content-sdk/nextjs';
-import Scripts from 'src/Scripts';
-import SitecoreStyles from 'src/components/content-sdk/SitecoreStyles';
+import { Placeholder, DesignLibrary, Page } from '@sitecore-content-sdk/nextjs';
+import SitecoreHead from 'src/SitecoreHead';
 
 interface LayoutProps {
   page: Page;
@@ -18,9 +17,7 @@ const Layout = ({ page }: LayoutProps): JSX.Element => {
 
   return (
     <>
-      <Scripts />
-      <SitecoreStyles layoutData={layout} />
-      <PageMetaTags route={route} />
+      <SitecoreHead page={page} />
       <Head>
         <link rel="icon" href="/favicon.ico" />
       </Head>

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

@@ -0,0 +1,28 @@
+import { JSX } from 'react';
+import { Page, PageMetaTags, JsonLdSchema } from '@sitecore-content-sdk/nextjs';
+import Scripts from 'src/Scripts';
+import SitecoreStyles from 'src/components/content-sdk/SitecoreStyles';
+
+interface SitecoreHeadProps {
+  page: Page;
+}
+
+/**
+ * Groups the scripts, styles, meta tags, and structured data injected alongside the page layout.
+ */
+const SitecoreHead = ({ page }: SitecoreHeadProps): JSX.Element => {
+  const { layout } = page;
+  const { route } = layout.sitecore;
+
+  return (
+    <>
+      <Scripts />
+      <SitecoreStyles layoutData={layout} />
+      <PageMetaTags route={route} />
+      <JsonLdSchema page={page} />
+    </>
+  );
+};
+
+export default SitecoreHead;
+

package/dist/templates/nextjs/src/proxy.ts

@@ -89,7 +89,10 @@ export const config = {
    * 3. /sitecore/api (Sitecore API routes)
    * 4. /- (Sitecore media)
    * 5. /healthz (Health check)
-   * 7. all root files inside /public
+   * 6. static files inside /public (images, fonts, css, js, etc.)
    */
-  matcher: ['/', '/((?!api/|_next/|healthz|sitecore/api/|-/|favicon.ico|sc_logo.svg).*)'],
+  matcher: [
+    '/',
+    '/((?!api/|_next/|healthz|sitecore/api/|-/|.*[.](?:svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|otf|eot|css|js|map|webmanifest)$).*)',
+  ],
 };

package/dist/templates/nextjs-app-router/src/Layout.tsx

@@ -1,7 +1,12 @@
 import { JSX } from 'react';
-import { AppPlaceholder, DesignLibraryApp, Field, PageMetadataFields, Page } from '@sitecore-content-sdk/nextjs';
-import Scripts from 'src/Scripts';
-import SitecoreStyles from 'components/content-sdk/SitecoreStyles';
+import {
+  AppPlaceholder,
+  DesignLibraryApp,
+  Field,
+  PageMetadataFields,
+  Page,
+} from '@sitecore-content-sdk/nextjs';
+import SitecoreHead from 'src/SitecoreHead';
 import componentMap from '.sitecore/component-map';
 
 interface LayoutProps {
@@ -19,8 +24,7 @@ const Layout = ({ page }: LayoutProps): JSX.Element => {
   const mainClassPageEditing = mode.isEditing ? 'editing-mode' : 'prod-mode';
   return (
     <>
-      <Scripts />
-      <SitecoreStyles layoutData={layout} />
+      <SitecoreHead page={page} />
       {/* root placeholder for the app, which we add components to using route data */}
       <div className={mainClassPageEditing}>
         {mode.isDesignLibrary ? (

package/dist/templates/nextjs-app-router/src/SitecoreHead.tsx

@@ -0,0 +1,26 @@
+import { JSX } from 'react';
+import { Page, JsonLdSchema } from '@sitecore-content-sdk/nextjs';
+import Scripts from 'src/Scripts';
+import SitecoreStyles from 'components/content-sdk/SitecoreStyles';
+
+interface SitecoreHeadProps {
+  page: Page;
+}
+
+/**
+ * Groups the scripts, styles, and structured data injected alongside the page layout.
+ */
+const SitecoreHead = ({ page }: SitecoreHeadProps): JSX.Element => {
+  const { layout } = page;
+
+  return (
+    <>
+      <Scripts />
+      <SitecoreStyles layoutData={layout} />
+      <JsonLdSchema page={page} />
+    </>
+  );
+};
+
+export default SitecoreHead;
+

package/dist/templates/nextjs-app-router/src/proxy.ts

@@ -113,10 +113,10 @@ export const config = {
    * 3. /sitecore/api (Sitecore API routes)
    * 4. /- (Sitecore media)
    * 5. /healthz (Health check)
-   * 7. all root files inside /public
+   * 6. static files inside /public (images, fonts, css, js, etc.)
    */
   matcher: [
     '/',
-    '/((?!api/|sitemap|robots|_next/|healthz|sitecore/api/|-/|favicon.ico|sc_logo.svg).*)',
+    '/((?!api/|sitemap|robots|_next/|healthz|sitecore/api/|-/|.*[.](?:svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|otf|eot|css|js|map|webmanifest)$).*)',
   ],
 };

package/dist/templates/nextjs-app-router-cache-components/src/Layout.tsx

@@ -1,7 +1,12 @@
 import { JSX } from 'react';
-import { AppPlaceholder, DesignLibraryApp, Field, PageMetadataFields, Page } from '@sitecore-content-sdk/nextjs';
-import Scripts from 'src/Scripts';
-import SitecoreStyles from 'components/content-sdk/SitecoreStyles';
+import {
+  AppPlaceholder,
+  DesignLibraryApp,
+  Field,
+  PageMetadataFields,
+  Page,
+} from '@sitecore-content-sdk/nextjs';
+import SitecoreHead from 'src/SitecoreHead';
 import componentMap from '.sitecore/component-map';
 
 interface LayoutProps {
@@ -19,8 +24,7 @@ const Layout = ({ page }: LayoutProps): JSX.Element => {
   const mainClassPageEditing = mode.isEditing ? 'editing-mode' : 'prod-mode';
   return (
     <>
-      <Scripts />
-      <SitecoreStyles layoutData={layout} />
+      <SitecoreHead page={page} />
       {/* root placeholder for the app, which we add components to using route data */}
       <div className={mainClassPageEditing}>
         {mode.isDesignLibrary ? (

package/dist/templates/nextjs-app-router-cache-components/src/SitecoreHead.tsx

@@ -0,0 +1,26 @@
+import { JSX } from 'react';
+import { Page, JsonLdSchema } from '@sitecore-content-sdk/nextjs';
+import Scripts from 'src/Scripts';
+import SitecoreStyles from 'components/content-sdk/SitecoreStyles';
+
+interface SitecoreHeadProps {
+  page: Page;
+}
+
+/**
+ * Groups the scripts, styles, and structured data injected alongside the page layout.
+ */
+const SitecoreHead = ({ page }: SitecoreHeadProps): JSX.Element => {
+  const { layout } = page;
+
+  return (
+    <>
+      <Scripts />
+      <SitecoreStyles layoutData={layout} />
+      <JsonLdSchema page={page} />
+    </>
+  );
+};
+
+export default SitecoreHead;
+

package/dist/templates/nextjs-app-router-cache-components/src/lib/cache/get-sitecore-dictionary.ts

@@ -1,5 +1,5 @@
 import { buildSitecoreDictionaryCacheTag, DictionaryPhrases } from '@sitecore-content-sdk/nextjs';
-import { cacheTag } from 'next/cache';
+import { cacheLife, cacheTag } from 'next/cache';
 import client from 'src/lib/sitecore-client';
 
 type GetSitecoreDictionaryParams = {
@@ -13,6 +13,11 @@ type GetSitecoreDictionaryParams = {
 export async function getSitecoreDictionary(params: GetSitecoreDictionaryParams): Promise<DictionaryPhrases> {
   'use cache';
 
+  // Update the cacheLife profile to control the lifespan of Cache Components.
+  // NextJS defaults to the 'default' profile if not called, we explicity call it to make the policy clear.
+  // https://nextjs.org/docs/app/api-reference/functions/cacheLife
+  cacheLife('default');
+
   const { site, locale } = params;
   cacheTag(buildSitecoreDictionaryCacheTag({ site, locale }));
 

package/dist/templates/nextjs-app-router-cache-components/src/lib/cache/get-sitecore-error-page.ts

@@ -1,5 +1,5 @@
 import { collectSitecorePageCacheTags, ErrorPage, type Page } from '@sitecore-content-sdk/nextjs';
-import { cacheTag } from 'next/cache';
+import { cacheLife, cacheTag } from 'next/cache';
 import client from 'src/lib/sitecore-client';
 
 type GetSitecoreErrorPageParams = {
@@ -12,7 +12,9 @@ type GetSitecoreErrorPageParams = {
  * Loads Sitecore error pages with Next.js Cache Components and the same tag strategy as
  * {@link getSitecorePage}, so webhook / `revalidateTag` flows can invalidate updated error experiences.
  */
-export async function getSitecoreErrorPage(params: GetSitecoreErrorPageParams): Promise<Page | null> {
+export async function getSitecoreErrorPage(
+  params: GetSitecoreErrorPageParams
+): Promise<Page | null> {
   'use cache';
 
   const { site, locale, code } = params;
@@ -21,6 +23,11 @@ export async function getSitecoreErrorPage(params: GetSitecoreErrorPageParams):
   const sitecore = page?.layout?.sitecore;
   const itemPath = sitecore?.context?.itemPath;
 
+  // Update the cacheLife profile to control the lifespan of Cache Components.
+  // NextJS defaults to the 'default' profile if not called, we explicity call it to make the policy clear.
+  // https://nextjs.org/docs/app/api-reference/functions/cacheLife
+  cacheLife('default');
+
   const tags = collectSitecorePageCacheTags({
     site,
     locale,

package/dist/templates/nextjs-app-router-cache-components/src/lib/cache/get-sitecore-page.ts

@@ -1,5 +1,5 @@
 import { collectSitecorePageCacheTags, Page } from '@sitecore-content-sdk/nextjs';
-import { cacheTag } from 'next/cache';
+import { cacheLife, cacheTag } from 'next/cache';
 import client from 'src/lib/sitecore-client';
 
 type GetSitecorePageParams = {
@@ -17,6 +17,11 @@ export async function getSitecorePage(params: GetSitecorePageParams): Promise<Pa
   const { site, locale, path } = params;
   const page = await client.getPage(path, { site, locale });
 
+  // Update the cacheLife profile to control the lifespan of Cache Components.
+  // NextJS defaults to the 'default' profile if not called, we explicity call it to make the policy clear.
+  // https://nextjs.org/docs/app/api-reference/functions/cacheLife
+  cacheLife('default');
+
   const tags = collectSitecorePageCacheTags({
     site,
     locale,

package/dist/templates/nextjs-app-router-cache-components/src/proxy.ts

@@ -113,10 +113,10 @@ export const config = {
    * 3. /sitecore/api (Sitecore API routes)
    * 4. /- (Sitecore media)
    * 5. /healthz (Health check)
-   * 7. all root files inside /public
+   * 6. static files inside /public (images, fonts, css, js, etc.)
    */
   matcher: [
     '/',
-    '/((?!api/|sitemap|robots|_next/|healthz|sitecore/api/|-/|favicon.ico|sc_logo.svg).*)',
+    '/((?!api/|sitemap|robots|_next/|healthz|sitecore/api/|-/|.*[.](?:svg|png|jpe?g|gif|webp|avif|ico|woff2?|ttf|otf|eot|css|js|map|webmanifest)$).*)',
   ],
 };

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "create-content-sdk-app",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "Sitecore Content SDK initializer",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "bin": "./dist/index.js",
   "scripts": {
     "build": "npm run clean && tsc && ts-node ./scripts/build-templates.ts",
@@ -16,7 +20,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/Sitecore/content-sdk.git",
+    "url": "git+https://github.com/Sitecore/content-sdk.git",
     "directory": "packages/create-content-sdk-app"
   },
   "homepage": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html",
@@ -39,10 +43,10 @@
   },
   "devDependencies": {
     "@sitecore-content-sdk/analytics-core": "^2.1.2",
-    "@sitecore-content-sdk/angular": "~1.0.1",
-    "@sitecore-content-sdk/cli": "^2.3.0",
+    "@sitecore-content-sdk/angular": "~1.1.0",
+    "@sitecore-content-sdk/cli": "^2.4.0",
     "@sitecore-content-sdk/events": "^2.1.2",
-    "@sitecore-content-sdk/nextjs": "^2.4.1",
+    "@sitecore-content-sdk/nextjs": "^2.5.0",
     "@sitecore-content-sdk/personalize": "^2.1.0",
     "@stylistic/eslint-plugin": "^5.2.2",
     "@types/chai": "^5.2.2",