streamlit-rockyroad-tools 0.0.25

Streamlit RockyRoad Tools

Streamlit Rocky Road Tools

A collection of custom Streamlit components and tools.

Components

st_notification_banner

A customizable notification bar component for Streamlit applications.

Features:

• Displays notification messages with optional "Learn more" links
• HTML message support - Rich text with tags like <strong>, <em>, <p>, etc.
• Persistent dismissal using localStorage
• Customizable styling with black background and styled buttons
• React + TypeScript implementation
• Full width layout within Streamlit constraints

Installation:

pip install streamlit-rockyroad-tools

Usage:

import streamlit as st
from streamlit_rockyroad_tools import st_notification_banner

# Basic usage
st_notification_banner(
    message="This is a notification from our sponsors.",
    learn_more="https://example.com",
    key="my_notification"
)

# HTML message support
st_notification_banner(
    message="<p>Our new&nbsp;<strong>Widgets Incentive Program</strong>&nbsp;has launched!</p>",
    learn_more="https://example.com/parts",
    key="html_notification"
)

# Without Learn More button (learn_more is optional)
st_notification_banner(
    message="<p>Simple notification without a Learn More button.</p>",
    key="simple_notification"
)

Development

Each component has its own frontend directory with React/TypeScript source code.

To develop the notification bar:

cd st_notification_banner/frontend
npm install
npm start

Then run your Streamlit app in another terminal:

streamlit run st_notification_banner/my_notification_banner_example.py