---
id: shinyswatch
version: "0.12.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# shinyswatch — Bootswatch + Bootstrap 5 themes for Shiny.

License: permissive · Maintenance: active · Downloads: 132.9K/mo

## What it is and what it does

shinyswatch wraps Bootswatch themes—pre-built Bootstrap 5 CSS designs—into Python objects that integrate directly with Shiny for Python applications. Instead of writing or managing CSS, you pass a theme object (like `shinyswatch.theme.darkly` or `shinyswatch.theme.minty`) to your app's UI definition, and the entire visual appearance changes instantly. The package includes 25 themes covering a range of aesthetics from minimal to bold.

Each theme also exposes a `.colors` attribute, letting you extract the theme's color palette for use in plots and other custom UI elements. This keeps your app's visual identity consistent across all components. Installation is straightforward—a single pip command—and the package has no heavy dependencies beyond Shiny itself, htmltools, packaging, and typing-extensions.

Use it for:

- Apply a dark theme to a Shiny dashboard without writing custom CSS.
- Build a theme picker UI that lets end users switch between 25 pre-built themes at runtime.
- Extract theme colors to style matplotlib or plotly charts to match your app's visual design.
- Quickly prototype a web app with a professional, cohesive look using Bootswatch designs.
- Ensure consistent Bootstrap 5 styling across multiple Shiny applications.

## Worth the install?

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

Provides 25 Bootswatch + Bootstrap 5 themes for Shiny Python applications, allowing you to apply pre-designed visual themes to your web UI.

Yes. shinyswatch is a low-friction, actively maintained utility that solves a real problem—applying polished, pre-built themes to Shiny apps without CSS expertise. No known vulnerabilities, permissive MIT license, and recent releases. Install it if you're building Shiny applications and want professional-looking themes out of the box.

## Install

pip install shinyswatch
uv add shinyswatch
poetry add shinyswatch

## Installing shinyswatch

Before you install: Low friction installation with a pure-Python wheel. Active maintenance with a recent release (16 days old) and clean repository history. Supports current Python versions (3.10–3.14).

License in practice: MIT license permits unrestricted use, modification, and distribution in both open and closed projects with minimal attribution requirements.

Quickstart:

pip install shinyswatch

from shiny import App, ui, render
import shinyswatch

app_ui = ui.page_fluid(
    ui.input_slider("num", "Number:", min=10, max=100, value=30),
    theme=shinyswatch.theme.darkly
)

def server(input, output, session):
    @output
    @render.text
    def slider_val():
        return f"{input.num()}"

app = App(app_ui, server)

Requires Shiny for Python to be installed; works with Python 3.10 or later.

Verify before relying:

- Whether all 25 themes are fully documented or discoverable programmatically.
- Performance impact of theme switching at runtime in large applications.
- Compatibility with custom CSS or third-party Bootstrap extensions.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 132.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

shiny app themes, bootstrap 5 themes python, bootswatch themes, shiny ui styling, python web app theming, shiny dark mode themes, responsive bootstrap themes, shiny-ecosystem, ui-theming, bootstrap

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