Skip to content

Navigation Settings

Customize the public-facing navigation menu from the admin panel. The navigation bar appears on all public pages, the admin header, the Gancio events page, and the MkDocs documentation site.


Key Features

  • Per-item toggle -- enable or disable each navigation item with a switch
  • Custom links -- add external links or internal paths to the navigation
  • Reorder -- move items up and down to arrange them in any order
  • Editable labels and paths -- rename any item or change its destination
  • Feature flag awareness -- builtin items tied to a feature flag (e.g., Campaigns requires enableInfluence) are automatically hidden when that feature is disabled
  • Visitor control -- determine exactly what public visitors can access

Builtin Items

The platform ships with 11 builtin navigation items that cover the main public routes:

Home, Campaigns, Map, Shifts, Events, Gallery, Pricing, Shop, Donate, Website (landing page), and Docs (documentation site).

Each builtin item has a default icon and path. Some paths use special $ tokens (e.g., $landing, $docs) that are automatically resolved to the correct external URL based on the deployment environment.


Add any number of custom links via the "Add Custom Link" button. Custom links support:

  • Internal paths (e.g., /blog)
  • External URLs (e.g., https://example.com) -- automatically detected and opened in a new tab

Custom links can be deleted from the navigation; builtin items can only be toggled off.


Mobile Handling

On mobile devices, the navigation collapses into a hamburger menu that opens a full-height drawer. On desktop, the nav bar also supports a collapse mode that hides labels and shows only icons, toggled via a fold/unfold button. The collapse state is persisted in local storage.


Admin Routes

  • /app/navigation -- navigation editor with per-item toggle, reorder, label editing, and custom link management