DocsInstallation

Installation

Configurer PyBlade UI dans un projet PyBlade existant.

Prérequis

Python 3.11 ou plus récent, PyBlade 0.3 ou plus récent et Tailwind CSS v4. Les composants interactifs ont aussi besoin d'Alpine.js.

Initialiser

pip install pyblade-ui
cd mon-projet-pyblade
pyblade-ui init --base zinc --color blue

init écrit pyblade-ui.toml, génère static/css/theme.css, ajoute @import "./theme.css"; dans static/css/tailwind.css, puis installe theme-script et mode-toggle.

Brancher le framework

# Django : settings.py
INSTALLED_APPS = [..., "pyblade_ui"]

# Flask, FastAPI… : une fois au démarrage
import pyblade_ui

Le <head>

templates/layout.html

<head>
  <pb-ui.theme-script />
  <link rel="stylesheet" href="@static('css/app.css')" />
  <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.14.9/dist/cdn.min.js"></script>
</head>

Adaptez le chemin de la feuille de style compilée (@static) à votre framework.

Ajouter des composants

pyblade-ui add button card dialog
# ou tout d'un coup
pyblade-ui add --all

Les dépendances sont copiées avec : dialog installe aussi button. add ne remplace jamais un fichier que vous avez modifié, sauf avec --overwrite.

‹ Introduction Thèmes ›