Setting up your development environment

Recommended software

There are some specific software requirements you will need to consider when developing WooCommerce extensions. The necessary software includes:

• Git for version control of your source code
• Node.js and nvm to manage node-based scripts and build processes
• Pnpm is an npm alternative required if you are building WooCommerce from the repository
• Composer is an optional dependency management tool for PHP-based development
• WP-CLI is the command line interface for WordPress

Most WordPress hosting environments do not include Node and Composer by default, so when distributing extensions and themes, it’s important to include all built assets.

Note: A POSIX compliant operating system (e.g., Linux, macOS) is assumed. If you're working on a Windows machine, the recommended approach is to use WSL (available since Windows 10).

Setting up a reusable WordPress development environment

In addition to the software shared above, you'll also want to have some way of setting up a local development server stack. There are a number of different tools available for this, each with a certain set of functionality and limitations. We recommend choosing from the options below that fit your preferred workflow best.

WordPress Studio - Recommended Approach

For easy local development environments, we recommend WordPress Studio, the local development environment supported by the WordPress.com team. Studio includes the ability to manage multiple local website environments, as well as integrations with your code editor and terminal. Studio also features a WordPress-specific AI Assistant, easy imports from WordPress backups, Blueprint support, free public preview sites, and two-way sync with sites hosted on WordPress.com or Pressable.

wp-env

wp-env is a command-line utility maintained by the WordPress community that allows you to set up and run custom WordPress environments with Docker and JSON manifests. The repository includes a .wp-env.json file specifically for contributing to WooCommerce core.

General PHP-based web stack tools

Below is a collection of tools to help you manage your environment that are not WordPress-specific.

• MAMP - A local server environment that can be installed on Mac or Windows.
• WAMP - A Windows web development environment that lets you create applications with Apache2, PHP, and MySQL.
• XAMPP - An easy-to-install Apache distribution containing MariaDB, PHP, and Perl. It's available for Windows, Linux, and OS X.
• Laravel Herd / Valet - A minimalist and fast development environment for macOS (Valet) and Windows (Herd), optimized for Laravel and other PHP applications.
• Lando - A powerful, Docker-based tool for defining and managing local development services across various languages and frameworks.
• DDEV - An open-source, Docker-based tool for streamlined local web development, supporting many CMS and frameworks like Drupal and WordPress.
• vvv is a highly configurable, cross-platform, and robust environment management tool powered by VirtualBox and Vagrant.

Minimum server requirements

Regardless of the tool you choose for managing your development environment, you should make sure it meets the server recommendations for WooCommerce as well as the requirements for running WordPress.

Add WooCommerce Core to your environment

When developing for WooCommerce, it's helpful to install a development version of WooCommerce Core.

Option 1: WooCommerce Beta Tester

If installing WooCommerce through the traditional WordPress dashboard, you can also install the WooCommerce Beta Tester extension to change the version, including access to upcoming betas and release candidates. The WooCommerce Beta tester is available through the Woo Marketplace.

Option 2: Clone the WooCommerce Core repository

You can also work directly against the trunk or upcoming release branch of WooCommerce Core in your development environment by:

1. Cloning the WooCommerce Core repository.
2. Installing and activating the required Node version and PNPM.
3. Installing WooCommerce’s dependencies.
4. Building WooCommerce.
5. Symlinking the plugin/woocommerce directory to your wp-content/plugins directory

Clone the WooCommerce Core repository

You can clone the WooCommerce Core repository locally using the following CLI command:

cd /your/server/wp-content/plugins
git clone https://github.com/woocommerce/woocommerce.git
cd woocommerce

Install and activate Node

It is recommended to install and activate Node using Node Version Manager (or nvm). You can install nvm using the following CLI command:

nvm install

You can learn more about how to install and utilize nvm in the nvm GitHub repository.

Install dependencies

To install WooCommerce dependencies, use the following CLI command:

pnpm install --frozen-lockfile

Build WooCommerce

Use the following CLI command to compile the JavaScript and CSS that WooCommerce needs to operate:

pnpm build

Note: If you try to run WooCommerce on your server without generating the compiled assets, you may experience errors and other unwanted side-effects.

Symlink the WooCommerce plugin

To load the WooCommerce plugin into your local development environment, you can create a symbolic link from the WooCommerce plugin in your cloned repository to your local WordPress development environment.

ln -s woocommerce/plugins/woocommerce /path-to-local/wp-content/plugins

Generating a woocommerce.zip asset

Alternatively, you can generate a woocommerce.zip file with the following command:

pnpm build:zip

A woocommerce.zip file may be helpful if you’d like to upload a modified version of WooCommerce to a separate test environment.