# SmartMaker - Front (React)

La partie front de SmartMaker est construite avec **React 19**, **Vite**, et **TailwindCSS 4**.

## Stack technique

^ Technologie ^ Version ^ Description ^
| React | 19.x | Framework UI |
| Vite | 6.x | Build tool et dev server |
| TailwindCSS | 4.x | Framework CSS utility-first |
| Redux Toolkit | 2.x | State management |
| i18next | 24.x | Internationalisation |
| Framer Motion | 12.x | Animations |
| Dexie | 4.x | IndexedDB wrapper |
| ky | 1.x | HTTP client |
| Zod | 4.x | Validation de schémas |

## SmartCommon

**SmartCommon** est la bibliothèque de composants React partagés pour toutes les applications SmartMaker.

Repository : https://inligit.fr/cap-rel/dolibarr/smartmaker/smartcommon

### Installation

```
npm install @cap-rel/smartcommon
```

Voir [[smartcommon|SmartCommon]] pour la documentation complète.

## Contenu de SmartCommon

### Providers

Composants qui fournissent le contexte à l'application (''Provider'', ''ApiProvider'', ''ReduxProvider'', etc.).

### Composants de formulaire

  * ''Input'', ''Textarea'', ''Select''
  * ''Calendar'', ''Timer''
  * ''AddressInput'', ''Gps''
  * ''PhotosUploader'', ''AudiosUploader'', ''VideosUploader''
  * ''ColorPicker'', ''IconSelect''
  * ''SignaturePad''
  * ''Editor'' (markdown)

### Composants d'affichage

  * ''String'', ''Text'', ''Number''
  * ''Datetime'', ''Duration''
  * ''Email'', ''Url'', ''PhoneNumber''
  * ''Address'', ''Coordinates''
  * ''Color'', ''Icon'', ''Tags''

### Composants UI

  * ''Page'', ''Block'', ''Panel'', ''Popup''
  * ''List'', ''ListItem''
  * ''Carousel'', ''DataTable'', ''Chart''
  * ''Navbar'', ''Sidebar'', ''Tabbar''
  * ''Button'', ''Icon'', ''Spinner'', ''Tag''

### Hooks

  * ''useApi'' - Appels API avec auth JWT
  * ''useGlobalStates'' - État global persistant
  * ''useStates'' - État local
  * ''useForm'' - Gestion de formulaires
  * ''useDb'' - Base IndexedDB
  * ''useNavigation'' - Navigation router
  * ''useIntl'' - Formatage dates/nombres

Voir [[hooks|Hooks]] pour la documentation complète.

## Documentation

  * [[architecture|Architecture]] - Structure des fichiers
  * [[smartcommon|SmartCommon]] - Liste des composants
  * [[hooks|Hooks]] - Documentation des hooks
  * [[routage|Routage]] - Navigation et routes
  * [[requetes_api|Requêtes API]] - Appels serveur
  * [[stockage_de_donnees|Stockage de données]] - Persistance locale
  * [[traductions|Traductions]] - Internationalisation
  * [[themes|Thèmes]] - Personnalisation CSS
  * [[pwa|PWA]] - Configuration Progressive Web App
  * [[astuces|Astuces]] - Bonnes pratiques