> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ollie.shop/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Product updates and announcements

<Update label="June 2026" description="v0.13.0">
  ## New Features & Improvements

  * **Redesigned Studio workspace.** Studio now opens as a full-screen, standalone editing environment with a side-by-side live preview, component search grouped by slot, and a redesigned header and sidebar.
  * **Visual props editor.** Edit component props through a schema-driven form (or raw JSON) with live validation — no more guessing prop shapes.
  * **Theme editor.** A dedicated Theme tokens panel to edit brand colors, neutrals, system colors, and shape/size presets directly in Studio.
  * **Slot inspector.** Hover to highlight slots on the live preview, copy a slot id, or jump straight into editing the component in that slot.
  * **Batch deploy.** Build and deploy multiple components at once from Studio.
  * **Import components across stores and organizations.** Reuse a component from another store — including across organizations — and keep it in sync with its source.
  * **Duplicate a version.** Clone an entire version's content, components, and functions to branch off a new experience quickly.
  * **A/B testing.** Run experiments across versions with per-version A/B test configuration and flag overrides.
  * **Apple Pay via VTEX Wallet Hub.** Express Apple Pay checkout now works gateway-agnostically through VTEX Wallet Hub.
  * **Romanian locale.** Added full Romanian (ro) translations, with currency shown as "lei".
  * **Measurement-unit aware cart.** Items sold by weight or volume (e.g. per 100g) now display the correct unit and per-unit pricing, including grouped breakdowns for promotion splits.
  * **Shipping improvements.** New pickup layout, a complete-address modal for missing mandatory fields, and estimated delivery / arrival dates in the order summary.
  * **CLI: stream browser logs.** A `--browser-logs` flag streams your custom component's console output straight to your terminal.

  ## Bug Fixes

  * Fixed PayPal express rendering and added a loading skeleton on the cart.
  * Various installment display and shipping-package layout fixes.

  ## Technical Updates

  * Introduced a framework-free `<secure-input>` custom element for PCI-isolated card fields.
  * Standardized the AI agent skills library and published it via a public mirror.
  * Centralized feature-flag handling behind a single flag registry.
</Update>

<Update label="May 2026" description="v0.12.0">
  ## New Features & Improvements

  * **New payment methods:** Aplazo, Kueski, and Mercado Pago.
  * **Debit card support.** Debit cards now appear as their own payment tile with a dedicated brand strip.
  * **Mexico support.** Postal-code-first address flow and Mexico-specific address fields (exterior/interior numbers, colonia).
  * **Smarter shipping.** Optional business-days delivery display, per-dock package splitting, and an optimized shipping-options flow.
  * **Studio props panel** and a configurable checkout start route.
  * **Sales template revamp** with new header and share slots.
  * **Resilient payments.** Automatic payment retry and timeout recovery, a fallback payment method after repeated failures, and clearer "payment not ready" and item-error modals.
  * Smoother, optimistic payment loading experience.

  ## Bug Fixes

  * Fixed saved-card default selection and filtering of expired cards.
  * Numerous payment-step and checkout consistency fixes.
</Update>

<Update label="April 2026" description="v0.11.0">
  ## New Features & Improvements

  * **Business rules.** Configure store business rules from the Admin, with matching CLI commands and versioned rule sets.
  * **Custom payment methods.** Define and render your own payment methods in the checkout.
  * **Step navigation SDK hook.** Custom components can now drive step navigation (including the place-order button) programmatically.
  * **Store environment variables.** Manage per-store secrets and configuration, injected securely at runtime.
  * **Global layout bottom slot** for content that spans the whole checkout.
  * **Builds visibility.** New builds tab on component and function pages, plus exposed build logs.
  * **CLI:** new `function` command and production environment defaults.
  * Redesigned review/summary step and an on-select-payment hook for custom components.

  ## Bug Fixes

  * Handle item errors during order creation and show the Pix modal correctly while redirecting.
  * Fixed gift-card flows and transaction verification via order status.

  ## Technical Updates

  * Added bot-protection to the storefront.
</Update>

<Update label="March 2026" description="v0.10.0">
  ## New Features & Improvements

  * **Boleto** payment method and **Yuno Click to Pay**.
  * **Address lookup by postal code**, with a graceful fallback when Google Maps is unavailable.
  * **Address selection on the cart page** and gift-card full-payment flow.
  * **CLI agent commands** and deploy-status reporting.
  * **Custom functions:** custom regex support and reusable trigger-variable operator presets.
  * Server-side session storage and session-cookie persistence for more reliable sessions.
  * New Studio sidebar layout and improved default template.

  ## Bug Fixes

  * Multiple address-form fixes, including street/place-name handling.

  ## Technical Updates

  * Faster component delivery via a dedicated CloudFront cache policy and lazy-mounted PayPal buttons.
</Update>

<Update label="February 2026" description="v0.9.0">
  ## New Features & Improvements

  * **Ollie Studio styling** groundwork and a "use my location" button for faster address entry.
  * **Saved cards:** a "see more" control to reveal additional saved cards.
  * **Purchase tracking** for payments completed on the order page.
  * **Mobile summary dropdown** and improved shipping-step UI.
  * Improved PayPal implementation and login messaging.
  * CLI scaffolding now includes an AI prompt for creating an Ollie project.

  ## Bug Fixes

  * Address-autocomplete alignment, remove-item behavior, and mobile summary layout fixes.
  * Resolved PostHog race conditions and PayPal express caching issues.

  ## Technical Updates

  * Added security headers to payments and served minified component bundles.
