lucid_core_flutter

Socle Flutter de LucidForge Africa : client API, authentification, stockage chiffré, thème et widgets réutilisables. Développé par ForgeLab, le laboratoire open source de LucidForge Africa.

Getting Started

Ce package est le socle commun des applications Flutter de LucidForge Africa, dont l'application mobile de ForgeNet. Il centralise les services, utilitaires et widgets réutilisables afin de garantir une cohérence technique et visuelle sur l'ensemble des projets.

Depuis pub.dev :

flutter pub add lucid_core_flutter

Ou, pour suivre une version précise du dépôt :

dependencies:
  lucid_core_flutter:
    git:
      url: https://github.com/forgelab-dev/lucid_core_flutter.git
      ref: v0.0.1

Les versions disponibles sont listées dans les releases et le CHANGELOG.

Pour commencer avec le développement Flutter, consultez la documentation en ligne, qui propose des tutoriels, des exemples, des guides sur le développement mobile et une référence complète de l'API.

Features

• Client API HTTP (LucidApiClient) : GET/POST/PUT/PATCH/DELETE, upload multipart, cache-first sur les GET, retry automatique sur erreurs transitoires et mapping des erreurs vers la taxonomie LucidAbstractException.
• Authentification : implémentations Firebase (LucidFirebaseAuthService) et Supabase (LucidSupabaseAuthService) de LucidAbstractAuthService, avec connexion sociale découplée de tout SDK tiers.
• Stockage & persistance : stockage sécurisé (LucidSecureStorage), cache chiffré (AES-256-GCM) et compressé (gzip) sur disque (LucidCacheStorage), préférences partagées.
• Configuration : résolveur de configuration unifié (LucidAbstractConfigResolver) avec overrides dynamiques, environnement (dev/staging/prod) et constantes par défaut.
• Thème : thèmes clair/sombre alignés sur la charte graphique LucidForge Africa (navy #020617, or #D4A017).
• Widgets : LucidApp, LucidListManager, LucidNavigationManager, LucidButton, LucidTextField, LucidEmptyState, LucidErrorState — tous branchés sur le thème et la localisation.
• Internationalisation : localisation française (LucidL10n) et extensions utilitaires (String, num, BuildContext, etc.).

API Reference

Chaque API publique est documentée par des doc comments (///). La référence est générée automatiquement sur pub.dev, ou en local avec :

dart doc

Contribuer

Les contributions sont les bienvenues : voir CONTRIBUTING.md.

License

Distribué sous licence Apache 2.0. Copyright 2025-2026 LucidForge Africa.

La licence couvre le code, pas la marque : les noms « LucidForge Africa » et « ForgeLab » ainsi que leurs logos ne peuvent pas être utilisés pour présenter un produit dérivé comme officiel sans autorisation écrite.