---
id: trame-router
version: "2.3.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# trame-router — Vue Router widgets for trame

License: permissive · Maintenance: dormant · Downloads: 107.9K/mo

## What it is and what it does

trame-router integrates Vue Router—the official Vue.js routing library—into trame, a Python web framework for building interactive applications. It extends trame's widget and UI layers with router components and helpers, allowing developers to define multi-page applications with URL-based navigation and parameterized routes. Routes are defined using RouterViewLayout context managers that map URL paths to UI content, and navigation is handled through standard Vue Router mechanisms.

The package is a thin Python wrapper around Vue Router's core functionality, designed to streamline routing setup within trame's declarative UI model. It supports both hash-based and HTML5 history routing modes (controlled via environment variable), and integrates with trame's existing widget ecosystem like vuetify. With one runtime dependency (trame-client) and a pure-Python wheel, installation is straightforward, though the package has been dormant for over two years.

Use it for:

- Build multi-page trame applications where different URL paths render different UI layouts and content.
- Create parameterized routes (e.g., /bar/:id) to display dynamic content based on URL parameters.
- Implement navigation bars or menus that link to different application pages using standard Vue Router button components.
- Deploy trame apps as single-page applications with client-side routing instead of server-side page reloads.
- Integrate trame dashboards or tools that need bookmarkable, shareable URLs for different application states.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds multi-page navigation to trame applications using Vue Router components, enabling URL-based routing and parameterized views within trame's web framework.

Yes, if you are already committed to trame and need multi-page routing. The package is stable and has no known vulnerabilities, but its dormant maintenance status (739 days since last release) means you should verify compatibility with your trame and Vue.js versions before adopting it. Low install friction and permissive licensing make it a straightforward addition to a trame project.

## Install

pip install trame-router
uv add trame-router
poetry add trame-router

## Installing trame-router

Before you install: Low install friction with a single pure-Python wheel dependency on trame-client. Maintenance is dormant—last release was 739 days ago—so expect no active bug fixes or feature updates, though the package is marked Production/Stable.

License in practice: MIT license (permissive) allows commercial and private use with minimal restrictions, matching Vue Router's own licensing.

Quickstart:

pip install trame-router

from trame.ui.router import RouterViewLayout
from trame.widgets import router

with RouterViewLayout(server, "/"):
    vuetify.VCard()

with RouterViewLayout(server, "/foo"):
    vuetify.VCard()

router.RouterView()

Requires an existing trame application server instance; router history mode (html5 vs hash) is controlled by __TRAME_ROUTER_HISTORY_MODE__ environment variable.

Verify before relying:

- Whether dormant status (739 days since last release) affects compatibility with recent trame or Vue.js versions.
- Specific Python version requirements (requires_python is unspecified in metadata).
- Performance characteristics with complex routing hierarchies or large parameter sets.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 107.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vue router for trame, multi-page navigation trame, trame routing widgets, url routing trame applications, trame single page app routing, vue router python integration, trame page navigation, routing, vue-router, web-framework

[View on SkillFed](https://skillfed.io/packages/trame-router) · [View on PyPI](https://pypi.org/project/trame-router/)