mkdocs-traefiklabs

A Traefik Labs Material Design theme for MkDocs

Quick start

Material for MkDocs can be installed with pip:

pip install mkdocs-traefiklabs

Add the following line to mkdocs.yml:

theme:
  name: traefik-labs

How to run the project in Dev mode

Pre-requisites

Check your node version, the .nvmrc file mentions the expected version. If you use nvm, you can run nvm use to set the correct node version to the environment.
Check if you have mkdocs installed locally (it requires Python). You can find installation instructions here: https://www.mkdocs.org/user-guide/installation/
You might need to add 2 additional dependencies to be able to run this project locally:
- pip install mkdocs-redirects
- pip install mkdocs-minify-plugin

Steps:

Install the dependencies npm install
npm run build - this will generate the '/material' folder with the compiled theme (you need to re-run this if you add assets)
npm run start - leave this running in a terminal, it will watch for code changes and rebuild the content (but not the assets)
npm run serve - will launch a dev server at 127.0.0.1:8000 with the current theme, it has hot reload (not very precise, sometimes you need to hard refresh the page)

If you wish to set the context to see other products information, you need to set the product config in the mkdocs.yml file in the project's root directory. The dev server should automatically reload and you will see the changes in the browser.

Reminders:

The 'material' directory generated by the npm run build is the one used in the documentation, so please don't forget running the build once you finish all the changes. TODO: add git hooks and run build on pre-push.

Metadata

Release files for mkdocs-traefiklabs 100.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mkdocs-traefiklabs 100.1.0
File	Size	Uploaded
mkdocs_traefiklabs-100.1.0.tar.gz	3.2 MB	Mar 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mkdocs-traefiklabs 100.1.0
File	Interpreter	ABI	Platform	Reset
mkdocs_traefiklabs-100.1.0-py2.py3-none-any.whl 5.5 MB Mar 12, 2026	Python 2, Python 3	none	any	Details

Total release size: 8.7 MB

Release files / mkdocs_traefiklabs-100.1.0.tar.gz

Download URL	mkdocs_traefiklabs-100.1.0.tar.gz
Size	3.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`ba20e7e2a1c73c741ff25ecdb39d701da6f499846414945f3f99cd9b1f5c5c62`
BLAKE2b-256 checksum How to use checksums	`3ef7138264694bb81c64c7d4c1006bb11ad859890516d918cfc5bda1b9275471`
Upload date	Mar 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.12`

Release files / mkdocs_traefiklabs-100.1.0-py2.py3-none-any.whl

Download URL	mkdocs_traefiklabs-100.1.0-py2.py3-none-any.whl
Size	5.5 MB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`ad7f682ea496b15e30c7a047f4e89df72f5e69df8b32fb676ac8892fdf480ecb`
BLAKE2b-256 checksum How to use checksums	`ac29a70eb596383f94c128748ff048d43e2dde95b6799800c177fd97866c95b5`
Upload date	Mar 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.12`