Page Hierarchy

Vanillaround lets you organise spec pages into a tree structure. Parent pages group related content; child pages provide detail for individual components or flows.

Creating a sub-page

In the sidebar, hover over an existing page to reveal the + icon beside it. Click it to create a child page directly under that parent.

Alternatively, from within a page, use the page menu (accessible from the top of the editor) and select Add Sub-page.

Nesting depth

Pages can be nested to any depth, though two or three levels is typically enough:

User Onboarding
  ├── Registration Flow
  │     ├── Step 1: Email & Password
  │     ├── Step 2: Profile Details
  │     └── Step 3: Verification
  └── Login Flow
        ├── Standard Login
        └── Forgotten Password

Reordering pages

Drag pages in the sidebar to reorder them or move them between parents. The order is saved immediately and visible to all project members.

Deleting pages

To delete a page, open the page menu from the sidebar or the top of the editor and select Delete. Deleting a parent page also deletes all its child pages. This action is permanent — proceed with care.

If you want to remove a page temporarily without losing its content, consider archiving the project or moving the page under a clearly-labelled “Archived” parent page instead.

Global pages

Global pages appear separately from requirement pages in the sidebar. They are intended for shared reference material: a glossary, a set of design principles, or a diagram that multiple feature specs refer to. Global pages go through the same editing process but are not typically linked to approval workflows or Jira syncs.