Skip to content
ESC

Searching...

Quick Links

Type to search • Press to navigate • Enter to select

Keep typing to search...

No results found

No documentation matches ""

Site.

Explore your website's structure, manage pages, and preview the impact of changes before making them.

Mar 27, 2026

Site

The Site workspace is a structural explorer, management surface, and AI orchestration console for your entire website. It answers four questions: what is my site made of?, what happens if I change this?, how do I reorganize it?, and how do I change things across multiple files at once?

The Site workspace uses a multi-panel layout. This requires a desktop or tablet screen.

Opening the Site workspace

Click Site in the top navigation bar (under the Create group). The workspace loads your site's structural graph — all pages, partials, routes, tokens, and assets — and presents them in a three-panel layout.

Three-panel layout

Page tree (left panel)

A filterable list of every page on your site. Type in the search field to narrow the list instantly. The filter applies to both the sidebar and the center diagram simultaneously. Click any page to select it.

Hierarchy diagram (center)

A visual diagram showing your site's page structure:

  • Homepage sits at the root level
  • Child pages appear in rows below, connected by relationship lines
  • Deeper nesting is shown as additional tiers

Click any page node to select it. The selected page highlights in both the tree and the diagram. A contextual action bar appears below the selected node.

Detail panel (right)

When a page or entity is selected, the detail panel shows:

  • Entity metadata — type, name, file path, properties
  • Relationship cards — how this entity connects to others (Linked From, Links To, Direct Includes)
  • Blast radius — which pages would be affected if this entity changed

Page actions

Select a page to see the action bar below its node card. The bar has one primary button (✎ Rename) and an overflow menu (⋯ More) with three additional actions: Change URL, Move, and Delete.

Rename

Opens an inline form to change the page title. The title updates in the database and the page tree immediately. This does not change the URL — use Change URL for that.

Change URL

Opens the URL proposal panel:

  1. Enter a new URL path in the input field
  2. Live validation shows whether the new path is valid or conflicts with an existing route
  3. Reference list displays every file and line that mentions the current URL, grouped by page, with the proposed replacement shown

Clicking Apply enters a confirmation state. Confirming applies the rename: the file is moved, the slug is updated, all cross-references across the site are rewritten, and a safety snapshot is created. The graph reloads with the renamed page still selected.

Homepage URLs cannot be changed.

Move

Changes a page's position in the navigation or moves it to a different parent. The Move panel shows the current navigation tree and lets you pick a new position.

When you change the parent, the move is a two-step operation:

  1. Structural move — the page file is moved to its new location, the slug and path are updated, and all cross-references (links, nav entries, PHP conditionals) are rewritten automatically
  2. Position apply — the page is placed at the specific sibling position you chose

The success message reflects what happened: "Page moved" for structural moves (with a count of moved pages and updated references), "Navigation updated" for position-only changes.

Delete

Removes the page from the site. Before confirming, a disclosure panel shows what will be affected:

  • Pages that link to the deleted page
  • Navigation entries that reference it
  • Database records associated with it

After deletion, all cross-references are automatically cleaned up — dead links are unlinked (text is preserved), navigation entries are removed, and empty containers are cleaned. A safety snapshot is created before deletion.

Blast radius

The blast radius query shows which pages would be affected by changing a specific entity. Select any entity — page, partial, route, token, or asset — and the detail panel shows the impacted pages. This helps you understand the scope of a change before making it.

Entity browser

The left panel lists all entity types with counts:

  • Pages — your site's PHP page files
  • Partials — shared includes (header, nav, footer)
  • Routes — URL paths that map to pages
  • Tokens — CSS custom properties and design tokens
  • Assets — images, stylesheets, scripts, and data files

Click any entity to inspect it in the detail panel.

Status bar

The workspace footer shows:

  • Entity counts — total pages, partials, routes in the current graph
  • Graph freshness — how recently the structural index was built

Data source

The Site workspace reads from the site graph index — a structural analysis of your entire website built from the filesystem and database. The graph is reindexed automatically. No manual refresh is needed.

AI orchestration

The bottom of the center panel contains an orchestration console for describing site-wide changes in natural language.

Describing a change

Type a description of what you want to change in the composer at the bottom of the console — for example, "Update the meta description on the about page" or "Change the primary color to navy blue." Press Enter to submit.

The system analyzes your request in several steps:

  1. Intent classification — determines what kind of change you're requesting (content, style, SEO, structure) and which part of the site it affects
  2. File discovery — identifies which files need to change, starting with shared partials
  3. Region scoping — pinpoints the specific sections within each file
  4. Plan building — produces a structured edit plan with exact before/after content for each change

The console shows each step as it happens.

Reviewing the plan

When the plan is ready, the right panel switches to a review surface showing:

  • Edit cards — one per file, with the change strategy, a description, and before/after content snippets
  • File links — click any file name to open it directly in the Code Editor

Review the proposed changes carefully.

Applying changes

Click Approve & Apply to execute the plan. The system applies changes transactionally — if any step fails, all files are rolled back to their previous state.

During apply, the console shows each phase: snapshot, read, anchor, patch, and verify. After a successful apply, the right panel shows a verification report confirming that each file was written correctly.

The site graph automatically refreshes after a successful apply so the diagram reflects the updated state.

Safety

  • Transactional — all changes succeed together or none are applied
  • Anchored — each edit is anchored to exact text in the current file. If the text has changed since the plan was built, the edit is refused
  • Verified — after writing, each file is re-read from disk and checked for correctness
  • Logged — every step is recorded in the server logs for diagnostics

Ready to build?

One-time purchase. Self-hosted. Own every file forever.

Get VoxelSite