WP AdminCSS is the framework I wished existed when I started building WordPress plugins. It bundles the three things every plugin needs — native admin design, security patterns, and AI-agent-readable docs — into one cohesive system.

v0.1.0 is the first public release. Everything below is in the box, open source, free.

Three runtimes — pick your level

• @wp-admincss/core-css — drop a <link> tag into your plugin admin page and you're done. Full WordPress admin CSS bundle, plus an extensions layer for modern patterns WP core doesn't ship (status badges, stat cards, toggle switches, skeleton loaders, dropdowns, modals).
• @wp-admincss/tokens — 50+ CSS custom properties for colors, spacing, typography. Responds to all 9 WP admin color schemes (Default, Blue, Coffee, Ectoplasm, Midnight, Ocean, Sunrise, Light, Modern). Inherit the user's preference automatically.
• @wp-admincss/react — typed React components rendering real WordPress admin class names. No styled-components, no runtime CSS-in-JS.
• wp-admincss/composer — PHP render helpers (PSR-4) for server-rendered admin pages.

All four packages emit identical WordPress-native HTML. Same markup, same security expectations, same component set.

Real WordPress class names — not a prefix

Other "WordPress admin component libraries" invent their own class prefix (.wpac-button--primary). WP AdminCSS uses the actual WordPress class names — .button, .notice, .wp-list-table, .postbox, .form-table. The result is plugin admin pages that look indistinguishable from native WordPress screens.

Security by default

Every PHP example in the framework demonstrates the patterns plugin reviewers expect: capability check, nonce verification, sanitize on input, escape on output, prepared SQL. The boilerplate (below) ships with these built in.

Built for AI agents

Three artifacts at cdn.wp-admincss.com that any coding agent (Claude, Cursor, Aider, Cline) can fetch in one go:

• AGENTS.md — the master entry point. Framework overview, anti-patterns to avoid, component cheat sheet, the 9-step plugin-building recipe.
• 7 focused skill files — each loaded on demand: security.md (caps + nonces + sanitize/escape + SQL), database.md ($wpdb + dbDelta), data-modeling.md (options vs meta vs custom tables vs transients), enqueue.md (the four enqueue hooks), plugin-structure.md (PSR-4, lifecycle hooks), i18n.md (translations, RTL), publishing.md (Plugin Check, WP.org submission).
• Plugin boilerplate — a complete working WordPress plugin: secure settings page, custom table with dbDelta migration, typed repository, REST endpoint with schema validation, lifecycle hooks, multisite-aware uninstall, PSR-4 autoloading, i18n setup. Clone, find-replace the names, ship.

Interactive documentation

The site you're reading. /components — 25+ primitives across 10 categories with HTML / AI Prompt / React / PHP copy tabs and live previews scoped to the docs page. /layouts — four full plugin admin templates (Settings, List Table, Dashboard, Onboarding) with the same four-tab recipe. /docs — install paths, core concepts, customizing, the agent recipe, skills reference, boilerplate walkthrough.

Open source

Apache 2.0 for the framework. GPLv2-or-later for packages/core-css (which bundles WordPress core admin CSS — itself GPL) and the boilerplate (WordPress plugin convention). Apache 2.0 → GPL is one-way compatible, so plugins built from the boilerplate can incorporate every package without conflict. See NOTICE for the full attribution.

How to get started

One line into your plugin admin page:

<link rel="stylesheet" href="https://cdn.wp-admincss.com/css/latest.css">

Then use real WordPress admin class names. Or clone the boilerplate. Or point your AI agent at cdn.wp-admincss.com/AGENTS.md. Read the docs for the full guide.

Thanks

Built by Artificial Poets. Feedback, bugs, and PRs: github.com/artificialpoets/wp-admincss.