Development toolkit for setting up and managing your local WordPress Theme/Plugin
Last updated 5 months ago by wordup .
GPL-3.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install wordup-cli 
SYNC missed versions from official npm registry.

Wordup CLI


Version Downloads/week Wordup docs Twitter Follow

Wordup CLI is an open-source development toolkit for setting up and managing your local WordPress Theme/Plugin development, so that you can totally focus on coding.

It is based on docker-compose and uses a docker containerized LAMP-stack with all WordPress Plugins/Themes you need for your current project.


What you can do with wordup-cli:

  • ????Rapidly test new ideas - And develop your new WordPress theme/plugin projects in wordup.
  • Speed up your development - Install a new project with a blank WordPress installation in a matter of minutes
  • ????️Boilerplate - Scaffold your theme/plugin with the official source code from WordPress (e.g. underscore). You can also add code snippets like Gutenberg blocks to your source code.
  • ⚙️Automatic installation of dependencies - Automatically download and activate public WordPress Plugins/Themes or even Github hosted projects (like e.g. wp-graphql)
  • ????Fixtures - Add posts, pages, media files and many more automatically to your WordPress installation and develop immediately with your own page structure
  • ????Easy portability - Export your theme/project or your whole WordPress installation. So that you can install it on a remote server.
  • ????Backup your installation - And (re)install a project from an exported wordup project.
  • ????Hassle-free remote WordPress connection - Install your project, based on an existing WordPress hosted website (with the wordup-connect plugin). Use this feature for example to test major WordPress updates with ease locally.
  • ????Share your stack - wordup is the easiest way to share your WordPress project with the world or just your team members. Just type: git clone, and then wordup install
  • ✉️Catch emails - Catch all emails from WordPress and view the outgoing emails in a web UI


Checkout this VIDEO on our website to see how fast you can setup a new WordPress dev environment.

Installation / Requirements

Make sure you have node >= 8.3 (npm >= 5.2) and docker-compose installed on your machine.

We recommend to install wordup-cli globally:

$ npm install -g wordup-cli

After installing wordup-cli, you can create your first project with wordup init

If you don't want to install wordup-cli globally, you can also use wordup-cli as a devDependency via npx. Start directly with a new wordup project:

$ npx wordup-cli init

npx wordup-cli init will add automatically the wordup-cli to your new project devDependencies.

Note: If you use wordup-cli as a devDependency make sure to always use npx before every wordup command.


For detailed information visit docs.wordup.dev


$ npm install -g wordup-cli
$ wordup COMMAND
running command...
$ wordup (-v|--version|version)
wordup-cli/0.7.3 darwin-x64 node-v10.15.0
$ wordup --help [COMMAND]
  $ wordup COMMAND


wordup export TYPE

Export your plugin/theme or the whole WordPress installation

  $ wordup export TYPE

  TYPE  (src|installation|sql) [default: src] What type do you want to export

  --logs  Shows all stdout logs of this process

  The exported zip-file of a plugin/theme are ready for distribution.
  An exported installation file can be used for setting up a remote WordPress installation or
  for backing up your current development stack.

See code: src/commands/export.js

wordup help [COMMAND]

display help for wordup

  $ wordup help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

wordup init

Create a new wordup project in the current directoy

  $ wordup init

  --[no-]autoinstall                  Automatically install wordup project after init
  --name=name                         A name for the new project
  --type=plugins|themes|installation  What type of WordPress project

  After you have initialized a new project, 'wordup install' will be called automatically, as a postinstall script in 
  your package.json. 
  You can stop this behavior with --no-autoinstall

See code: src/commands/init.js

wordup install

Install and start the WordPress development server

  $ wordup install

  -p, --port=port            [default: 8000] Install on a different port
  --archive=archive          Install from a wordup archive.
  --connect=connect          Install from a WordPress running website.
  --logs                     Shows all stdout logs of this process
  --private-key=private-key  Private key for the wordup-connect plugin
  --prompt                   If you want to do the setup again
  --siteurl=siteurl          Specify a custom WordPress site url. Use --help for details.

  If there is no wpInstall config in .wordup/config.yml, a setup for your installation will be shown.
  You can set a custom site url for WordPress, but please be aware that you have to proxy this url to your 

  The web frontend for the catched emails (MailHog) is available on localhost:[WORDPRESS_PORT + 1]

  Wordup will assign automatically a different default port, if the default port of 8000 is taken by another wordup 

  Note: Flags in this command overrule the wordup config.yml.

