Tapcart CLI

v3.0.3 (2026-09-24)

Version 3.0.3 of the Tapcart CLI includes a fix for the Tapcart adapter to ensure it provides stable empty theme and data states during development. This update improves reliability when working with the adapter, ensuring consistent behavior even when data is absent.

v3.0.2 (2026-09-24)

The Tapcart CLI version 3.0.2 introduces several fixes to improve consistency, including standardized component key rules across commands and accurate folder labeling for version lookups. Additionally, this release updates block folder naming conventions to match CLI standards and aligns runtime adapters for wishlist and quick-add features with SSR.

v3.0.1 (2026-09-23)

Version 3.0.1 of the Tapcart CLI introduces support for app Badge configurations in dev previews by exposing them via tapcartData.badge. This release also includes a fix to properly resolve and inherit project component references, improving stability for development workflows.

v3.0.0 (2026-09-15)

Version 3.0.0 of the Tapcart CLI introduces a self-update feature that automatically checks npm for newer versions and notifies users of release notes. This release also improves the development client by injecting apiUrl and assetsUrl directly into tapcartData, and resolves issues related to component label retrieval and manifest configuration handling.

v2.3.1 (2026-08-26)

Version 2.3.1 of the Tapcart CLI introduces support for Blockdev projects. This update includes improvements to resolve the block-utils watch path and adds a shared action log to streamline development workflows.

v2.3.0 (2026-08-26)

This release includes a fix to prevent CLI source code from being embedded in the npm tarball, resulting in a cleaner package. It also includes internal CI/CD improvements to harden the release process.

v2.1.1 (2026-08-25)

This release updates the @tapcart/mobile-components dependency to version 0.18.1. Please ensure your project is compatible with this latest version of the mobile components package.

v2.0.1 (2026-07-22)

Tapcart CLI version 2.0.1 includes an update to @tapcart/mobile-components (v0.16.1) and upgrades the Shopify dev-server API version to 2026-07. This release also improves the developer experience and fixes an issue where slashes in block names were not handled correctly. Additionally, internal processes for publishing release notes have been streamlined.

v1.1.3 (2026-05-29)

This release updates the @tapcart/mobile-components dependency to version 0.12.17. Please refer to the full changelog for further details on this update.

v1.1.2 (2026-05-28)

This release introduces a new block ID flag and adds linting for console commands within blocks and components. It also includes a migration to the M2 runtime, an update to the App Studio renderer, and fixes for configuration errors during pull -a commands. Additionally, this update addresses TypeScript compiler (TSC) issues to improve overall stability.

v1.1.1 (2026-05-14)

This release updates the @tapcart/mobile-components dependency to version 0.12.14. You can review the full list of changes in the official changelog.

v2.0.0 (2026-07-09)

A major update to the block development experience — faster local previews, layout authoring without leaving your editor, and richer autocomplete.

What's New

Redesigned local preview — a device-frame preview with in-app switching between blocks, layouts, and products/collections, no more restarting the dev server to change what you're looking at.
Local layout editing — build and preview full-screen layouts locally (add/remove/reorder blocks, manage tabs) before pushing anything live, with a side-by-side local-vs-live comparison view.
Mock data support — drop a mockData.json into your project to preview blocks and layouts with your own cart, customer, product, and collection data.
Editor autocomplete — tapcart types sync brings full IntelliSense for block props and hooks into your editor.
tapcart project create — scaffold a new project (replaces the old create-tapcart-app).
Shell tab-completion — tapcart completion for Zsh/Bash.
Custom push messages — add a note to your update with --message/-m when pushing a block or component.
Automated linting on push — get a heads-up about lint issues when you push, without being blocked.

Breaking Changes

pull, push, and versions commands for blocks/components now take the block or component name/ID directly (e.g. tapcart block pull MyBlock) instead of --id/-b/-c flags.
The old block dev, component dev, and layout dev commands are replaced by a single tapcart dev command.
create-tapcart-app is retired — use tapcart project create.

Fixes

More reliable version pulling and clearer error messages when something goes wrong.
Smoother scrolling, dragging, and switching between blocks in the local preview.

v1.0.23 (2026-01-21)

The latest update includes a fix for an undefined error in the useCart function, improving stability for developers using this feature. Additionally, the release flow has been updated to streamline the deployment process. For a detailed list of changes, refer to the full changelog.

v1.0.20 (2026-01-20)

The latest update to the Tapcart CLI introduces an improvement in the documentation search tool, specifically by performing an additional HTML fetch to enhance search accuracy. This change was implemented by contributor @andyt338. For a detailed overview of all modifications, refer to the full changelog linked in the release notes.

v1.0.18 (2026-01-16)

The latest update introduces a new tool, tapcart_docs_search, added by contributor @andyt338. This enhancement is part of the ongoing improvements to the Tapcart CLI. For a complete list of changes, refer to the full changelog linked in the release notes.

v1.0.19 (2026-01-16)

The latest update introduces a new tool to the Tapcart CLI, specifically the "mcp tools list" tool, contributed by @andyt338. This addition enhances the functionality available to developers using the CLI. For a detailed overview of all changes, refer to the full changelog linked in the release notes.

v1.0.17 (2026-01-15)

The latest update to the Tapcart CLI includes the addition of testing capabilities, enhancements to the telemetry documentation, and updates to the MCP server. These changes aim to improve the overall functionality and documentation for developers using the CLI. For a detailed overview of all modifications, refer to the full changelog.

v1.0.2 (2025-08-07)

The latest update introduces a feature that displays toasts when actions are called within the Tapcart SDK, enhancing user feedback during interactions. This improvement was contributed by new contributor @peytonriley18. For more details, refer to the full changelog linked above.

v1.0.1 (2025-08-05)

The latest update to the Tapcart CLI includes updated documentation and a version bump. These changes were implemented by @chinitotuchman, as detailed in the pull requests #82 and #83. For a complete overview of the modifications, refer to the full changelog.

v1.0.0 (2025-08-04)

The latest update to the Tapcart CLI introduces several changes and fixes. The automation for the README has been improved with the use of .cjs files and fixes for the ReadMe automation and repository tag. Additionally, the 'create' functionality has been refactored. A significant breaking change is that CLI projects must now be initialized using the command npx @tapcart/[email protected] create-tapcart-app.

v0.3.1 (2025-07-30)

tapcart block dev now shows side by side preview of the live version of the block

v0.3.0 (2025-07-29)

component, block, and layout commands no longer support positional arguments
- block arguments are now behind the --block-folder-name|-b flag
- component arguments are now behind the --component-folder-name|-c flag
- layout types are now behind the --layout-type|-l flag
improved QoL changes for layout, component, block selectors.

v0.2.2 (2025-07-26)

fixed dependency check when using tapcart dependency add

v0.2.1 (2025-07-25)

added --quiet|-q , --verbose|-V arguments
fixed a timeout issue in layout dev command
improved error messaging

v0.2.0 (2025-07-24)

added supports for layouts
- tapcart layout dev <page-type>
- Full documentation available via CLI help menu
changed authentication callback server port from 3000 -> 3001.

v0.1.0 (2025-07-01)

added support for custom dependencies
added support for components