Streamlit Copy-to-Clipboard Button Component

A tiny, theme‑aware Streamlit component that adds a one‑click "copy-to-clipboard" button to your app — perfect for the chat UI, URLs or any other text the user might need to copy.

✨ Features

• Streamlit theme aware: Adapts icon color & tooltip style automatically; works in both light and dark themes.
• Inline layout: Built on Streamlit Custom Components v2 (frameless, no iframe), so the button aligns beside other elements inside st.container(horizontal=True).
• Two icon styles: Google Material Symbols (default) or the native Streamlit code‑block icon.
• Custom tooltip & "Copied!" label: Localized UI in one line.
• Keyboard‑friendly: Fully focusable, press Enter/Space to copy.

🔧 Installation

pip install st-copy

⚡ Quick start

import streamlit as st
from st_copy import copy_button

st.title('Minimal demo')

copy_button('Hello, Streamlit!')  # one line – that's it 🎉

Run your script:

streamlit run app.py

🛠 API

def copy_button(
    text: str,
    *,
    icon: Literal['material_symbols', 'st'] = 'material_symbols',
    tooltip: str = 'Copy',
    copied_label: str = 'Copied!',
    key: Optional[str] = None,
) -> Optional[bool]:

Requirements

• Python 3.10 or newer.
• Streamlit 1.56 or newer (the component uses the Custom Components v2 API).
• Clipboard API requires a secure (HTTPS) context when deployed.

🎨 Examples

See examples/app.py for a chat‑style demo that showcases every argument and the deployed version at https://st-copy.streamlit.app/.