@wp-operations/wp-app

A zero-config local WordPress dev server on @php-wasm/node: no Docker, no MySQL, no XAMPP. Point it at a theme, a plugin, a full core checkout, or a wp-app project, and it starts.

Install

npm install -g @wp-operations/wp-app

Requires Node.js >= 20.10.

Usage

wp-app start
wp-app start --path=my-app
wp-app start --php=8.3 --wp=6.8
wp-app start --wp=classicpress
wp-app start --port=8881 --reset
wp-app dev
wp-app build
wp-app install
wp-app update
wp-app create my-app
wp-app php -- -r 'echo PHP_VERSION;'
wp-app php -- script.php

Login: admin / password.

Modes

Auto-detected from the project directory, or forced with --mode. Checked in this order — first match wins:

| Mode | Detected when | What runs | |------|--------------|-----------| | wp-app | composer.json with "type": "wp-app" | wp-app | | wordpress | Full WordPress core checkout | Your core served directly, SQLite-backed | | classicpress | Full ClassicPress core checkout | Your core served directly, SQLite-backed | | wp-content | plugins/ + themes/ dirs | Managed WP + your entries overlaid on wp-content | | plugin | PHP file with a Plugin Name header | Managed WP + your directory mounted as a plugin, auto-activated | | theme | style.css with a Theme Name header | Managed WP + your directory mounted as a theme, auto-activated | | index | An index.php | Plain PHP server, no WordPress |

License

GPL-2.0-or-later. Continues the workflow of @wp-now/wp-now by the WordPress contributors, rebuilt on @php-wasm/*.