See code: src/commands/install.js

wordup list

List all executable wordup projects

  $ wordup list

  --clear  Clears the project list from non-existing projects

  If you see deleted projects in this list, run with --clear flag.

  $ wordup ls

See code: src/commands/list.js

wordup snippet TYPE NAME

Add code snippets like Gutenberg blocks, custom post types or taxonomies to your code

  $ wordup snippet TYPE NAME

  TYPE  (block|post-type|taxonomy) What type do you want to add to your project
  NAME  Name of the element you want to add

  --logs  Shows all stdout logs of this process

  This code snippets will be added to your current project source code. You can add as many as you want.
  Just include the generated php file in your main project file.

  As an example: wordup snippet block MyGutenbergBlock

See code: src/commands/snippet.js

wordup start

Start the WordPress development server

  $ wordup start

  -p, --port=port  Overwrite installed port
  --logs           Shows all stdout logs of this process

  You can run only this command if your development stack is installed.

  $ wordup run

See code: src/commands/start.js

wordup stop

Stop the development server

  $ wordup stop

  -d, --delete           Deletes all attached volumes/data (WARNING: Your content in your WordPress installation will be

  -p, --project=project  A project slug name

  --logs                 Shows all stdout logs of this process

  Optionally you can use -d to delete the whole installation, this includes all files in your WordPress installation.

See code: src/commands/stop.js

wordup wpcli COMMAND

Use an official WordPress CLI command on the current running project

  $ wordup wpcli COMMAND

  COMMAND  the wp cli command

  --logs  Shows all stdout logs of this process

  As an example: wordup wpcli post list

See code: src/commands/wpcli.js


Checkout the interactive tutorial on Google Cloud Shell:

Open in Cloud Shell

Wordup for Visual Studio Code

If you use VSCode for your development, you can install our VSCode extension. This extension will integrate all wordup features in your favorite editor.

Learn more

To learn more about wordup in general, visit: https://wordup.dev

License / Contributing

wordup-cli is an open-source project. If you are interested in contributing to wordup-cli, fell free to join us.

See the LICENSE file for details.

Current Tags

  • 1.0.0-alpha.7                                ...           alpha (a month ago)
  • 0.7.3                                ...           latest (5 months ago)

35 Versions

  • 1.0.0-alpha.7                                ...           a month ago
  • 1.0.0-alpha.6                                ...           2 months ago
  • 1.0.0-alpha.5                                ...           2 months ago
  • 1.0.0-alpha.4                                ...           2 months ago
  • 1.0.0-alpha.3                                ...           2 months ago
  • 1.0.0-alpha.2                                ...           2 months ago
  • 1.0.0-alpha.1                                ...           2 months ago
  • 1.0.0-alpha.0                                ...           2 months ago
  • 0.7.3                                ...           5 months ago
  • 0.7.2                                ...           6 months ago
  • 0.7.1                                ...           6 months ago
  • 0.7.0                                ...           6 months ago
  • 0.6.2                                ...           6 months ago
  • 0.6.1                                ...           7 months ago
  • 0.6.0                                ...           7 months ago
  • 0.5.0                                ...           7 months ago
  • 0.4.0                                ...           7 months ago
  • 0.3.0                                ...           7 months ago
  • 0.2.9                                ...           8 months ago
  • 0.2.8                                ...           8 months ago
  • 0.2.7                                ...           8 months ago
  • 0.2.6                                ...           8 months ago
  • 0.2.5                                ...           8 months ago
  • 0.2.4                                ...           8 months ago
  • 0.2.3                                ...           8 months ago
  • 0.2.2                                ...           8 months ago
  • 0.2.1                                ...           8 months ago
  • 0.2.0                                ...           9 months ago
  • 0.1.7                                ...           9 months ago
  • 0.1.6                                ...           9 months ago
  • 0.1.5                                ...           9 months ago
  • 0.1.4                                ...           9 months ago
  • 0.1.3                                ...           9 months ago
  • 0.1.2                                ...           9 months ago
  • 0.1.0                                ...           9 months ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 14
Dependencies (17)
Dev Dependencies (10)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |