Turborepo monorepo for WordPress plugins and tooling, using pnpm workspaces.
| Package | Description | Docs |
|---|---|---|
| admin-ui | Shared React admin UI components (useSettings, SettingsShell, DiagnosticsPanel, FormSection, AlertBox, InfoPopover, SecretField) | README |
| wpts | TypeScript-to-WordPress-Plugin transpiler | README |
| headless-auth | OTP and password authentication with JWT for headless WordPress | Integration · Admin |
| headless-fuzzy-find | Weighted, fuzzy WooCommerce product search with autocomplete (built with wpts) | Integration · Admin |
| headless-meta-pixel | Meta Pixel with WooCommerce CAPI integration for headless WordPress (built with wpts) | Integration · Admin |
| headless-umami | Umami Analytics with WooCommerce purchase tracking for headless WordPress (built with wpts) | Integration · Admin |
| headless-google-analytics | Google Analytics (GA4) with WooCommerce Measurement Protocol for headless WordPress (built with wpts) | Integration · Admin |
| headless-clarity | Microsoft Clarity session recordings and heatmaps for headless WordPress (built with wpts) | Integration · Admin |
| headless-pos-sessions | POS register session storage with REST API for headless WordPress (built with wpts) | Integration · Admin |
| headless-wishlist | REST API wishlist for headless WordPress/WooCommerce (built with wpts) | Integration · Admin |
| headless-orders | REST API for authenticated customers to list their WooCommerce orders (built with wpts) | Integration · Admin |
| website | Landing page and plugin catalog (Astro 6 + Tailwind CSS 4) | Live site |
| e2e | Playwright end-to-end tests for all plugins (wp-env) | README |
- Architecture Guide — Package relationships, build pipeline, creating new plugins
- Plugin docs — Each plugin has Integration and Admin guides (see Docs column above)
- wpts Transpiler — CLI, decorators, transpilation rules (full docs)
Each plugin is released independently via GitHub Releases. Download the plugin ZIP from the latest release and install via Plugins > Add New > Upload Plugin in WordPress admin.
Releases are managed through a workflow_dispatch workflow that handles version bumping, changelog generation, and ZIP asset upload.
pnpm install
turbo run build
turbo run testRun a script in a specific package:
pnpm --filter wpts test
pnpm --filter headless-auth buildRequires Docker for the wp-env WordPress instance.
pnpm test:e2e # Run all e2e tests
pnpm --filter e2e test:ui # Playwright UI modeBiome handles linting and formatting across the monorepo.
pnpm lint # Lint all packages (via turbo)
pnpm check # Lint + format check all packages (CI)
pnpm format # Auto-format entire monorepo
pnpm biome check --write . # Fix all auto-fixable lint + format issuesSee CONTRIBUTING.md for development setup, commit conventions, and PR guidelines.
Each package includes a CLAUDE.md with architecture details, conventions, and references for AI-assisted development. The root CLAUDE.md covers monorepo-wide commands, commit format, and Claude Code agents/skills.
This project is licensed under GPL-2.0-or-later, consistent with the WordPress ecosystem. The wpts transpiler is licensed under MIT.
- Node.js >= 20
- pnpm >= 9