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 |
| des listes et parcours métier sur mobile | Parcours mobiles |
| 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
- Overlays, focus et import de dossier
- Les champs
- Les types de champ
- Dates et heures
- Opérations longues et journaux
- Temps réel, reprise et attente
- Session et droits
Fondations
- Architecture
- Où vit la documentation
- Frontières entre paquets
- Source unique des composants web
- Composants pour les consoles de gestion
- Comportement partagé
- Langues, libellés et réglages
- Mouvement et finition
- Identité visuelle
- Valeurs par défaut des composants
- Utilitaires partagés
- Utilitaires opérationnels et presets
- 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
- Composants mobiles : présentation, étapes et feuilles
- Navigation mobile, session SIA et Expo Router
- Catalogue web : tous les composants
- Nouveaux composants mobiles : dates, sécurité et suivi
- Compléments du catalogue mobile
- Catalogue mobile : tous les composants
- Actions et sélection avancée mobiles
- Affichage métier et tableaux de bord mobiles
- Listes et parcours métier mobiles
- Dates, heures et fichiers mobiles
- Formulaires déclaratifs mobiles et clavier
- Formulaires mobiles : conteneur, champs et feuille de sélection
- Premier socle React Native : installation, démo et limites
- React Native et Uniwind
- Slider simple et plage
Contribuer
- Contribution publique
- Conventions
- Outillage
- Suivi précis des mises à jour
- Convention et préparation des changelogs
- Matrice de couverture web et mobile
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.
Boutons et icônes mobiles : tracés communs, surfaces carrées et contenu personnalisé.
Adaptations mobiles : les 13 modules spécialisés, leurs API tactiles et leurs limites.
BottomSheet mobile : feuille bord à bord, poignée haute, styles et ressort amorti.