SIA UI
Les briques qu'on réécrit dans chaque application de gestion, livrées prêtes à brancher : session et droits, client d'API avec ses greffons (jetons, renouvellement, déconnexion, stockage), ressources et pages CRUD dérivées d'une seule déclaration, formulaires et validation, temps réel, français et anglais, et les utilitaires de montants, dates et fichiers. Les composants React qui les affichent viennent avec.
SIA UI ne cherche pas à avoir le plus beau bouton : il vous évite de réécrire la connexion, le 401, la page de liste et le formatage des montants à chaque projet. Ce qu'il fait, domaine par domaine.
Les composants s'installent de deux façons, au choix et sans s'exclure : par le paquet @sia-ui/react-web, ou copiés dans votre dépôt avec sia-ui add.
pnpm add @sia-ui/react-webPar où commencer
| Vous cherchez | Allez voir |
|---|---|
| ce que fait cette bibliothèque, et en quoi elle diffère | Présentation |
| brancher la connexion et le jeton qui expire | Session et droits · Module API |
| l'installer et poser le thème | Theming |
| construire un écran complet | La coquille d'application |
| une page de liste qui marche | Déclarer une ressource |
| les props d'un composant précis | Référence des composants |
| voir les composants en vrai | Catalogue · Démonstration |
Les trois surfaces, et ce que chacune répond
Aucune ne redit ce que dit une autre — c'est la règle qui les sépare.
| Surface | Répond à | D'où vient le contenu |
|---|---|---|
| Référence | quelles props, quels types | les types eux-mêmes |
| Catalogue | à quoi ça ressemble, dans quel état | les stories |
| Démonstration | à quoi ça ressemble dans un écran | l'application de démonstration |
| Ces pages | pourquoi c'est fait ainsi | écrites à la main |
Sommaire
Démarrer
Guides
- La coquille d'application
- La navigation latérale
- L'avatar
- La page de liste et son tableau
- Déclarer une ressource
- Le contrat de formulaire
- Les champs
- Les types de champ
- Dates et heures
- Opérations longues et journaux
- Session et droits
Fondations
- Architecture
- Où vit la documentation
- Frontières entre paquets
- Source unique des composants web
- Comportement partagé
- Langues, libellés et réglages
- Mouvement et finition
- Identité visuelle
- Valeurs par défaut des composants
- Utilitaires partagés
- Hooks et mode de couleur
- Module API
Distribution
Décisions
Le détail d'un choix précis, quand il mérite d'être retrouvé.
- EntityMeta
- Radius des boutons
- Tooltip des boutons
- Contenu et chargement du Badge
- Contenu et chargement de Input
- Select et Overlay
- Slider simple et plage
Contribuer
Règles documentaires
- Toute modification importante crée ou met à jour un document.
- Le code, les tests et la documentation font partie de la même livraison.
- Un document répond à une question principale.
- Les diagrammes montrent des dépendances ou des flux, pas de la décoration.
- Les exemples correspondent à une API réellement disponible.
- Ce qui est prévu est marqué Prévu, jamais présenté comme fait.
- Ce que le code sait dire, le code le dit. Les props d'un composant se décrivent dans ses types, pas dans une page qui les recopierait.