---
updatedAt: 2026-08-26T16:25:47.000Z
agentTools:
  projectIndex: https://dev.tapcart.com/llms.txt
---

# Tapcart CLI

Local CLI for building, previewing, and deploying Tapcart Custom Blocks.

<Image align="center" width="100% " src="https://files.readme.io/1f66e6f4efe534051683b9e54c622bdb7bd163ce9ecb51fb56d44e8b3fe42554-cli-tool.jpg" />

The Tapcart CLI lets developers build, preview, and deploy Custom Blocks and reusable components from a local environment.

<Callout icon="📘" theme="info">
  Custom blocks and the Tapcart CLI require the Tapcart Enterprise plan.
</Callout>

## Start here

* **[App Studio Quick Start](https://dev.tapcart.com/docs/app-studio-quick-start)** — build your first block end-to-end (install, auth, create, deploy).
* **[CLI Command Reference](https://dev.tapcart.com/docs/command-reference)** — every command, argument, and flag.

## Install

```bash
npm install -g @tapcart/tapcart-cli
tapcart --version
```

## Command groups

| Group                | What it does                                          |
| -------------------- | ----------------------------------------------------- |
| `tapcart auth`       | Log in / out of Tapcart                               |
| `tapcart project`    | Scaffold a new blocks project                         |
| `tapcart block`      | Create, preview, push, and version blocks             |
| `tapcart component`  | Create, preview, push, and version global components  |
| `tapcart dependency` | Manage npm dependencies for your app                  |
| `tapcart dev`        | Run the local dev server (block / component / layout) |
| `tapcart layout`     | Author and preview local mock layouts                 |
| `tapcart lint`       | Run ESLint on blocks and components                   |
| `tapcart types`      | Sync editor IntelliSense types                        |
| `tapcart log`        | Show local CLI logs                                   |
| `tapcart mcp`        | Start the Tapcart MCP server for AI clients           |

Run `tapcart -h` or `tapcart <command> -h` for full help on any command.