Structure Viewer

Description

The fastest way to feed your codebase to AI — and the easiest way to understand what you’re feeding it.

If you’ve ever copy-pasted a plugin folder into ChatGPT, Claude, Cursor, or Copilot, you already know the problem. AI tools are only as good as the context you give them. They can’t fix what they can’t see. And manually opening files, copying paths, and pasting them one by one — for every prompt, on every project — is the silent tax on AI-assisted development.

Structure Viewer is the missing first step. Browse any plugin or theme on your WordPress site, see its complete file tree at a glance, and export the entire structure as a single clean tree — TXT, JSON, XML, or one-click clipboard copy — that drops directly into any AI prompt as ready-to-use context. No FTP, no cPanel, no zipping folders, no guesswork.

Whether you’re prompting an AI to refactor a plugin, audit third-party code, generate tests, write documentation, or trace a bug through someone else’s theme — the conversation goes better when the AI knows the whole map up front.

🤖 Built for AI-Assisted Development

Modern coding workflows look different than they did two years ago. You’re working alongside an AI, and your AI works better when it has structural context. Structure Viewer is designed for exactly that workflow:

• Tree-format exports purpose-built for LLM context windows — clean ASCII, no markdown noise, token-efficient
• One-click clipboard copy — emoji tree format that pastes into any AI chat with perfect alignment
• Filter before you export — exclude node_modules, vendor, build artefacts, or anything you don’t want bloating your context
• Read source inline — open any file in the browser modal, copy the snippet you need, paste into your AI conversation
• Pro: Comparator — diff two versions of a plugin and feed only the changed lines to your AI for targeted code review
• Pro: FlatPack — extract just the PHP, just the JS, or just the CSS from any plugin and hand the AI a focused codebase
• WP-CLI exports — script structure dumps directly into your AI agent’s working directory

Stop pasting one file at a time. Give the AI the whole map first, then ask better questions.

🗂️ File Explorer

See exactly what is inside every plugin and theme:

• Interactive tree view — expandable folders with icons for every file type (PHP, JS, CSS, images, JSON, XML, and more)
• Searchable item picker — switch between All Plugins, individual plugins, All Themes, and individual themes instantly
• Live tree search — type to filter files in real time, jump between matches with next/prev navigation
• File type tag strip — one click to show only PHP files, only CSS, only images — whatever you need
• File size and modification dates — see when each file was last changed, toggle on/off
• Recently Viewed panel — jump back to any file or folder you have already opened

📄 File Viewer

Click any file to read it right there in your browser:

• Inline modal with syntax highlighting for all common languages
• File metadata: size, line count, last modified timestamp
• Fullscreen mode for reading long files without scrolling the page
• One-click download — get any file with the correct MIME type and original filename preserved

🔍 Search

Find any file across your entire plugin or theme in seconds:

• Real-time search — results appear as you type, no page reloads
• Extension search — prefix with a dot to filter by type: .php, .js, .css, .json
• File type dropdown for quick narrowing
• Results show full relative path, file size, and last modified date

📤 Export

Share or document your plugin structures in any format:

• TXT — clean ASCII tree, perfect for documentation, tickets, and AI context windows
• JSON — nested structure with file sizes and timestamps for programmatic use
• XML — standardized hierarchical format
• PDF — formatted document with header, page numbers, and automatic page breaks
• Clipboard — one-click emoji tree copy for pasting into Slack, Notion, or GitHub

📊 Dashboard

Your WordPress file ecosystem at a glance:

• Stat tiles for total plugins, active/inactive split, total themes, and total files indexed
• Largest plugins table — instantly see which plugins are heaviest with file count and size bars
• WordPress environment strip: WP version, PHP version, active theme, site URL

⚙️ Settings

Make it yours:

• Dark mode / Light mode — applied server-side, no flash on load
• Accent color picker — Emerald (default), Violet, Blue, Amber, or Rose
• Exclude hidden files, system directories, and custom patterns (node_modules, .git, vendor)
• Settings auto-save with instant confirmation toast

💻 WP-CLI

Automate structure exports from the command line:

wp structure-viewer export plugin <folder-name>
wp structure-viewer export theme <folder-name>
wp structure-viewer list plugins
wp structure-viewer list themes

🚀 Structure Viewer Pro

Unlock two powerful Pro tools for developers who need to go deeper.

🔀 Comparator — Know Exactly What Changed

Ever updated a plugin and wondered what actually changed? Comparator shows you a precise, color-coded, line-by-line diff between any two versions — so you can audit updates, review customizations, and catch unwanted changes before they cause problems.

• Compare two plugin ZIPs side by side
• Compare an installed plugin or theme against any uploaded ZIP
• Compare two individual files for a targeted spot-check
• Added lines in green, removed in red, changed lines clearly highlighted
• Works on large plugins and minified CSS/JS files — auto-tokenizes before diffing
• Expand/collapse per-file diff blocks to focus on what matters

📦 FlatPack — Extract Only What You Need

Need just the CSS from a plugin? Or all the PHP files for a code review? FlatPack extracts any plugin or theme ZIP and flattens it into a single, clean download — no nested folders, no hunting through directory trees.

• Upload any plugin or theme ZIP and see all its files in a live preview instantly
• Filter by PHP, CSS and JS, images, or any custom extension — preview updates live
• Only the filtered files are included in the output ZIP
• Smart collision-safe naming: duplicate basenames get a folder prefix automatically
• Download a single flat ZIP in seconds

Upgrade to Pro from within the plugin — Settings → License → Upgrade to Pro.

🔒 Security

Security is not an afterthought. Every request to Structure Viewer is protected:

• Nonce verification on all AJAX endpoints
• manage_options capability required — administrators only, no public access
• Path traversal prevention — file paths resolved with realpath() and verified
• Input sanitized with wp_unslash() + sanitize_text_field() before use
• All output escaped before rendering
• Pro upload directories protected with .htaccess deny rules

⚡ Performance

Structure Viewer is invisible to your site’s frontend:

• Assets load only on the Structure Viewer admin page — zero impact on your site
• Dashboard stats cached with a 6-hour transient
• Lazy tree loading — only trees you expand are scanned
• FlatPack preview filtering is entirely client-side — no extra AJAX round-trips
• No external HTTP requests at runtime