trame-router enable multi-page navigation

Trame-router extend trame widgets and ui with Vue Router components and helper to streamline its usage with trame. Vue Router is the official router for Vue.js on which trame is based.

Installing

trame-router can be installed with pip:

pip install trame-router

Development

# Create venv and install all dependencies
uv sync --all-extras --dev

# Activate environment
source .venv/bin/activate

# Install commit analysis
pre-commit install
pre-commit install --hook-type commit-msg

# Run pre-commit
pre-commit run --all-files

Usage

The Trame Tutorial is the place to go to learn how to use the library and start building your own application.

The API Reference documentation provides API-level documentation.

The original Vue Router documentation provide a great introduction resource.

The router elements can be used as follow in trame:

# [...]
from trame.ui.router import RouterViewLayout
from trame.widgets import router

with RouterViewLayout(server, "/"):
    with vuetify.VCard():
        vuetify.VCardTitle("This is home")

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

with RouterViewLayout(server, "/bar/:id"):
    with vuetify.VList():
        vuetify.VListItem("Bar {{ $route.params.id }} item 1")
        vuetify.VListItem("Bar {{ $route.params.id }} item 2")
        vuetify.VListItem("Bar {{ $route.params.id }} item 3")

with SinglePageWithDrawerLayout(server) as layout:
    with layout.toolbar:
        vuetify.VBtn("Home", to="/")
        vuetify.VBtn("Foo", to="/foo")
        vuetify.VBtn("Bar 1", to="/bar/1")
        vuetify.VBtn("Bar 2", to="/bar/2")
        vuetify.VBtn("Bar 3", to="/bar/3")

    with layout.content:
        router.RouterView()

Environment variables

With vue3 and docker, trame-router can leverage the html5 history mode but by default we use the “hash” mode. To enable it, you need to define a TRAME_ROUTER_HISTORY_MODE environment variable that should either be set to “html5” or “hash”. This can only work if using our docker bundle or with a proper web server configuration when delivering the static HTML/JS/CSS content yourself.

License

trame-router is made available under the MIT License. For more details, see LICENSE This license has been chosen to match the one use by Vue Router which is used under the cover.

Community

Trame | Discussions | Issues | Contact Us

Enjoying trame?

Share your experience with a testimonial or with a brand approval.

JavaScript dependency

This Python package bundle the following vue-router libraries. For client_type="vue2", it exposes vue-router@3.5.1 and for client_type="vue3", it exposes vue-router@5.3.1. If you would like us to upgrade any of those dependencies, please reach out.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trame_router-2.4.1.tar.gz (324.8 kB view details)

Uploaded Sep 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

trame_router-2.4.1-py3-none-any.whl (331.7 kB view details)

Uploaded Sep 16, 2026 Python 3

File details

Details for the file trame_router-2.4.1.tar.gz.

File metadata

Download URL: trame_router-2.4.1.tar.gz
Upload date: Sep 16, 2026
Size: 324.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for trame_router-2.4.1.tar.gz
Algorithm	Hash digest
SHA256	`2d7ca326f79d7869f50d8564e5aee3b337a7334edbd6d212eda796432b355bd6`
MD5	`eebf2c6a2c331671a97d3b2bdd705eef`
BLAKE2b-256	`5abc44298f5b6cf1dda51d2535e20cd84e981e07523da059f05c7dc0de5f31ee`

See more details on using hashes here.

Provenance

The following attestation bundles were made for trame_router-2.4.1.tar.gz:

Publisher: test_and_release.yml on Kitware/trame-router

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: trame_router-2.4.1.tar.gz
- Subject digest: 2d7ca326f79d7869f50d8564e5aee3b337a7334edbd6d212eda796432b355bd6
- Sigstore transparency entry: 2863965026
- Sigstore integration time: Sep 16, 2026
Source repository:
- Permalink: Kitware/trame-router@a9830b7a48ec67a2b342402cb26961d8f50c75f6
- Branch / Tag: refs/heads/master
- Owner: https://github.com/Kitware
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: test_and_release.yml@a9830b7a48ec67a2b342402cb26961d8f50c75f6
- Trigger Event: push