@shiftescape/astro-toolbar-routes

Every route,one click away.

Live, clickable route map of your entire Astro project — right in the dev toolbar. No more typing URLs by hand.

Route Map — dev toolbar
● 7 static ● 1 SSR ● 1 endpoint · 9 total

📄 PAGES
/
/about
/blog
/blog/[slug] dynamic SSR
/contact
/pricing
/rss.xml

⚡ ENDPOINTS
/api/contact endpoint

features

Your whole project, mapped.

Built on Astro's astro:routes:resolved hook — every route, always accurate.

01
Click to navigate

Click any static route to jump to it. No typing, no copying URLs.

02
Active highlight

The current page is always highlighted so you know exactly where you are.

03
Route tags

Dynamic, SSR, endpoint, and redirect routes are clearly labelled at a glance.

04
Searchable

Filter by URL pattern or file path in real time across all routes.

05
Live updates

New pages added while the dev server is running appear immediately.

06
Dev-only

Completely stripped in astro build. Zero production cost.

route types

Every type, clearly labelled.

Tags tell you what each route can do at a glance.

static

Prerendered at build time. Click in the panel to jump to it instantly.

dynamic

Route has [param] or [...slug] segments — can't navigate without a real value.

SSR

Rendered on-demand (prerender: false). Server-rendered on every request.

endpoint

API route — a .ts or .js file in src/pages/ that returns data instead of HTML.

configuration

Add it. It just works.

Zero config required. Filter routes when your project grows.

astro.config.mjs
import { defineConfig } from 'astro/config'
import toolbarRoutes from '@shiftescape/astro-toolbar-routes'

export default defineConfig({
  integrations: [
    toolbarRoutes({
      // hide specific routes or glob prefixes
      exclude: ['/admin', '/api/*'],
      // show _astro/* and _server_islands/* internal routes
      showInternalRoutes: false,
    }),
  ],
})
Option Type Default Description
exclude string[] [] Route patterns to hide. Supports exact match and * suffix wildcard.
showInternalRoutes boolean false Show Astro's internal routes like /_astro/* and /_server_islands/*.

install

Two minutes to set up.

Works with Astro 4, 5, and 6. Peer dependency only.

npmnpm install -D @shiftescape/astro-toolbar-routes
pnpmpnpm add -D @shiftescape/astro-toolbar-routes
yarnyarn add -D @shiftescape/astro-toolbar-routes
zero-config usage
import toolbarRoutes from '@shiftescape/astro-toolbar-routes'

export default defineConfig({
  integrations: [toolbarRoutes()]  // click 🗺 in the dev toolbar
})