</Update>

<Update label="January 2026" description="v0.8.0">
  ## New Features & Improvements

  * **NuPay** payment method.
  * **Login form modal** in the default template, plus a forgot-password flow.
  * **Ollie Login enabled by default.**
  * Design tokens for the sidebar, container, and buttons.
  * New Admin view-and-filter component and page-view tracking.
  * New slots: address on cart, proceed-to-checkout, full-page header, and summary items.
  * **Custom functions:** pass request headers into trigger expressions.

  ## Bug Fixes

  * Fixed step-address behavior and step-navigation slot styling.
  * Resolved version-cookie edge cases.

  ## Technical Updates

  * Introduced JSON-schema-based validation across the platform.
</Update>

<Update label="December 2025" description="v0.7.0">
  ## New Features & Improvements

  * **Device fingerprinting** for fraud prevention.
  * **Dynamic credit-card brand icons** and gift-card support in the commerce client.
  * New navigation and address-form slots, plus a multi-package slider on mobile.
  * Option to keep items unsplit (`noSplitItems`) and disable Google Translate on checkout.
  * More reliable payments via a container handshake before submit and PayPal gateway-callback handling.

  ## Bug Fixes

  * Fixed installment selection, success messages, and shipping-package updates.
  * Added a fallback parser for gateway-callback responses.

  ## Technical Updates

  * Migrated checkout middleware to the Node.js runtime.
  * Applied security patches for underlying framework vulnerabilities.
</Update>

<Update label="November 2025" description="v0.6.0">
  ## New Features & Improvements

  * **Guest checkout with address before identification** and a change-address / login modal.
  * **Pix order page** with redirect after placing a Pix payment.
  * Suggested email on the contact form and an items counter on the product gallery.
  * New shipping-packages slot and additional delivery-method selector props.
  * Error boundaries around slot components to isolate custom-component failures.
  * VTEX helpers are now exported from the SDK.

  ## Bug Fixes

  * Fixed address field ordering and country/schema switching.
  * Multiple Apple Pay and Pix redirect fixes.

  ## Technical Updates

  * Introduced session cookies with cache control.
</Update>

<Update label="October 2025" description="v0.5.0">
  ## New Features & Improvements

  * **PayPal Express** and express payment buttons in the payment section.
  * **Affirm** payment method and reCAPTCHA support.
  * **PostHog analytics** integration.
  * Billing address v2, address autocomplete, and gift-card-only orders.
  * Redesigned step navigation and mobile navigation, with theming tokens for navigation buttons.
  * Many new slots: totalizers, cart item package list, shipping options, empty-cart, and mobile totalizers.
  * Transaction-denied modal and dynamic badges.

  ## Bug Fixes

  * Address, Apple Pay, and installment fixes across the flow.
  * Region-specific address schema fixes (Ireland, Canada).

  ## Technical Updates

  * New shared UI library package and optimistic cart updates.
</Update>

<Update label="September 2025" description="v0.4.0">
  ## New Features & Improvements

  * **Apple Pay and Google Pay** express checkout, with an express-checkout container.
  * **Gift cards** and **saved cards** support.
  * **Share Cart** and **EasyCart** for faster cart handoff.
  * **GTM analytics** integration and the SDK `useCheckoutOrder` hook.
  * Native checkout success page and a "My Orders" slot.
  * Team member management with email invites.
  * Mobile improvements and sticky navigation.

  ## Bug Fixes

  * Fixed saved-card detection, checkout errors, and invite flows.
  * Cookie and session-creation fixes.

  ## Technical Updates

  * Added a complete local testing environment for developers.
</Update>

<Update label="August 2025" description="v0.3.0">
  ## New Features & Improvements

  * **Google Pay** and **Pagaleve** payment methods.
  * **Manual address input** and a phone country selector.
  * Update-profile flow and session revalidation.
  * Additional slots on the shipping step and cart, plus an unavailable-items list on the shipping step.
  * Translations for custom components and expanded multi-language support.

  ## Bug Fixes

  * Cart layout fixes and Pix error handling.
  * Fixed CVV tooltip position and broken font/style props.

  ## Technical Updates

  * Foundational observability and reliability improvements across the platform.
</Update>

<Update label="July 2025" description="v0.2.1">
  ## New Features & Improvements

  * Added shipping slot functionality.
  * Improved props management.
  * Integrated PayPal payment option.
  * Added missing translations in components and templates (default and grocery).

  ## Bug Fixes

  * Fixed 500 error on checkout session.

  ## Technical Updates

  * Allowed multiple active components and functions per version.
</Update>

<Update label="June 2025" description="v0.1.0">
  ## New Features & Improvements

  * Minor updates to `@create-ollie-shop`.
  * Added optimistic updates for cart operations (adding/removing items) to improve user experience.
  * Introduced new CLI commands: docs, help, whoami, and validate.

  ## Bug Fixes

  * Fixed payment submission errors.
  * Fixed input number issue for OTP.
  * Added fallback to Node.js v18.
</Update>
