Getting Started
Prerequisites
| Requirement | Details |
|---|---|
| Node.js 24.15+ | Download Node.js if you don't have it |
| npm | Comes with Node.js |
Install
npm install -g @tiendanube/cli
Verify the installation:
tiendanube --version
tip
You can use either tiendanube or nuvemshop — both commands are identical.
Choose your workflow
The Tiendanube/Nuvemshop CLI supports two ways to sync theme files. Compare the capabilities and pick the one that fits your setup:
| Feature | FTP (legacy) | Fork |
|---|---|---|
| Pull / Push / Watch | Yes | Yes |
| Installation management | No | Yes |
| Fork / Clone / Publish | No | Yes |
| Preview URLs | No | Yes |
| Authentication | FTP credentials | Bearer token |
| Theme support | All themes | Ipanema only |
| Workflow | Best for | Guide |
|---|---|---|
| Fork | Ipanema theme — full installation management, bearer-token auth | Fork workflow |
| FTP (legacy) | Legacy themes with FTP enabled — simple file sync over FTP | FTP Workflow (legacy) |
danger
The Fork workflow is available only for the Ipanema theme, which is still being rolled out and may not be available to every store yet. If your store uses a legacy theme with FTP enabled, use the FTP workflow (legacy) — the fork workflow does not apply to legacy themes.