skeleton@2025.10.1

Major Changes

• Update Storefront API and Customer Account API to version 2025-10 (#3430) by @kdaviduik

Patch Changes

• Add support for Bun's text-based lockfile (bun.lock) introduced in Bun 1.2, and npm's shrinkwrap lockfile (npm-shrinkwrap.json), as alternatives to their respective primary lockfiles (bun.lockb and package-lock.json). (#3430) by @kdaviduik

• Add cartGiftCardCodesAdd mutation (#3430) by @kdaviduik

  New Feature: cartGiftCardCodesAdd

  The skeleton template has been updated to use the new cartGiftCardCodesAdd mutation:

  • Removed UpdateGiftCardForm component from CartSummary.tsx
  • Added AddGiftCardForm component using CartForm.ACTIONS.GiftCardCodesAdd

  If you customized the gift card form in your project, you may want to migrate to the new Add action for simpler code.

  Usage

  import {CartForm} from '@shopify/hydrogen';
  
  <CartForm action={CartForm.ACTIONS.GiftCardCodesAdd} inputs={{giftCardCodes: ['CODE1', 'CODE2']}}>
    <button>Add Gift Cards</button>
  </CartForm>

  Or with createCartHandler:

  const cart = createCartHandler({storefront, getCartId, setCartId});
  await cart.addGiftCardCodes(['SUMMER2025', 'WELCOME10']);

• Add support for nested cart line items (warranties, gift wrapping, etc.) (#3430) by @kdaviduik

  Storefront API 2025-10 introduces parentRelationship on cart line items, enabling parent-child relationships for add-ons. This update displays nested line items in the cart.

  Changes

  • Updates GraphQL fragments to include parentRelationship and lineComponents fields
  • Updates CartMain and CartLineItem to render child line items with visual hierarchy

  Note

  This update focuses on displaying nested line items. To add both a product and its child (e.g., warranty) in a single action:

  <AddToCartButton
    lines={[
      {merchandiseId: 'gid://shopify/ProductVariant/laptop-456', quantity: 1},
      {
        merchandiseId: 'gid://shopify/ProductVariant/warranty-123',
        quantity: 1,
        parent: {merchandiseId: 'gid://shopify/ProductVariant/laptop-456'},
      },
    ]}
  >
    Add to Cart with Warranty
  </AddToCartButton>

• Updated dependencies [722915130410086bc7af22215ba57ee77aa14156]:

  • @Shopify/hydrogen@2025.10.1