AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: rootpath

VTEX IO: rootpath

Apply when building VTEX IO apps that must work correctly in multi-binding stores where bindings use path prefixes (e.g. store.com/us/, store.com/br/). Covers rootPath extraction from x-vtex-root-path header, useRuntime().rootPath in React, URL construction in backends, link generation, asset paths, and API route considerations. Use when the app breaks or produces wrong URLs in cross-border or mul

vtex official Данные

Что делает навык

Навык обеспечивает корректную работу приложений VTEX IO в мультибрендовых магазинах с несколькими bindings, где используется префикс пути (например, store.com/us/). Он охватывает извлечение rootPath, построение URL, генерацию ссылок и управление путями к ассетам.

Когда применять

  • Генерация ссылок, редиректов, API-эндпоинтов и канонических URL, которые должны включать префикс binding.
  • Загрузка ассетов (изображений, скриптов, стилей), которые ломаются при использовании подпути (sub-path) binding.
  • Построение URL для sitemap, канонических ссылок или кросс-биндинговых ссылок в backend-роутах.
  • Отладка ошибок 404 или неверных ссылок, возникающих только в мультибрендовых магазинах.

Как работает

  1. Извлекать rootPath из заголовка x-vtex-root-path.
  2. Использовать useRuntime().rootPath в React-компонентах.
  3. Правильно конструировать URL в backend-части приложения.
  4. Генерировать ссылки и пути к ассетам с учетом префикса пути.
  5. Настраивать API-маршруты с учетом особенностей мультибиндинга.

Примеры запросов агенту

Как правильно использовать useRuntime().rootPath в React-компоненте для мультибрендового магазина?
Почему у меня ломаются ссылки на ассеты при использовании store.com/us/?
Как построить корректный URL для sitemap в VTEX IO backend для кросс-бордер магазина?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «vtex-io-rootpath» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-rootpath/ ~/.claude/skills/vtex-io-rootpath/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.