AccueilComponentsThemeProvider

ThemeProvider

Provider de thème. Injecte les tokens CSS (couleurs, espacements, typographies, rayons). Supporte deux modes : injection dynamique (défaut) ou CSS pré-compilé statique.
Kit
Web only
UsageDefaut
Mode par défaut : les variables CSS sont injectées au runtime via des balises <style>, recalculées à chaque changement de thème.
import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
<ThemeProvider>
{children}
</ThemeProvider>
);
}
Mode actif : injection dynamique via balises <style>
import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
<ThemeProvider>
{children}
</ThemeProvider>
);
}
tsx
export const UsageDefaut = () => (
<Box display="flex" flexDirection="column" gap="3V">
<ModeBadge>Mode actif : injection dynamique via balises &lt;style&gt;</ModeBadge>
<Highlight language="tsx">
{`import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
<ThemeProvider>
{children}
</ThemeProvider>
);
UsageCSSStatique
Mode CSS statique : les variables CSS sont pré-compilées dans dist/default.css au moment du build du package. Le navigateur peut mettre ce fichier en cache — aucune balise <style> n'est injectée au runtime. Étapes : •Importer le CSS dans le layout racine (Expo Router, Next.js, etc.) •Passer le prop staticCSS au ThemeProvider
import '@alveole/theme/dist/default.css';
import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
<ThemeProvider staticCSS>
{children}
</ThemeProvider>
);
}
Limitation — incompatible avec la personnalisation des couleurs. Le prop color du ThemeProvider permet de surcharger des tokens de couleur. Avec staticCSS, ces surcharges ne sont pas injectées et le thème custom est ignoré. Si l'app passe des couleurs personnalisées, ne pas utiliser staticCSS.
// ❌ Les overrides color sont silencieusement ignorés
<ThemeProvider staticCSS color={{ light: { background: { 'default-grey': '#eee' } } }}>
// ✅ Sans staticCSS, les overrides fonctionnent normalement
<ThemeProvider color={{ light: { background: { 'default-grey': '#eee' } } }}>
Mode actif : CSS pré-compilé - aucune balise <style> injectée
import '@alveole/theme/dist/default.css';
import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
<ThemeProvider staticCSS>
{children}
</ThemeProvider>
);
}
Limitation : incompatible avec color customSi l'app passe un prop `color` au ThemeProvider, les variables overridées ne seront pas injectées. Dans ce cas, retirer `staticCSS`.
// ❌ Les overrides color sont ignorés avec staticCSS
<ThemeProvider staticCSS color={{ light: { background: { 'default-grey': '#eee' } } }}>
// ✅ Sans staticCSS, les overrides fonctionnent
<ThemeProvider color={{ light: { background: { 'default-grey': '#eee' } } }}>
tsx
export const UsageCSSStatique = () => {
const { color, text } = useTheme();
return (
<Box display="flex" flexDirection="column" gap="3V">
<ModeBadge>Mode actif : CSS pré-compilé - aucune balise &lt;style&gt; injectée</ModeBadge>
<Highlight language="tsx">
{`import '@alveole/theme/dist/default.css';
import { ThemeProvider } from '@alveole/theme';
export default function RootLayout() {
return (
Alveole UI Kit — v2.0.0-alpha.30