AI Assistant

Start Project

Make sure Docker is running before you start. Commands will fail if Docker is not active.

File Structure

  • src/theme/ - PHP/HTML template files for the WordPress theme.
  • src/plugins/ - Custom WordPress plugins.
  • src/assets/css/ - CSS stylesheets.
  • src/assets/fonts/ - Font files.
  • src/assets/img/ - Image assets.
  • src/assets/js/ - JavaScript files.

Configuration files, Docker files, and build scripts live in the project root.

Change Template Name

Rename .env_example to .env and set your theme name:

# If you want to connect to BrowserSync on a different port. Default: 3010
PROXY_PORT=3010

# Theme name. Default: "wordpressify"
THEME_NAME=wordpressify

This name is used for the theme directory in WordPress and in the exported zip file.

Start Workflow

1

Start the development server

npm run start

If Node.js is not installed locally, use Docker directly:

docker compose up
2

Rebuild environment

To rebuild with a fresh WordPress installation and clean database:

npm run rebuild

Without local Node.js:

docker compose down -v && docker compose build
3

Add WordPress plugins

Place custom plugins in the src/plugins/ directory. They are automatically copied into the WordPress plugins folder during the build.

4

Export for production

Generate optimized distribution files:

npm run export

Without local Node.js:

docker compose run --rm nodejs npm run prod

The theme is saved as a zip file in dist/wordpressify.zip.