FTP Workflow (legacy)
The Fork workflow offers richer features (installation management, preview URLs, fork/clone/publish) but currently supports only the Ipanema theme. For all other themes, the FTP workflow (legacy) is the way to go.
The Tiendanube/Nuvemshop CLI supports syncing theme files over FTP. All FTP commands are under the theme ftp group:
tiendanube theme ftp <command>
Setup
Configure your FTP connection:
tiendanube theme ftp setup \
--ftp-server FTP_HOST \
--ftp-username FTP_USER \
--ftp-password FTP_PASSWORD \
--store-url https://yourstore.mitiendanube.com
The CLI tests the FTP connection and saves the credentials to your .nube config file.
Options
| Option | Description |
|---|---|
--ftp-server <host> | Required. FTP server hostname |
--ftp-username <user> | Required. FTP username |
--ftp-password <pass> | Required. FTP password |
--store-url <url> | Required. Your storefront URL |
-y | Skip confirmation prompts |
-v | Enable verbose output |
You can find your FTP credentials in the store admin panel. Look for the "Open FTP" option in the theme settings.
Pull
Download theme files from the FTP server:
tiendanube theme ftp pull
Options
| Option | Description |
|---|---|
-y | Skip confirmation prompts |
-v | Enable verbose output |
Push
Upload local theme files to the FTP server:
tiendanube theme ftp push
Options
| Option | Description |
|---|---|
-y | Skip confirmation prompts |
-v | Enable verbose output |
Watch
Watch local files and sync changes to FTP on save:
tiendanube theme ftp watch
Like the Theme watch mode, this monitors your local files and pushes changes automatically. It also handles file deletions. By default, it opens a browser window pointed at your storefront and reloads it after each successful sync. Use --no-browser to skip that.
Options
| Option | Description |
|---|---|
--no-browser | Don't open or reload a browser window |
-v | Enable verbose output |