@webburns/deploy

Git-like deployment workflows for FTP/SFTP hosting. Deploy, rollback, and manage websites on shared hosting with version control.

Webburns Deploy brings modern deployment workflows to developers who use FTP, FTPS, and SFTP-based hosting providers — without requiring Git knowledge.

Installation

CLI

npm install -g @webburns/deploy

Desktop App

Download the latest version for your platform from the Releases page:

| Platform | Download | |----------|----------| | 🪟 Windows | .exe installer or portable | | 🐧 Linux | .AppImage or .deb | | 🍎 macOS | .dmg or .zip |

Quick Start

cd your-project/
wb init              # Set up project with hosting credentials
wb status            # See what's changed
wb commit "message"  # Save your changes locally
wb deploy            # Deploy to your hosting provider

Commands

| Command | Description | |---|---| | wb init | Initialize a new project (interactive FTP setup) | | wb login | Authenticate with your Webburns Deploy account | | wb connect | Test connection to your hosting account | | wb status | Show modified files since last deployment | | wb diff [file] | Show detailed file changes (line-level diffs) | | wb commit <message> | Create a local commit | | wb push | Deploy latest commit (alias for wb deploy --latest) | | wb deploy | Deploy project to configured hosting environment | | wb compare | Compare local files against remote server | | wb history | Show deployment history | | wb rollback <id> | Rollback to a previous deployment | | wb logs | View deployment logs | | wb config | View and manage project settings | | wb doctor | Diagnose project health and connectivity | | wb backup | Manage project backups and snapshots | | wb ignore | Manage .wbignore rules | | wb env | Manage deployment environment profiles |

Deploy Command Flags

--latest          Deploy most recent commit
--full            Deploy entire project (bypass smart sync)
--dry-run         Preview deployment without uploading
--files <list>    Deploy only specified files (comma-separated)
--env <env>       Deploy to a specific environment
--force           Skip remote integrity check
--no-backup       Skip automatic snapshot

Subcommands

wb config

wb config view              Show current configuration
wb config set <key> <value> Update a setting
wb config edit              Open config in editor

wb backup

wb backup create            Create manual backup snapshot
wb backup list              List all snapshots
wb backup restore <id>      Restore from snapshot
wb backup export <id>       Export snapshot to portable file
wb backup import <file>     Import snapshot from file

wb ignore

wb ignore add <pattern>     Add ignore rule
wb ignore remove <pattern>  Remove ignore rule
wb ignore list              Show current rules

wb env

wb env list                 Show all environments
wb env add <name>           Add new environment
wb env remove <name>        Remove environment
wb env switch <name>        Switch active environment

Supported Hosting Providers

• InfinityFree
• Hostinger
• GoDaddy
• Namecheap
• cPanel (Generic)
• Any FTP/FTPS/SFTP host

Requirements

• Node.js >= 16.0.0

Contributing

1. Fork the repo
2. Create your feature branch (git checkout -b feature/awesome)
3. Commit your changes (git commit -m 'Add awesome feature')
4. Push to the branch (git push origin feature/awesome)
5. Open a Pull Request

License

MIT © WebburnsTech