A reimagined WordPress admin experience. Fast, focused and beautiful.
Minn Admin serves a modern, minimal dashboard at /minn-admin/ on your WordPress site. It's a
single-page app built on the WordPress REST API with no React, no build step, and one
vanilla-JS file. It lives alongside the classic wp-admin, which stays fully available.
- Overview — stat cards, a real Traffic chart with hover details when an analytics plugin
is installed (Koko Analytics, WP Statistics, Burst, Independent Analytics, AnalyticsWP, or
Google Analytics through Site Kit), click a bar for that day's top pages and referrers
(Koko, WP Statistics, Burst and Independent Analytics today; others join via
minn_admin_traffic_day), and a recent-activity feed - Content — posts, pages and custom post types sorted by publish date (scheduled posts lead with their go-out dates), with search, category/tag filters, status pills, bulk actions (set status or trash, with shift-click range select), and row actions: right-click or hover for quick publish/draft/trash, view, and a block-editor escape
- Media — grid/list library, uploads, drag-and-drop, a preview overlay with arrow-key navigation and in-place title, alt text, caption & description editing, bulk select and delete (shift-range, on the grid and the list), a right-click menu, and a built-in image editor (rotate and crop, saved as a new copy). Folders arrive from your folder plugin (FileBird, Real Media Library or Folders by Premio) with a Move to folder bulk action through each plugin's own machinery; an Unattached filter and a month picker cover the daily cleanup questions; every file's detail names the post it is attached to, one click from that post's editor; Replace file works in place through Enable Media Replace; the SVG filter tab appears with Safe SVG or SVG Support active, and ↻ Thumbnails works through Regenerate Thumbnails or Force Regenerate Thumbnails
- Comments — full moderation (pending / approved / spam / trash) with bulk moderation (each tab offers its own verbs), inline replies and a right-click menu for the same verbs
- Ecommerce — full WooCommerce day-to-day in Minn: Orders (search, status, notes, refunds, resend/custom email, pay URL, New order, Analytics with long-range revenue and top products), Products (stock filters, bulk, daily fields, Add product), Coupons, Customers, and Subscriptions when WooCommerce Subscriptions is active (status, next payment, parent order, related orders, customer strip). Orders, products and customers carry right-click menus for the common moves (status changes, stock and publish toggles, email, jump to a customer's orders). Invoice / packing-slip downloads when PDF Invoices & Packing Slips is active. Product, coupon and subscription CPTs are fenced out of Content.
- Users — directory with search, a role filter, create/edit users, roles, passwords, bulk role change, per-user login sessions with one-click sign-out, Switch to this user when the User Switching plugin is active (a switched session shows a Switch back bar in Minn), and Copy one-time login link when One Time Login is active
- Your profile — a full page at
/minn-admin/profile: account, public profile (first/last name, website, bio, Gravatar), per-user language with automatic pack installs, the front-end toolbar preference, appearance, hidden integrations, and login sessions - AI Access — generate revocable application passwords for AI agents plus a site-tailored agent guide (markdown REST reference) to hand to a coding agent; configuration work stays out of Minn by design
- Extensions — install plugins and themes from WordPress.org or zip upload (Add plugin opens a catalog by category with install tips, not only free-text search), activate, deactivate, delete, per-item and bulk updates with Queued… / Updating… feedback that survives worker recycles, a Themes tab with screenshots, cards wearing real wp.org icons (linked to the directory) with linked author lines, right-click menus on plugin and theme cards (Activate, Update, Delete, Open on WordPress.org or GitHub, Copy file), and a Licenses tab (below)
- Structure — post types, taxonomies and terms on one page. See every registered post type and taxonomy and manage definitions through whoever owns them (ACF, Custom Post Type UI, or Minn's own store when neither is active; code-registered ones shown read-only), and a full terms manager: rename, re-parent, merge (posts move to the survivor through core's own reassignment) and delete across every taxonomy, with an indented tree for hierarchical ones
- Settings — reorganized by intent: Site (identity, locale, admin, with timezone picker),
Visibility (search engines, maintenance mode, membership), Homepage, Content
(new-content defaults + permalinks with automatic rewrite flushing), Comments (discussion +
spam), Design (the Customizer's Additional CSS, validated before saving) and
Connectors (WP 7.0's registry of AI providers and external services: connection state,
where each key comes from (saved, wp-config constant or environment variable), install the
companion plugin in place, keys saved through core's own masked route), under a sticky
section nav. The Spam page shows who filters comment spam (Akismet, Antispam Bee,
CleanTalk, WP Armour) with safe toggles and blocked counts. Site-visibility warnings: an
Overview banner and a persistent topbar chip appear whenever a maintenance plugin, password
gate or "discourage search engines" is hiding the site, with inline fix controls where Minn
can safely flip the setting (third parties register via
minn_admin_visibility_providers) - Editor — a calm, block-aware writing surface that stores native Gutenberg markup
(zero lock-in: open any post in the block editor, any time). Markdown typing conventions
(
**bold**,`code`,## headings, lists, quotes, fences, dividers…), with wraps that stay on the undo stack (including inline code). Link popover on ⌘K, text alignment, table and image controls in island-style cutouts, complex blocks preserved byte-for-byte as configurable islands with real front-end styles (full height; previews no longer clip tall grids). Slash commands stay curated and type-to-filter; Browse all or ⌘/ opens the block picker, grouped by source (basics, plugin blocks, design libraries, patterns). Plugins can register free-form slash items throughminn_admin_editor_commands(boilerplate HTML, island templates, or an async REST route). Dynamic third-party blocks that render standalone auto-appear in search (no adapter); Stackable, Kadence, and GenerateBlocks free design/pattern libraries insert as valid Gutenberg markup with images sideloaded; block patterns from core, the theme, and plugins join the same search. Island content is editable: text runs and an Images section rewrite only what you change; block settings scale (used fields first, the rest behind More settings); every island links out to the block editor for layout controls. Previews pick up lazy CSS and auto-warm browser-compiled styles when needed. Syntax-highlighted code blocks; writing stats on the sticky pill (words, reading time, session delta, optional word goal); scheduling and one-click publish. Paste cleanup turns Word / Google Docs / web HTML into the safe subset; paste or drag an image uploads at the caret with an inline caption. The publish sidebar edits the slug, visibility (a themed Public / Password / Private combobox), per-post discussion, sticky and post format (when the theme supports formats). Deleting an embed offers an Undo toast; table add/delete row and column undo with ⌘Z. Revision diffs open a side-by-side, word-marked diff against the current content. An outline panel lists headings as a live table of contents; focus mode (⌘⇧D) fades all but the current paragraph; outline mode (⌘⇧O) leaves just the writing and the outline. The internal link picker searches your own posts from the link popover, and a themed date-time picker handles scheduling. Find & replace (⌘⇧F) matches across inline formatting, never touches protected islands, and every replace is a native undo step. Built for real writing sessions: IME-safe composition (CJK and dead keys), mobile Safari keyboard and hit-target polish, and a first-cut accessible toolbar, slash menu, and block popovers. ⌘⏎ publishes; the help dialog documents every shortcut. Where this is heading: the editor roadmap - Never lose work — post locking on WordPress's own
_edit_lock(Minn, the classic editor and Gutenberg all honor each other, with takeover), plus a localStorage crash net that snapshots every edit within ~1.2s (before the first autosave) and offers recovery on the next open. Status-aware autosave: drafts save in place, published posts back up to revisions (only Update goes live), with a backup-restore banner. - Page builders — build a page with Divi, Elementor, Brizy, Beaver Builder, Etch, Bricks
or WPBakery and keep managing it from Minn: builder-owned pages are marked, edited through
the builder's own chrome-free surface via Edit in ⟨builder⟩ (no wp-admin screen), and
fenced so a stray Minn edit can't break the builder's canvas. + New can start a page in any
active builder. Third parties register via the
minn_admin_page_buildersfilter - System — a developer diagnostics page with a sticky section jump bar: a health strip
over WordPress / PHP / database / server facts, plus loopback and REST self-checks, site
visibility, Wordfence firewall & scan posture, SSL enforcement (Really Simple SSL),
backups and licenses; the autoloaded-options breakdown and cron health expand into
full-detail modals (every option by size, every scheduled event with its next run); the real
login URL (honoring login-hiders), an installed extensions manifest, a Tools card
linking wp-admin's one-shot jobs (Site Health, export/import, GDPR tools), live debug
toggles that safely rewrite
wp-config.php, a clickable debug-log viewer, and one-click Copy report as markdown - Licenses — a license manager on Extensions → Licenses, beside the plugins and themes
it describes: every paid product classified valid / expired / invalid / missing from the
vendor's own locally stored state (read-only: no network calls, no seat burn), grouped by
state with inactive components collapsed, with paste-to-activate, deactivate and
re-verify wired through each
vendor's own code for more than twenty vendors (Elementor Pro, ACF PRO, WP Rocket, Gravity
Forms & SMTP, Divi, Beaver Builder, Brizy, Etch, Bricks, The Events Calendar family, Kadence
Blocks Pro, WPMU DEV, SearchWP, Gravity Perks, GP Premium, Perfmatters, WP All Import/Export,
Slider Revolution, LayerSlider), plus generic Freemius / EDD / SureCart / StellarWP detection.
A pasted key rides one request and is never stored or logged; failures never auto-retry;
inactive components can be turned back on in place. Third parties register via
minn_admin_license_providers - Editor field panels — ACF, Meta Box and Pods simple fields in the sidebar (advanced types count as locked with a wp-admin link); SEO panel for Yoast SEO, Rank Math, All in One SEO, SEOPress or SiteSEO title, meta description and focus keyword (first active SEO plugin wins); Event details for The Events Calendar (dates, all-day, venue and organizer as live search pickers, cost, website); Job listing for WP Job Manager, drawn live from its own field schema; Podcast episode for Seriously Simple Podcasting and PowerPress (media file, duration, the Apple Podcasts fields). Every write goes through the owning plugin's own save machinery
- Menus & Widgets — classic nav menus with drag-to-reorder (children travel with their parent) and right-click menus on every item; classic sidebars with drag grips to reorder widgets in an area, plus move between areas and in-place edit for block/text/HTML widgets
- Surfaces — Minn's answer to plugin sprawl: one sidebar item per job, not per plugin, with every capable plugin layered in behind it and a provider switcher when more than one is active. Forms (Gravity Forms, Ninja Forms, Fluent Forms, Forminator, Formidable, Everest Forms, SureForms, Elementor Pro, Contact Form 7 via Flamingo or CFDB7) shows entries as contact cards with real field labels and ←/→ stepping, with the full Gravity Forms workflow inside Minn: star, spam, trash, restore, bulk actions, notes and resent notifications across Received / Spam / Trash views, plus a Feeds view listing every add-on integration across your forms (Everest Forms carries the same three status views through its own entry helpers); Email (Gravity SMTP, FluentSMTP, WP Mail SMTP, Post SMTP, WP Mail Logging, SureMails, Site Mailer) shows sent mail with the real HTML body in a fully sandboxed preview, resend, and search plus delete where the logger supports it, plus Gravity SMTP's full settings (all 21 connectors, drawn at runtime from its own schema), suppressions, send a test email, and a FluentSMTP Settings view for the day-to-day choices; Activity Log (Simple History, WP Activity Log, Aryo, Stream, All-In-One Security, Wordfence login security, plus Limit Login Attempts Reloaded and Solid Security lockouts with unlock/release actions) reads like an audit feed; Redirects (Redirection, Safe Redirect Manager, Simple 301 Redirects, 301 Redirects) lists, searches, creates and edits, with sortable columns on Redirection; Snippets (Code Snippets, WPCode, FluentSnippets, Simple Custom CSS and JS, Header Footer Code Manager) lists, toggles, creates and bulk-edits; Performance (Perfmatters, Autoptimize, Asset CleanUp, Performance Lab) shares one Tools item with a provider switcher; Backups (UpdraftPlus, WPvivid, BackWPup, All-in-One WP Migration, Duplicator, Disembark) below. Status cards now open the whole mail, redirects and snippets families, and detail modals render typed rows: status pills, code blocks, key-value tables and sandboxed HTML previews. Surface lists open a ⋯ / right-click menu of that collection's actions. Plugins that need their own first-run install get a setup card that runs their installer in place. The sidebar organizes into Workspace / Tools / Manage groups so daily inboxes stay separate from site plumbing
- Backups — with UpdraftPlus or WPvivid: sets listed, status cards, a System health
check answering "is my site backed up?", and Back up site now from ⌘K. With BackWPup:
local folder archives and run-now. With All-in-One WP Migration: local
.wpressexports with delete. With Duplicator: packages with archive sizes read from disk and delete through its own cleanup. With Disembark: a status card (last scan, database size, working files), the exactdisembark connectcommand click-to-copy, scan sessions with cleanup, and token regeneration - Notifications that respect you — comments, plugin/theme/core updates and new users in one panel, plus an admin-notice digest: the notices other plugins print in wp-admin are extracted as structured data (never their HTML or JavaScript) into a Notices tab; Allow / No Thanks and ThemeIsle-style dismiss links run in the background (not a new wp-admin tab), and any notice can be hidden with Undo. Each update offer has its own Update → version button; the Updates tab also pins Update everything (plugins, themes and core in one click, poll-verified core). A pending WordPress update also shows as an amber topbar chip and Overview banner
- Command palette — ⌘K / Ctrl-K everywhere, and it finds your content: type anything to see your posts, pages and CPTs (drafts and scheduled included) under the command matches, and Enter opens the Minn editor. Site-care actions built in: Clear site cache purges every layer the site runs (Kinsta, LiteSpeed, WP Super Cache, W3TC, WP Rocket, WP Fastest Cache, SiteGround, Autoptimize, WP-Optimize, Cache Enabler, Hummingbird, Elementor CSS, SpeedyCache, Redis Object Cache, Breeze, Nginx Helper, Cloudflare), each in its own isolated request
- Extending — one-filter APIs for any plugin to register views (with status cards and optional charts, extra list views, tabs, status filters, sortable columns, detail layouts with typed rows including sandboxed HTML previews, actions with inline fields, bulk actions, schema-driven settings views including item-scoped settings, and setup gates), editor panels (including async search-picker fields), editor slash commands, traffic data (including per-day drill-down), media folder providers, cache purgers, spam providers, license providers, visibility providers, design libraries, page builders or block-inspector forms; the System page's Integrations card shows everything registered and flags descriptor problems instead of failing silently. The full coverage map lives in docs/plugin-support.md
- Quiet by architecture — integrations are data, never third-party HTML or scripts, and attention is budgeted: one plugin holds at most three nav slots and three default slash entries (overflow stays one search away), Workspace placement requires an inbox-shaped view, off-site links always carry the ↗ mark, and every surface, editor panel, design library and slash namespace can be hidden per user from Minn's own UI (restore from Your profile), with no API for a plugin to detect or resist it
- Dark, light and System themes (follows your OS until you choose; right-click for an explicit menu) plus per-user color schemes: named light/dark presets or a fully custom scheme with per-slot color pickers, set on Your profile. Bundled fonts, zero external requests from the app, responsive down to phones
- Download or clone into
wp-content/plugins/minn-admin. - Activate through the Plugins screen.
- Visit
/minn-admin/. It's also linked from the admin bar and the wp-admin menu.
Pretty permalinks recommended (clean routes like /minn-admin/content); without them the app
falls back to /?minn_admin=1 with hash routing. Updates are delivered through the normal
WordPress updates UI via GitHub Releases.
Any plugin can add a view to Minn with one filter: a declarative descriptor, no JavaScript required. Start with docs/for-plugin-authors.md; it opens with a quick start and carries a screenshot of every primitive. If your data lives in a custom table, docs/shim-tutorial.md walks the whole build with a copyable example plugin, and the WordPress Playground demo boots that example preactivated so a working instance of the API is one click away.
- Project goals
- Editor direction
- Editor roadmap
- Block inspector
- Block-suite lab notes
- For plugin authors
- Changelog
Edit and go. There's no build step. Lint with node --check assets/js/app.js and
php -l minn-admin.php. Commit messages follow Emoji-Log.