@rnaga/wp-next-cli

WP-Next

📖 Full Documentation → rnaga.github.io/wp-next

For guides, concepts, and examples, the documentation site is the best starting point.

WP-Next is a TypeScript-first toolkit for building WordPress-powered Next.js applications — with a visual drag-and-drop editor, a modern React admin dashboard, and first-class AI support built in from day one.

Two Products, One Stack

WP-Next ships as two products you can use together or independently:

• WP-Next Editor — visual site builder with live preview, responsive breakpoints, dynamic WordPress data binding, and AI-powered template authoring. Includes Admin automatically.
• WP-Next Admin — standalone React admin dashboard you can adopt without the editor.

Use both as one stack, or start with Admin alone.

Quick Demo

Run a ready-made WP-Next Editor example using Docker. This is the recommended demo because it includes the editor and the admin dashboard in one setup:

docker run --rm --init -it --name wp-next-editor-example -p 3000:3000 \
  -v wp-next-editor_public:/app/editor/public \
  -v wp-next-editor_db:/var/lib/mysql \
  rnagat/wp-next-editor-example:latest

Log in with:

Username: wp
Password: wp

• Editor: http://localhost:3000/admin/1/editor
• Admin Dashboard: http://localhost:3000/admin

To stop the container:

docker stop wp-next-editor-example

Prerequisites

Both products require a running WordPress database. If you don't already have WordPress installed, see the WP-Node installation guide.

Getting Started

Choose the setup that matches what you want to build:

Build WP-Next Editor + Admin

Use this if you want the full WP-Next experience. This installs both packages, with WP-Next Admin included as part of the editor setup.

npx @rnaga/wp-next-cli -- initEditor

See the Editor Installation guide for the full setup walkthrough.

Build WP-Next Admin Only

Run this only if you want to start up WP-Next Admin without the visual editor:

npx @rnaga/wp-next-cli -- initAdmin

See the Admin Getting Started guide for the full setup walkthrough.

WP-Next Editor

WP-Next Editor is a visual, drag-and-drop website builder for building public-facing WordPress sites directly connected to your WordPress database. Templates and pages are stored as structured Lexical JSON in the WordPress database — making them version-controllable, programmatically manipulable, and AI-ready.

Key Features

• Drag-and-drop canvas — build pages visually with a live preview. Select, resize, nest, and animate elements directly on the canvas.
• Responsive design — set per-device breakpoints (desktop, tablet, mobile) and CSS states (hover, focus, etc.). Each device gets its own @media query at render time.
• Dynamic data binding — pull posts, users, taxonomies, and options directly from the WordPress database into any element. No custom API endpoints required.
• Widget system — embed sub-templates (widgets) inside other templates for reusable headers, footers, and components. Widget variants let the same widget render different content per embedding.
• CSS variables — define design tokens at the template level and reference them across all elements for consistent theming.
• Animations — attach CSS keyframe animations (98 Animate.css presets) to any element, triggered by hover, click, scroll, and more.
• JSON editor — edit the raw Lexical JSON directly in a built-in code editor for precise control over template structure.
• Save history — create and manage template save points with preview and restore support.

AI-Powered Template Authoring — Built-in Agent Skills

WP-Next Editor ships with a built-in Agent Skill (/wp-next-editor-template) that lets you build and modify templates using natural-language prompts. All templates are stored as Lexical JSON, so AI agents can read, write, and transform them directly.

Agent Skills is an open standard supported by Claude Code, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, VS Code, and more. Install the skill once and use it with whichever coding agent you prefer.

The skill supports four modes:

Mode	What it does
create	Scaffold a new template from a natural-language description
update	Modify an existing template based on a prompt
convert	Convert HTML/CSS into a Lexical JSON template
help	Describe available nodes, styles, and patterns

Install the skill with:

npx @rnaga/wp-next-cli -- editor agentSkills add

Example prompt:

/wp-next-editor-template create src/templates/home.json "A hero section with a full-width background image, centered headline, subtitle, and a CTA button"

See Using AI for installation details and more examples.

WP-Next Admin

WP-Next Admin is a React-based Admin Dashboard that serves as a modern alternative to the traditional WordPress Admin Dashboard. It can be used on its own, and it is also the admin layer that ships with WP-Next Editor.

Key Features

Out of the box, it includes:

• Posts & Pages
• Media
• Terms (Categories, Tags)
• Comments
• Profile & Settings
• Users and Roles
• Revisions

In multisite mode, it also supports:

• Sites
• Blogs (per-site content such as posts, media, comments)

Extensibility

WP-Next Admin supports custom pages and a hook system (filters and actions) inspired by WordPress hooks but built for TypeScript and Node.js. Frontend hooks extend the Admin UI in the browser; backend hooks handle server-side concerns such as authentication, media uploads, and integrations.

See Hooks and Custom Admin Pages in the documentation.

License

MIT