Tapcart CLI

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