deco-cms-route-config

Configure CMS-driven routes for Deco storefronts using framework route factories.

5|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/decocms/deco-start --skill deco-cms-route-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deco-cms-route-config
Source: https://github.com/decocms/deco-start/tree/main/.cursor/skills/deco-cms-route-config
Command: npx skills add https://github.com/decocms/deco-start --skill deco-cms-route-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reusable CMS route configuration factories that live in @decocms/start/routes keep Deco storefront routing consistent, accelerate site setup, and simplify migrations.

Core Features & Use Cases

  • Provides cmsRouteConfig() and cmsHomeRouteConfig() wrappers that standardize catch-all, homepage, and admin routes.
  • Enables safe migrations from Fresh and route-level debugging with consistent SEO and caching behavior.
  • Integrates route-level head metadata via the framework, including default titles, descriptions, and SEO headers.

Quick Start

Create a new site route using cmsRouteConfig or cmsHomeRouteConfig and wire it into your site’s route file.

Frequently Asked Questions about deco-cms-route-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure CMS-driven routes for a Deco storefront?

Configuring Deco CMS routes involves applying the framework's route factories like cmsRouteConfig() and cmsHomeRouteConfig() to standardize catch-all, homepage, and admin routes within your site's route files.

What is the best way to migrate from Fresh routing to Deco?

Migrating from Fresh routing to Deco is streamlined by applying reusable CMS route configuration factories that ensure consistent SEO and caching behavior during the site setup transition.

How does variant-driven caching work with Deco route configuration?

Variant-driven caching in Deco route configuration is managed through routeCacheDefaults, which works alongside the framework's route factories to maintain consistent caching behavior across your storefront.

How do I integrate head metadata and SEO headers in Deco routes?

Integrating head metadata and SEO headers in Deco routes is handled directly by the framework through the route factories, automatically applying default titles, descriptions, and SEO headers to your pages.

Why does my Deco CMS route configuration ignore search parameters?

Deco CMS route configuration manages search parameters using the ignoreSearchParams property, allowing you to control whether URL search parameters affect route matching and caching behavior.