WooCommerce Development Cycle

This skill provides guidance for the WooCommerce development workflow, including running tests, code quality checks, and troubleshooting.

Prerequisites

IMPORTANT: Always run nvm use before executing any pnpm, npm, or npx commands. This ensures the correct Node.js version is active. Prepend nvm use && to all node-based commands (e.g., nvm use && pnpm run test:php:env).

Instructions

Follow these guidelines for WooCommerce development workflow:

1. Running tests: See running-tests.md for PHP and JavaScript test commands, test environment setup, and troubleshooting
2. Code quality: See code-quality.md for linting and code style fixes
3. PHP linting patterns: See php-linting-patterns.md for common PHP linting issues and fixes
4. JS/TS i18n patterns: See js-i18n-patterns.md for translatable string patterns and placeholder usage
5. Markdown linting: See markdown-linting.md for markdown file linting and formatting

Development Workflow

The standard development workflow:

1. Make code changes
2. Run relevant tests: nvm use && pnpm run test:php:env -- --filter YourTestClass
3. Run linting/type checking: nvm use && pnpm run lint:changes:branch:php
4. Fix any issues: nvm use && pnpm run lint:php:fix
5. Commit changes only after tests pass

Key Principles

• Always run tests after making changes to verify functionality
• Use specific test filters to run relevant tests during development
• Fix linting errors solely for code in your current branch
• Test failures provide detailed output showing expected vs actual values
• The test environment handles WordPress/WooCommerce setup automatically