Skip to content

fix ai and other home page links #1105

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bdenham merged 2 commits into from
Oct 5, 2026
Merged

fix ai and other home page links #1105

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
eb46108
fix ai and other home page links
bdenham Oct 5, 2026
b28cd9f
fixed build from bad link
bdenham Oct 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 10 additions & 11 deletions astro.sidebar.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,11 +29,16 @@ export function generateSidebar() {
{ label: 'Backend options', link: '/get-started/backends/' },
{ label: 'Luma Bridge', link: '/setup/discovery/luma-bridge/' },
{ label: 'Create a storefront', link: '/get-started/create-storefront/' },
{ label: 'Plan your storefront project', link: '/setup/' },
{
label: 'Licensing',
label: 'AI tools',
collapsed: true,
autogenerate: { directory: '/licensing/' },
items: [
{ label: 'Install the AI tools', link: '/ai/' },
{ label: 'Boilerplate skills', link: '/ai/boilerplate-skills/' },
{ label: 'Dropins AI tools', link: '/ai/dropins-ai-tools/' },
{ label: 'Wayfinder', link: '/ai/wayfinder/' },
{ label: 'LLM files', link: '/ai/static-text-files/' },
],
},
{
label: 'Boilerplate',
Expand All @@ -45,15 +50,9 @@ export function generateSidebar() {
],
},
{
label: 'AI tools',
label: 'Licensing',
collapsed: true,
items: [
{ label: 'Install the integrations', link: '/ai/' },
{ label: 'Boilerplate skills', link: '/ai/boilerplate-skills/' },
{ label: 'Dropins AI tools', link: '/ai/dropins-ai-tools/' },
{ label: 'Wayfinder', link: '/ai/wayfinder/' },
{ label: 'Fallback docs', link: '/ai/static-text-files/' },
],
autogenerate: { directory: '/licensing/' },
},
],
},
Expand Down
59 changes: 36 additions & 23 deletions src/components/HomeHero.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,19 +12,22 @@ const menuIcons = Object.fromEntries(
const directories = [
{
label: 'For developers',
link: '/get-started/',
aria: 'Developer documentation',
categories: [
{
title: 'Getting started',
link: '/get-started/',
links: [
{ title: 'Prerequisites', link: '/get-started/before-you-start/' },
{ title: 'Backend options', link: '/get-started/backends/' },
{ title: 'Plan your storefront project', link: '/setup/' },
{ title: 'Install the AI tools', link: '/ai/' },
{ title: 'Create a storefront', link: '/get-started/create-storefront/' },
],
},
{
title: 'Architecture',
link: '/get-started/architecture/',
links: [
{ title: 'How a page loads', link: '/get-started/architecture/how-a-page-loads/' },
{
Expand All @@ -43,15 +46,17 @@ const directories = [
},
{
title: 'Blocks',
link: '/blocks/',
links: [
{ title: 'Blocks and drop-ins', link: '/blocks/blocks-and-dropins/' },
{ title: 'Customize blocks', link: '/blocks/customize-blocks/' },
{ title: 'Arrange block layouts', link: '/blocks/arrange-block-layouts/' },
{ title: 'Create commerce blocks', link: '/blocks/create-commerce-blocks/' },
{ title: 'Build commerce features', link: '/blocks/build-custom-features/' },
],
},
{
title: 'Drop-ins',
link: '/dropins/all/introduction/',
links: [
{ title: 'Drop-in containers', link: '/dropins/all/containers/' },
{ title: 'Container slots', link: '/dropins/all/slots/' },
Expand All @@ -61,6 +66,7 @@ const directories = [
},
{
title: 'Configuration',
link: '/setup/configuration/',
links: [
{
title: 'Storefront configuration',
Expand All @@ -76,6 +82,7 @@ const directories = [
},
{
title: 'Production',
link: '/setup/launch/',
links: [
{ title: 'Launch checklist', link: '/setup/launch/launch-checklist/' },
{ title: 'Performance best practices', link: '/get-started/performance/' },
Expand All @@ -87,10 +94,12 @@ const directories = [
},
{
label: 'For authors',
link: '/merchants/quick-start/',
aria: 'Content author documentation',
categories: [
{
title: 'Getting started',
link: '/merchants/quick-start/',
links: [
{ title: 'What is a storefront?', link: '/merchants/quick-start/create-content/' },
{ title: 'How a page comes together', link: '/merchants/quick-start/content-model/' },
Expand All @@ -100,6 +109,7 @@ const directories = [
},
{
title: 'Authoring',
link: '/merchants/authoring/',
links: [
{ title: 'Add a block to a page', link: '/how-tos/add-block-to-page/' },
{ title: 'Block table structure', link: '/merchants/blocks/block-tables/' },
Expand All @@ -112,6 +122,7 @@ const directories = [
},
{
title: 'B2C blocks',
link: '/merchants/blocks/b2c/',
links: [
{ title: 'Product Details', link: '/merchants/blocks/product-details/' },
{ title: 'Product List Page', link: '/merchants/blocks/product-list-page/' },
Expand All @@ -121,6 +132,7 @@ const directories = [
},
{
title: 'B2B blocks',
link: '/merchants/blocks/b2b/',
links: [
{ title: 'Company Profile', link: '/merchants/blocks/commerce-company-profile/' },
{
Expand All @@ -133,6 +145,7 @@ const directories = [
},
{
title: 'Customization',
link: '/merchants/content-customizations/',
links: [
{ title: 'Show enrichment content', link: '/how-tos/show-enrichment-content/' },
{ title: 'Create a page experiment', link: '/how-tos/create-page-experiment/' },
Expand All @@ -142,6 +155,7 @@ const directories = [
},
{
title: 'Publishing',
link: '/merchants/edge-delivery-services/',
links: [
{ title: 'Scheduling options', link: '/merchants/edge-delivery-services/scheduling/' },
{ title: 'Translate content', link: '/how-tos/translate-storefront-content/' },
Expand Down Expand Up @@ -213,13 +227,17 @@ const sharedPaths = [
directories.map((dir, i) => (
<section class='home-hero__audience' aria-labelledby={`home-hero-audience-${i}`}>
<h2 class='home-hero__audience-title' id={`home-hero-audience-${i}`}>
{dir.label}
<a class='home-hero__heading-link' href={setBasePath(dir.link)}>
{dir.label}
</a>
</h2>
<nav class='home-hero__categories' aria-label={dir.aria}>
{dir.categories.map((category, j) => (
<section class='home-hero__category' aria-labelledby={`home-hero-category-${i}-${j}`}>
<h3 class='home-hero__category-title' id={`home-hero-category-${i}-${j}`}>
{category.title}
<a class='home-hero__heading-link' href={setBasePath(category.link)}>
{category.title}
</a>
</h3>
<ul class='home-hero__link-list'>
{category.links.map((item) => (
Expand All @@ -237,23 +255,6 @@ const sharedPaths = [
))
}
</div>

<nav class='home-hero__reference' aria-label='Shared reference documentation'>
<ul class='home-hero__reference-list'>
{
sharedPaths.map((path) => (
<li>
<a class='home-hero__link' href={setBasePath(path.link)}>
<span>{path.title}</span>
<span class='home-hero__link-icon' aria-hidden='true'>
<Icon name='right-arrow' size='1rem' />
</span>
</a>
</li>
))
}
</ul>
</nav>
</section>

<style>
Expand Down Expand Up @@ -424,7 +425,7 @@ const sharedPaths = [
padding: 0.6rem 1.25rem;
border-radius: 0.5rem;
font-size: 1rem;
font-weight: 600;
font-weight: 400;
text-decoration: none;
background: #06c;
color: #fff;
Expand Down Expand Up @@ -496,7 +497,7 @@ const sharedPaths = [
padding: 0;
color: var(--sl-color-white);
font-family: var(--sl-font);
font-size: 1.25rem;
font-size: 1.1rem;
font-weight: 700;
line-height: 1.5;
letter-spacing: 0;
Expand Down Expand Up @@ -583,6 +584,18 @@ const sharedPaths = [
color: var(--sl-color-text-accent);
}

.home-hero .home-hero__heading-link {
color: inherit;
text-decoration: inherit;
}

.home-hero .home-hero__heading-link:hover {
color: var(--sl-color-text-accent);
text-decoration: underline;
text-underline-offset: 4px;
}

.home-hero__heading-link:focus-visible,
.home-hero__link:focus-visible,
.home-hero__category-link:focus-visible {
outline: 2px solid var(--sl-color-text-accent);
Expand Down
13 changes: 7 additions & 6 deletions src/content/docs/ai/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Install the integrations
title: Install the AI tools
description: Give your AI editor or coding agent current Adobe Commerce storefront documentation, drop-in APIs, and project conventions.
sidebar:
label: Install the integrations
label: Install the AI tools
order: 1
---

Expand All @@ -20,6 +20,7 @@ If your project is based on the Adobe Commerce boilerplate, set up all three int
| [Boilerplate skills](/ai/boilerplate-skills/) | Storefront planning, coding, customization, and testing conventions |
| [Dropins AI tools](/ai/dropins-ai-tools/) | Accurate drop-in slots, events, API functions, and design tokens validated against source |
| [Wayfinder](/ai/wayfinder/) | Routing to the correct Adobe Commerce documentation source |
| [LLM files](/ai/static-text-files/) | AI tools use these static, regenerated llms.txt files as context for the storefront documentation. |


</TableWrapper>
Expand Down Expand Up @@ -76,16 +77,16 @@ Follow these steps in order.

</Steps>

## Use fallback documentation files
## Use LLM documentation files

If your AI editor or coding agent doesn't support tool servers or agent skills, add the following URL to your project instructions, or paste it into a chat instead:
If your AI editor or coding agent doesn't support tool servers or agent skills, add the following LLM documentation URL to your project instructions, or paste it into a chat instead:

```text
https://experienceleague.adobe.com/en/tools/commerce-storefront/llms.txt
```

For editor-specific setup instructions and a verification prompt, see [Fallback documentation files](/ai/static-text-files/).
For editor-specific setup instructions and a verification prompt, see [LLM files](/ai/static-text-files/).

<Aside type="note">
The `llms.txt` file offers guidance similar to the integrations above, but it isn't validated against your project's source, so it can become outdated. If you completed the installation steps, your agent already has more reliable, source-backed information — use `llms.txt` only as a fallback.
The `llms.txt` file offers guidance similar to the integrations above, but it isn't validated against your project's source, so it can become outdated. If you completed the installation steps, your agent already has more reliable, source-backed information, use `llms.txt` only as a fallback.
</Aside>
6 changes: 3 additions & 3 deletions src/content/docs/ai/static-text-files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Fallback documentation files
title: LLM files
description: Use fallback llms.txt and topic files, regenerated at each publish, to give AI editors and coding agents current Adobe Commerce storefront documentation.
tableOfContents:
maxHeadingLevel: 2
Expand All @@ -9,10 +9,10 @@ import TableWrapper from '@components/TableWrapper.astro';
import Link from '@components/Link.astro';
import { Aside, Tabs, TabItem } from '@astrojs/starlight/components';

If your AI editor cannot use MCP servers or agent skills, use these static documentation files as context for storefront APIs, drop-ins, and Edge Delivery Services.
Static llms.txt files are regenerated on every build to give AI editors and coding agents current Adobe Commerce storefront documentation.

<Aside type="note" title="Already using the boilerplate with a capable agent?">
If your AI editor or coding agent supports MCP servers and agent skills, use [Install the integrations](/ai/#installation-steps) instead. That setup provides source-backed drop-in information, documentation routing, and storefront development conventions. Adding this page's `llms.txt` link is unnecessary.
If your AI editor or coding agent supports MCP servers and agent skills, use [Install the AI tools](/ai/#installation-steps) instead. That setup provides source-backed drop-in information, documentation routing, and storefront development conventions. Adding this page's `llms.txt` link is unnecessary.
</Aside>

## Available files
Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/get-started/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,6 @@ Within that setup, your job is to connect Commerce data to the page. You start f
Drop-in components are included with an Adobe Commerce as a Cloud Service or Adobe Commerce Optimizer license. If you use Adobe Commerce on Cloud, you need a separate Adobe Commerce Optimizer license to use drop-ins. Read [Backend options](/get-started/backends/) to see which prerequisites apply to your backend, and [Licensing requirements](/licensing/) to confirm what your license covers.
</Aside>

## Plan your project

Start with [Plan your storefront project](/setup/) to define your scope and migration strategy. If your team already has a plan, continue with the preview steps below.

## Get your first preview running

You can start with [Create a storefront](/get-started/create-storefront/) if your team already has accounts and a chosen backend. If not, this path takes you from zero to a working local preview:
Expand Down
Loading
Loading