vtex
44 skills with substantive source documentation and an official publisher or observed installation demand. Read each skill’s original documentation through its card.
vtexheadless-bff-architecture
Apply when designing or modifying a BFF (Backend-for-Frontend) layer, middleware, or API proxy for a headless VTEX storefront. Covers BFF middleware architecture, public vs private API classification, VtexIdclientAutCookie management, API key protection, and secure request proxying. Use for any headless commerce project that must never expose VTEXAPPKEY or call private VTEX APIs from the browser.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexheadless-intelligent-search
Apply when implementing search functionality, faceted navigation, or autocomplete in a headless VTEX storefront. Covers productsearch, autocompletesuggestions, facets, banners, correctionsearch, and topsearches endpoints, plus analytics event collection. Use for any custom frontend that integrates VTEX Intelligent Search API for product discovery and search result rendering.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexmarketplace-catalog-sync
Apply when building catalog or SKU synchronization logic for VTEX marketplace seller connectors. Covers the changenotification endpoint, SKU suggestion lifecycle, product data mapping, price and inventory sync, and fulfillment simulation. Use for implementing seller-side catalog integration that pushes SKUs to VTEX marketplaces with proper notification handling and rate-limited batch synchronization.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexmarketplace-rate-limiting
Apply when implementing retry logic, rate limit handling, or resilience patterns in VTEX API integrations. Covers VTEX rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After), 429 status handling, exponential backoff with jitter, circuit breaker patterns, and request queuing. Use for any VTEX marketplace integration that must gracefully handle API throttling and maintain high availability.
- instalacje
- 2
- GitHub Stars
- 42
- Aktualizacja
- 19 sie
vtexpayment-idempotency
Apply when implementing idempotency logic in payment connector code or handling duplicate payment requests. Covers paymentId as idempotency key, payment state machine transitions, retry semantics for cancellation and refund operations, and requestId handling. Use for preventing duplicate charges and ensuring correct Gateway retry behavior across Create Payment, Cancel, Capture, and Refund endpoints.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-admin-react
Apply when building VTEX IO admin-facing React interfaces under the admin builder. Covers VTEX Styleguide and Shoreline usage, admin page composition, data-heavy admin interactions, and keeping administrative interfaces consistent with the VTEX Admin environment. Use for settings pages, moderation tools, dashboards, or operational UIs inside VTEX Admin.
- instalacje
- 2
- GitHub Stars
- 42
- Aktualizacja
- 19 sie
vtexvtex-io-app-contract
Apply when defining or changing the contract of a VTEX IO app through manifest.json, builder declarations, dependencies, peerDependencies, billingOptions, and app identity. Covers how the app declares capabilities and integration boundaries. Use for scaffolding apps, splitting responsibilities across apps, or fixing contract-level link and publish issues.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-auth-tokens-and-context
Apply when choosing which VTEX IO authentication token should back a request from a backend app. Covers ctx.authToken, ctx.storeUserAuthToken, ctx.adminUserAuthToken, authMethod, and how requester context should determine the identity used by VTEX clients. Use for deciding which identity talks to VTEX endpoints in storefront-backed requests, Admin actions, or app-level integrations that should avoid hardcoded VTEX credentials.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-events-and-workers
Apply when designing or implementing asynchronous processing in VTEX IO services through events, workers, and background handlers. Covers event handler structure, idempotency, retry-safe processing, and moving expensive work out of request-response routes. Use for event-driven integrations, delayed processing, or background jobs in VTEX IO apps.
- instalacje
- 2
- GitHub Stars
- 42
- Aktualizacja
- 19 sie
vtexvtex-io-graphql-api
Apply when working with GraphQL schema files in graphql/ or implementing resolvers in node/resolvers/ for VTEX IO apps. Covers schema.graphql definitions, @cacheControl and @auth directives, custom type definitions, and resolver registration in the Service class. Use for exposing data through GraphQL queries and mutations with proper cache control and authentication enforcement.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-masterdata
Apply when working with MasterData v2 entities, schemas, or MasterDataClient in VTEX IO apps, or when anyone designing or implementing a solution must scrutinize whether Master Data is the correct storage. The skill prompts hard questions: native Catalog or other VTEX stores, OMS, or an external database may be better; do not default to MD because it is convenient. Covers JSON Schema, CRUD, triggers, search and scroll, schema lifecycle, purchase-path avoidance, single source of truth, and BFF ha
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-messages-and-i18n
Apply when implementing localization and translated copy in VTEX IO apps. Covers the messages builder, /messages/.json, context.json, frontend message usage, and how VTEX apps integrate with vtex.messages for runtime translation. Use for storefront, admin, or backend flows that should use VTEX IO message infrastructure instead of hardcoded strings.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-observability-and-ops
Apply when making VTEX IO services easier to observe, troubleshoot, and operate in production. Covers metrics, structured logging, failure visibility, rate-limit awareness, and production readiness checks for backend apps. Use for integration monitoring, error diagnosis, or improving the operational quality of VTEX IO services before or after release.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-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 multi-binding setups.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-security-boundaries
Apply when reviewing or designing security-sensitive boundaries in VTEX IO apps. Covers public versus private exposure, trust assumptions at route and integration boundaries, sensitive data handling, validating what crosses the app boundary, and avoiding leakage across accounts, workspaces, users, or integrations. Use for route hardening, data exposure review, or evaluating whether a service boundary is too permissive.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-service-configuration-apps
Apply when designing VTEX IO configuration apps with the configuration builder or when a service app must receive structured configuration through runtime context. Covers the separation between service apps and configuration apps, schema.json and configuration.json, settingsType, and reading injected configuration through ctx.vtex.settings. Use for shared service configuration, decoupled configuration lifecycle, or reviewing whether app settings should be replaced by a configuration app.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexvtex-io-storefront-react
Apply when building VTEX IO storefront components under react/ for Store Framework experiences. Covers storefront component structure, css-handles, storefront context hooks, browser-safe data fetching, and how components should behave when used as theme blocks. Use for custom storefront UI, product widgets, banners, forms, or reviewing shopper-facing React code in VTEX IO apps.
- instalacje
- 2
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexarchitecture-well-architected-commerce
Apply when scoping, reviewing, or documenting cross-cutting VTEX commerce architecture across storefront, IO, headless, marketplace, payments, or any other VTEX module. Grounds work in the Well-Architected Commerce framework—Technical Foundation (reliability, trust, integrity; security, infrastructure, compliance), Future-proof (innovation, simplicity, efficiency; scalable and adaptable solutions), and Operational Excellence (accuracy, accountability, data-driven improvement; process and custome
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexfaststore-storefront
Core coding rules and workflow for developing VTEX FastStore storefronts. Use when starting any FastStore development task, writing TypeScript/React components, creating section overrides, extending the BFF, or styling. Covers all primary conventions, safety rules, and the development workflow used across every FastStore project.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexheadless-caching-strategy
Apply when implementing caching logic, CDN configuration, or performance optimization for a headless VTEX storefront. Covers which VTEX APIs can be cached (Intelligent Search, Catalog) versus which must never be cached (Checkout, Profile, OMS), stale-while-revalidate patterns, cache invalidation, and BFF-level caching. Use for any headless project that needs TTL rules and caching strategy guidance.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexheadless-checkout-proxy
Apply when implementing cart, checkout, or order placement logic proxied through a BFF for headless VTEX storefronts. Covers OrderForm lifecycle, cart creation, item management, profile/shipping/payment attachments, orderFormId management, and secure checkout flows. Use for any headless frontend that needs to proxy VTEX Checkout API calls through a server-side layer with proper session cookie handling.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexmarketplace-fulfillment
Apply when implementing fulfillment, invoice, or tracking logic for VTEX marketplace seller connectors. Covers the External Seller fulfillment protocol: fulfillment simulation (checkout and indexation), order placement with reservation id, order dispatch (authorize fulfillment), OMS invoice and tracking APIs, and partial invoicing. Use for seller-side services that must answer within the simulation SLA and integrate with VTEX marketplace order management.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexmarketplace-order-hook
Apply when implementing order integration hooks, feeds, or webhook handlers for VTEX marketplace connectors. Covers Feed v3 (pull) vs Hook (push), filter types (FromWorkflow and FromOrders), order status lifecycle, payload validation, and idempotent processing. Use for building order integrations between VTEX marketplaces and external systems such as ERPs, WMS, or fulfillment services.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź
vtexmasterdata-storage-strategy
Apply when deciding whether VTEX Master Data is the right storage for a given workload, designing JSON Schemas with v-indexed, v-cache, v-security, and v-triggers, planning entity capacity and lifecycle, or auditing existing Master Data usage. Covers when to use MD versus Catalog, OMS, VBase, or external databases, schema design best practices, indexing strategy, trigger patterns, and operational considerations. Use before creating any new Master Data entity.
- instalacje
- 1
- GitHub Stars
- 46
- Aktualizacja
- 14 paź