TYPESCRIPT · WORDPRESS CI/CD
wp-theme-check-cli — Automated CI/CD Security, Accessibility & Standards Scanner for WP Themes
wp-theme-check-cli is a fast TypeScript CLI that audits WordPress Classic and Full-Site Editing (FSE) Block themes against official WordPress.org security, escaping, and theme.json standards. It runs in GitHub Actions or local pre-commit hooks with zero PHP database setup required.
$ npx wp-theme-check-cli ./my-theme
Copy
GitHub ↗
Audit Speed
18 ms / Theme
theme.json Schema
v2 & v3 Validated
Security Rules
XSS / Nonce / Escaping
Output Formats
Terminal / SARIF / JSON
01. Interactive Workbench
02. Reference Implementation
03. Architecture & Specs
Interactive WordPress Block Theme & `theme.json` Security Gate
Theme Template or `theme.json` Snippet to Audit
Quality Gate Profile
Full WordPress.org Theme Review + Block Theme FSE Schema Gate
Security Focus — Detect unescaped `echo $_GET` / missing `esc_html()`
Performance Audit — Flag render-blocking scripts & missing font preloads
GitHub Actions SARIF 2.1.0 Code Scanning Report
Execute Pipeline ▶
Reset
Deterministic Execution Output & Telemetry
STATUS: READY // 0 ERRORS
TypeScript (Theme Check Runner)
import { auditThemeDirectory } from 'wp-theme-check-cli';
const report = await auditThemeDirectory('./themes/swiss-modernist', {
schemaVersion: 3,
failOnWarnings: false,
checkEscaping: true,
});
if (!report.passed) process.exit(1);
Production Engineering Specifications
Repository: https://github.com/bhubbard/wp-theme-check-cli
Live Studio: https://code.brandonhubbard.com/wp-theme-check-cli/
Portal: https://code.brandonhubbard.com/
Install: npx wp-theme-check-cli ./themes/swiss-modernist
Design System: Brandon Hubbard Swiss Modernist (#0A0A0C / 1px Exposed Structural Grid)