# waka-ui

> La bibliothèque de composants React de Wakastart pour construire le front de votre wakapp sous Next.js - composants, blocks, thèmes et traductions.

waka-ui est la bibliothèque de composants que Wakastart met à disposition pour construire l'interface de votre [wakapp](/v1.0/glossaire#wakapp). Elle est publiée sur npm sous le nom `@wakastellar/ui` et s'installe comme n'importe quelle dépendance de votre projet Next.js.

Elle vous fournit les briques d'interface (boutons, formulaires, tableaux, fenêtres, graphiques), des écrans complets prêts à brancher, appelés blocks, et la mécanique de thème et de langue qui permet d'habiller l'interface aux couleurs de vos clients et de la traduire.

## Comment ça marche

Votre application déclare trois choses, une fois pour toutes : la feuille de style de waka-ui dans son CSS global, un fournisseur `WakaProvider` à la racine, et les composants qu'elle utilise dans ses pages.

```mermaid
flowchart TB
  CSS["globals.css<br/>styles de waka-ui"] --> V["Variables CSS du thème<br/>--background, --primary…"]
  P["WakaProvider<br/>app/providers.tsx"] --> T["Thème actif<br/>data-theme et classe dark sur html"]
  P --> L["Langue active<br/>i18next, catalogue fr / en"]
  V --> C["Composants et blocks<br/>Button, DataTable, WakaHeader…"]
  T --> C
  L --> C
```

- La feuille de style apporte Tailwind CSS et les variables de couleur que lisent tous les composants.
- `WakaProvider` choisit le thème et la langue, les mémorise dans le navigateur et les expose à vos composants par des hooks.
- Les composants ne contiennent aucune couleur en dur : changer de thème change toute l'interface.

waka-ui ne parle pas à Wakastart. C'est votre application qui lit l'habillage, les traductions et l'identité de l'utilisateur sur la plateforme, puis les transmet à waka-ui. Le partage des rôles est détaillé dans [waka-ui et Wakastart](/v1.0/interface-waka-ui/waka-ui-et-wakastart).

## Commencer

::::cards{cols=3}
:::card{title="Installer waka-ui" href="/v1.0/interface-waka-ui/installer-waka-ui" icon="Package"}
Ajouter le paquet, les styles et le fournisseur à un projet Next.js.
:::
:::card{title="Appliquer le thème" href="/v1.0/interface-waka-ui/appliquer-le-theme" icon="Palette"}
Thèmes intégrés, mode sombre et thème de l'organisation de l'utilisateur.
:::
:::card{title="Traduire l'interface" href="/v1.0/interface-waka-ui/traduire-l-interface" icon="Languages"}
Charger vos traductions Wakastart et suivre la langue de l'utilisateur.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Composants et blocks" href="/v1.0/interface-waka-ui/composants-et-blocks" icon="LayoutGrid"}
Plus de 250 composants accessibles, basés sur Radix UI, et des écrans complets.
:::
:::card{title="Tableaux de données" href="/v1.0/interface-waka-ui/composants-et-blocks#tableaux-de-données" icon="Table"}
Tri, filtres, pagination, sélection et export, sur TanStack Table.
:::
:::card{title="Thèmes" href="/v1.0/interface-waka-ui/appliquer-le-theme" icon="SwatchBook"}
Six thèmes intégrés, un mode sombre et vos propres thèmes.
:::
:::card{title="Textes traduits" href="/v1.0/interface-waka-ui/traduire-l-interface" icon="Globe"}
Les textes des composants existent en français et en anglais.
:::
::::

Le catalogue complet des composants, avec leurs variantes et leurs propriétés, se consulte sur le design system [ui.wakastart.app](https://ui.wakastart.app).

## Produits liés

::::cards{cols=3}
:::card{title="Apparence" href="/v1.0/apparence" icon="Palette"}
Les thèmes et visuels de vos réseaux et de vos clients.
:::
:::card{title="Langues et traductions" href="/v1.0/langues-et-traductions" icon="Languages"}
Les langues de l'application et ses fichiers de traduction.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Connecter vos utilisateurs et lire leur contexte.
:::
::::

## Ressources

- [Référence de waka-ui](/v1.0/interface-waka-ui/reference) : prérequis, points d'entrée du paquet, configuration du fournisseur, hooks.
- [Résoudre les problèmes de waka-ui](/v1.0/interface-waka-ui/depannage).
- [Le paquet `@wakastellar/ui` sur npm](https://www.npmjs.com/package/@wakastellar/ui) : versions publiées.
