🗡️ Adventure Tome - Le Jeu Dont Tu Es Le Héro

Application PWA mobile pour gérer vos personnages des livres "Le jeu dont tu es le héro" de la collection La Saga de Dagda.

🎮 Lancer l'application | 📖 Documentation | 📝 Nouveautés

---

📖 Description

Adventure Tome est votre compagnon mobile pour vivre vos aventures épiques ! Créez et gérez vos héros, suivez votre progression, lancez les dés, combattez des créatures et explorez les mondes fantastiques des livres dont vous êtes le héro.

Première implémentation : La Harpe des Quatre Saisons

✨ Fonctionnalités

🎭 Gestion des personnages

• ✓ Créer et personnaliser vos héros
• ✓ Suivre Habileté, Endurance, Chance
• ✓ Gérer inventaire (or, provisions, équipement)
• ✓ Importer/Exporter vos personnages

⚔️ Système de jeu

• ✓ Combats automatisés avec calculs
• ✓ Lancer de dés (1 ou 2 dés)
• ✓ Sauvegarder votre position (paragraphe)
• ✓ Bloc-notes pour vos indices

📱 PWA Mobile

• ✓ Installation sur écran d'accueil
• ✓ Fonctionne hors ligne
• ✓ Stockage local (pas de serveur)
• ✓ Interface optimisée mobile
• ✓ Thème heroic fantasy

🛠️ Technologies

• Next.js 16 - Framework React avec App Router
• React 19 - Bibliothèque UI avec React Compiler
• TypeScript 5 - Type safety
• Tailwind CSS 4 - Styling avec theming
• shadcn/ui - Composants UI
• IndexedDB (idb) - Stockage local
• Vitest - Framework de tests unitaires
• Clean Architecture - Séparation logique métier / présentation

📊 Couverture de code

La couverture de tests est automatiquement mesurée et rapportée sur chaque Pull Request. L'architecture Clean permet une couverture élevée avec 293 tests couvrant toutes les couches : Domain, Application, Infrastructure et Presentation (stores, slices, composants).

📋 Prérequis

• Node.js 24+
• pnpm (recommandé)

🚀 Démarrage rapide

# Installer les dépendances
pnpm install

# Mode développement
pnpm dev

# Storybook (développement composants)
pnpm storybook

# Build production
pnpm build && pnpm start

# Build Storybook
pnpm build-storybook

Ouvrez http://localhost:3000 dans votre navigateur.
Storybook disponible sur http://localhost:6006.

📱 Installation PWA

Android (Chrome, Edge) : Menu ⋮ → "Installer l'application"
iOS (Safari) : Bouton Partager ⎋ → "Sur l'écran d'accueil" ➕

📖 Documentation

• 📋 Fonctionnalités complètes
• 🏗️ Architecture technique - Consulter avant toute modification du domaine
• 📚 Guide Storybook - Développement et test des composants
• 📝 Format fiche personnage
• ⚔️ Règles de combat
• 📜 Règles officielles - Source de vérité (La Saga de Dagda)
• 🗡️ Armes légendaires (Tome 3)
• 📦 Glossaire des objets
• 🎨 Guide du thème
• 🤖 Instructions pour agents IA

☕ Soutenir le projet

Ce projet est 100% gratuit et open-source. Si ce projet vous est utile ou si vous voulez soutenir ce jeu, vous pouvez m'offrir un café ☕

Merci pour votre soutien ! ❤️

� Licence

Ce projet est sous licence Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).

✅ Ce que vous POUVEZ faire

• Utiliser l'application pour un usage personnel
• Modifier le code source
• Créer des forks et contribuer via Pull Request
• Partager l'application en citant l'auteur

❌ Ce que vous NE POUVEZ PAS faire

• Utiliser l'application à des fins commerciales
• Vendre ou revendre l'application
• Intégrer l'application dans un produit commercial

💼 Usage commercial

Pour toute utilisation commerciale, veuillez me contacter pour obtenir une licence commerciale.

Copyright © 2025 Bertrand Gressier - Tous droits réservés pour l'usage commercial.