Wordless GEM (favourite)

The quickest CLI tool to setup a new WordPress locally. Wordless ready.

No prerequisites. Just joy.

Navigate to to discover the tool and set up all you need for local development. In less than 2 minutes ;)

If you already have a WordPress installation and just want to add Wordless to it, read the following paragraph.

(Not so) Manual

At the end of the installation process you will have

  • a plugin - almost invisible: no backend page, just wp-cli commands
  • a theme - where you will do all of the work


  1. Node. Depending on the Wordless version you’ll need a specific Node version. Read more at Nodejs page.
  2. WP-CLI
  3. Global packages from NPM: npm install -g foreman yarn [1] [2]
  4. WordPress installed and configured as per official documentation
  5. Composer brew install composer
  6. If you’d like to enable the mail-catcher while developing, install MailHog. On MacOS this is as simple as brew install mailhog. Wordless will do the rest.


We don’t know if you have a local apache {M,L,W}AMPP instance or whatever in order to perform the official installation process. Keep in mind that Wordless’s flow does not need any external web server, since it will use the wp server command to serve your wordpress.

See also




We consider that you have WordPress already up and running and you are in the project’s root directory in your terminal.

  1. Install and activate the wordpress plugin

    wp plugin install --activate wordless
  2. Scaffold a new theme

    wp wordless theme create mybrandnewtheme

See also

CLI for info about wp-cli integration

  1. Enter theme directory

    cd wp-content/themes/mybrandnewtheme
  2. Setup all the things

    yarn setup
  3. Start the server - and the magic

    yarn run server

Webpack, php server and your browser will automatically come up and serve your needs :)

Acceptance tests

To run acceptance test suite start the test server in one terminal

yarn test:server

and in another terminal let’s actually run tests:

yarn test

See also

Development environment to understand how the magic works


It is possible that your OS asks you to allow connections on server ports (3000 and/or 8080). It’s just ok to do it.