landing-page-demo-layout

name

landing-page-demo-layout

description

Use when changing shared site layout behavior in the DatoCMS landing page demo starter, even if the user does not say layout: header, navigation bar, menu items, dropdown menus, logo, accent color, theme color, top notification bar, footer logo, footer subtitle, footer legal links, social media links, language selector, and fields on the Layout singleton that affect shared shell surfaces. Handles app/[locale]/(common-layout)/query.graphql, app/[locale]/query.graphql, components/Header/**, components/Footer/**, and components/CustomColor/**. Do not use for page body sections, docs pages or docs sidebar, blog/content records, new route-backed pages, preview links, SEO route mapping, or generic DatoCMS schema work.

Landing Page Demo Layout

Use this for shared site shell behavior in the landing page starter: header, navigation, top notification, logo, accent color, footer, social links, legal footer links, and language selector.

Prerequisites

Before schema or content operations:

• Confirm the shared DatoCMS agent-skills plugin is available. If it is missing, ask whether the user already has it installed; if not, request installation before continuing.
• Expect the DatoCMS MCP to be installed and running. If live schema or content facts are needed and MCP is unavailable, pause and ask the user to install or start it.
• Inspect live schema/content through MCP before assuming API keys, localized fields, validators, singleton records, or allowed blocks.

Existing layout structure

• Shared shell query: app/[locale]/(common-layout)/query.graphql.
• Global color query: app/[locale]/query.graphql.
• Header components: components/Header/**.
• Footer component: components/Footer/index.tsx.
• Accent color component: components/CustomColor/**.
• DatoCMS singleton: layout.
• Layout fields include logo, main_color, notification, menu, footer_logo, footer_subtitle, social_media_links, and footer_links.
• Menu blocks are menu_item and menu_dropdown; social link blocks are social_media_icon.

Common workflows

Change existing layout content

1. Confirm the request affects a shared shell surface, not one page section or docs content.
2. Inspect the current layout singleton through MCP.
3. Preserve existing field values and localized values unless the user requested a replacement.
4. Update the singleton field or nested block shape through the shared DatoCMS skills or MCP.
5. If the singleton is published and the change should be public, publish it.
6. Verify a home page and at least one non-home page when practical.

Add or change layout rendering

1. Inspect the live field shape before changing a query or component.
2. Update app/[locale]/(common-layout)/query.graphql or app/[locale]/query.graphql only when more data is needed.
3. Update the relevant shared component under components/Header/**, components/Footer/**, or components/CustomColor/**.
4. Keep absent or empty optional fields safe.
5. Regenerate GraphQL types after query changes.
6. Verify desktop and mobile navigation when changing menus.

Adjust navigation or footer

1. For navigation, inspect layout.menu, menu_item, and menu_dropdown records.
2. Keep menu links route-aware through buildUrl.
3. For footer work, inspect footer_logo, footer_subtitle, social_media_links, and footer_links.
4. Keep legal footer links pointed at /legal/[slug] unless route behavior changes too.
5. Preserve item order unless the user requests a reorder.

Guardrails

• Page body sections belong to landing-page-demo-sections.
• Docs home, docs pages, and docs sidebar belong to landing-page-demo-docs.
• Blog, author, tag, testimonial, pricing tier, changelog, and legal record maintenance belongs to landing-page-demo-content-records unless it changes a shared shell surface.
• New route-backed types, preview links, metadata, and SEO-analysis mapping belong to landing-page-demo-routing-preview.
• Generic schema design belongs to the shared DatoCMS skills.

Acceptance criteria

• Header, footer, notification, logo, social links, language selector, and color rendering remain safe with optional empty fields.
• Menu dropdowns still work on desktop and mobile.
• Footer links remain locale-aware.
• GraphQL type generation and build pass after code changes.