The live editor
The live editor
In short
Changing a site usually means hunting for the template, block or field that made a part, editing it somewhere else, then reloading to see. The live editor shows your local site inside Wanigan, so you point at the part, change it on the page, and save it through the site itself once it looks right.
On this page
Why it exists
A Drupal or WordPress page does not say how it was made. To change one heading you find the template, block or field that printed it, change it in an admin form or a file, and reload to see whether it was the right one. An agent tells you what it changed in words, not on the page.
The live editor puts the page and what made it side by side, and nothing reaches the site until you say so.
What it is
- The local site you already run (ddev, Lando, a dev server), in the project’s Live tab. Wanigan starts and changes nothing to show it.
- Off until you switch it on, for Drupal, WordPress and other sites separately.
- It follows the agents: when one edits a file, the page reloads and the parts that file made are outlined.
- On Drupal and WordPress it names each part as the site does; with the site helper it also says what made each part and saves through the site’s own core.

The path of an edit
Every change takes the same path, and you take each step.
How an edit becomes real
- The page. Select a part (P), then type on its words (E) or try a style. Each key or value shows on the page as you go.
- The layer. What you keep is held on Wanigan’s side, keyed to its part by what the site says it is, and shown again after every reload. Nothing is written to the site yet. If the part shows other words or is gone, the edit is set aside as orphaned, never put on whatever is there now.
- Make real. Words are saved through Drupal’s or WordPress’s own core, as the user you are logged in as, with a revision where the site keeps one. A style or a token is code, so it goes to an agent as a brief, on your click; once it is in the theme, Verify finds it there.
- Verify. The page is rendered with and without the layer at 390 and 1440 px and compared: the styles of what was edited, the pixels around it, then the rest of the page against how it was before.
- Undo. Undo takes back the newest add or discard, and Redo brings it back. An edit already in the site is never taken out of the layer.
- The page. Select a part, then type on its words or try a style; each key and value shows as you go.
- The design layer. What you keep waits in Wanigan’s layer, keyed to the part by what the site says it is, shown again after every reload. The site has nothing yet.
- Make real. Words are saved through Drupal’s or WordPress’s own core, as you, with a revision where the site keeps one. A style goes to an agent as a brief, on your click.
- Verify. The page is rendered with and without the layer at 390 and 1440 px, and compared.
- Undo. Undo takes back the newest add or discard; an edit already in the site is never taken out of the layer.
The layout
The page takes the most room, with one toolbar above it and panels that close.
The toolbar
| Control | What it does | Key |
|---|---|---|
| The site menu | Local or a hosted environment, Compare, Site settings… | On a Mac, ⇧C; on Windows and Linux, Shift+C compares |
| Back, Forward, Reload | The page’s history | |
| The address | Opens Go to: any page of the site | On a Mac, ⇧Space; on Windows and Linux, Shift+Space |
| Select | Select a part on the page | P |
| Type on the page | Type on the chosen part’s words | E |
| Style | Try a style on the chosen part | None |
| Move | Move the chosen part | M |
| Snap | A picture of the page to mark up for an agent | On a Mac, ⇧S; on Windows and Linux, Shift+S |
| Record | The view, at most two minutes | On a Mac, ⇧R; on Windows and Linux, Shift+R |
| Speak a note | Speak instead of typing; narrate a recording | On a Mac, ⌘⇧M; on Windows and Linux, Ctrl+Shift+M |
| Lens | Colour the page by owner, cache, cost, editable or changed | On a Mac, ⇧L; on Windows and Linux, Shift+L |
| Widths | Phone (390 px), tablet (768 px), full width | 1, 2, 3 |
| The eye | The page without the layer, to compare | |
| The admin bars (☰) | Hide the site’s own admin bars, so the page looks as a visitor sees it while you stay logged in; press again to show them | |
| Edits | The design layer’s edits, with a count of drafts | On a Mac, ⇧E; on Windows and Linux, Shift+E |
| Make real | Make this page’s drafts real, or verify them | |
| More | Drag handles, the default browser | |
| How this works | The path from page to site, with this project’s numbers |
Around the page
- Structure, on the left: Layers (the page’s parts, named as the site names them), Add (what the site can place, from its component library) and Pages (the site’s pages to walk).
- The page, in the middle: the chosen part outlined in blue with its name, and its action bar above it (Style, Move, Take out, Ask an agent).
- The Inspector, on the right: the chosen part’s Design, Made by and Data (more).
- The dock, beneath: Code, Notes, Problems, Request and DevTools, opened from their tabs in the status line (Developer tools).
- The status line: what just happened (“hero.twig changed: outlined the part of this page it makes.”) and the mode you are in, such as Selecting.

The page as visitors see it
You stay logged in to your site while you work, so its own admin bars sit over the page. One switch in the live view’s bar hides them: Drupal’s admin toolbar and sidebar, or WordPress’s admin bar, with the space each core makes for them taken back, so the page looks as a visitor sees it and you stay logged in. It needs no reload, and it stays as you set it for every site and page. A theme’s own room for an admin bar is the theme’s, and stays; other admin toolbars from contributed projects are not hidden.
Drupal’s own status messages (“Saved”, “You are logged in”) used to push the page down and come and go between renders. They are hidden in the view now, and Wanigan says them in a pop-up of its own at the top of the page that goes after a few seconds (a site’s error stays longer), and keeps them in the notification tray as “Drupal says: …”. Messages a script adds after the page has loaded are not read. WordPress prints none on a site’s pages.
What you can do
- Turn it onShow your site; add the helper.
- Pick a partChoose a part and read what made it.
- Type on the pageChange words where they show.
- Try a styleColour, size and space, shown as you go.
- The design layerWhere your edits wait until you make them real.
- Make realSave words through the site’s own core.
- VerifyCheck the site renders what you designed.
- CompareLine your local page up with a hosted one.
The keys
In depth
Following the agents
After an agent’s edit, the editor waits for the edits to stop, then reloads once: 400 ms after the last edit, 1.2 s for Sass or Less (the project’s watcher compiles first), 2.4 s for PHP (its opcode cache looks again only every couple of seconds). Changed stylesheets alone are swapped in place.
With Follow the agents’ edits off (Settings › Live view), an edit only says what changed.
