🚀 One-click WordPress plugin development environment with hot reload!
Point to your plugin folder and get instant updates in the browser. Perfect for Windows users - no complex setup required!
- Download Node.js (if you don't have it): https://nodejs.org/
- Download this project as a ZIP file
- Extract the ZIP to any folder
- Double-click
install.bator runinstall.ps1in PowerShell - Double-click the desktop shortcut that gets created!
That's it! Your WordPress development environment is ready.
- Beautiful GUI App - Point-and-click interface
- Hot Reload - See changes instantly in browser
- TypeScript Support - Auto-compilation included
- SQLite Database - No MySQL setup needed
- WordPress Auto-Setup - Everything installed automatically
- BrowserSync - Live reloading across devices
- 🔥 Instant Hot Reload for PHP, JS, CSS, and TypeScript
- 🖥️ Professional GUI - Modern desktop application
- 🗄️ SQLite Database - Works perfectly in production
- 🎨 BrowserSync - Live reload with device sync
- 📝 TypeScript Ready - Automatic compilation
- 🛠️ WP-CLI Integration - Automated WordPress setup
- ⚙️ Auto PHP Installation - Downloads PHP automatically on Windows
npm run guiFeatures a beautiful interface with:
- System dependency checking
- Plugin folder selection
- Real-time status and logs
- One-click start/stop
- Direct browser launch
npx tpt-wp-dev start /path/to/plugin- Download the ZIP
- Extract anywhere
- Run
install.batorinstall.ps1 - Use the desktop shortcut!
npm install
npm run gui # Start GUInpm run build-win # Creates installer- Windows 10/11 (primary), macOS, or Linux
- Node.js 16+ (installer checks for this)
- PHP (automatically installed on Windows)
npm install
npm run guiThis opens the graphical interface for easy plugin development.
npm install -g .Or run locally:
npm install
npm link- Install PHP (7.4+) if not already installed
- Run:
npm run gui - Select plugin folder using the browse button
- Click "Start Development"
- Open browser at http://localhost:3000
- Install PHP (7.4+) if not already installed
- Clone or create a WordPress plugin in a folder
- Run the assistant:
tpt-wp-dev start /path/to/your/plugin/folder- Start developing - changes will appear instantly in your browser!
Try the included example plugin:
GUI: Click "Use Example" button
CLI: tpt-wp-dev start example-plugin
This creates a WordPress site with a simple plugin that demonstrates:
- PHP shortcode functionality
- JavaScript interactions
- CSS styling
- Hot reload for all file types
tpt-wp-dev start /path/to/your/plugin/folder# Custom ports
tpt-wp-dev start /path/to/plugin --port 3001 --wp-port 8081
# Help
tpt-wp-dev --help- Environment Setup: Downloads WordPress core and sets up SQLite database
- Plugin Integration: Copies your plugin to the WordPress environment and activates it
- Servers: Starts PHP development server and BrowserSync proxy
- File Watching: Monitors your plugin files for changes
- Hot Reload: Automatically syncs changes and refreshes the browser
If your plugin contains .ts files, the assistant will:
- Create a
tsconfig.jsonif one doesn't exist - Compile TypeScript files on change
- Sync compiled JavaScript to WordPress
- Provide hot reload for both source and compiled files
- Create/edit your plugin files (PHP, JS, CSS, TS)
- Changes are automatically detected
- TypeScript files are compiled (if applicable)
- Files are synced to the WordPress environment
- Browser automatically refreshes
wordpress-dev-env/ # Auto-generated WordPress installation
├── wp-content/
│ ├── plugins/
│ │ └── your-plugin/ # Your plugin files are copied here
│ └── database/ # SQLite database files
├── wp-config.php
└── ... # WordPress core files
- Site: http://localhost:3000
- Admin: http://localhost:3000/wp-admin
- Login: admin / password
Install PHP 7.4+ and ensure it's in your PATH.
Make sure you have write permissions in the current directory.
Use --port and --wp-port options to specify different ports.
Your plugin code remains unchanged and works with MySQL in production. The SQLite setup is only for local development.
MIT