deco-apps-vtex-review

Audits and fixes VTEX integration issues in Deco apps-start during code reviews, porting projects, and debugging sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit and fix VTEX integration issues in Deco apps-start, focusing on cookie propagation, auth cookies, order form structure, salesChannel handling, HttpOnly cookie requirements, Intelligent Search cookies, and hooks parity with deco-cx/apps.

Core Features & Use Cases

  • Cookie propagation: ensure server responses carry Set-Cookie headers to the browser via vtexFetchWithCookies where state changes occur.
  • Auth and session hygiene: verify VtexId auth cookies are built and sent correctly for GraphQL calls and sessions.
  • Order form reliability: enforce expectedOrderFormSections on checkout calls and route hygiene.
  • Sales channel scoping: ensure sc parameter is included in catalog and order form endpoints for correct pricing and availability.
  • Hooks parity: validate presence and behavior of useCart, useUser, useWishlist equivalents.
  • TypeScript validation: align type definitions and enrichments with deco-cx/apps parity.

Quick Start

Start by running the VTEX audit for deco-apps-vtex-review to identify cookie, auth, and order form issues, then implement fixes to align with best practices.

Frequently Asked Questions about deco-apps-vtex-review

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

FAQPage Schema
How do I audit VTEX integration cookie propagation in Deco apps?

Auditing VTEX integration cookie propagation in Deco apps requires validating that server responses carry Set-Cookie headers to the browser via vtexFetchWithCookies where state changes occur, ensuring proper session handling.

Why does my VTEX orderForm return incomplete data during checkout?

Your VTEX orderForm returns incomplete data during checkout when expectedOrderFormSections are not enforced on checkout calls, leading to missing pricing, availability, or sales channel sc information.

How do I verify VtexId auth cookie handling for GraphQL calls in Deco?

Verify VtexId auth cookie handling for GraphQL calls in Deco by checking that buildAuthCookieHeader correctly constructs and sends authentication cookies, maintaining session hygiene across VTEX modules and deco-cx/apps.

Does Deco apps-start support TypeScript validation for VTEX hooks parity?

Deco apps-start supports TypeScript validation for VTEX hooks parity by aligning type definitions and enrichments with deco-cx/apps standards, validating the presence and behavior of useCart, useUser, and useWishlist equivalents.

What is the best way to enforce salesChannel sc parameters in VTEX catalog endpoints?

The best way to enforce salesChannel sc parameters in VTEX catalog endpoints is to audit requests ensuring the sc parameter is included for correct pricing and availability alignment across deco-cx/apps modules.

When do I need HttpOnly cookies for VTEX Intelligent Search in Deco?

You need HttpOnly cookies for VTEX Intelligent Search in Deco when validating cookie propagation and security requirements, ensuring Intelligent Search cookies meet deco-cx/apps standards during debugging and code reviews.