Skip to content

Novalya-Labs/10clicks

Repository files navigation

🎯 Chase Button

Un jeu de réflexes amusant et compétitif où chaque clic compte !

🎮 Caractéristiques

  • Mode Normal : Atteignez 10 clics le plus rapidement possible
  • Mode Temps : Faites le maximum de clics en 10 secondes
  • Modes Spéciaux :
    • 🌟 Golden Clicker : Cibles dorées à cliquer plusieurs fois
    • 🚔 USA Cops : Cibles rouges et noires
    • 🦠 Bactérie : Cibles qui bougent
    • 🤝 Parkinson : Écran tremblant
    • 🌈 Épileptique : Changements de couleur
    • 💀 Hardcore : Perte si clic hors cible

🚀 Démarrage Rapide

# Installation des dépendances
npm install

# Lancement en développement
npm run dev

# Build de production
npm run build

# Déploiement sur Cloudflare Pages
npm run deploy

🛠 Technologies

  • Framework : React 18 avec TypeScript
  • Styling : Tailwind CSS + shadcn/ui
  • State : Zustand avec persistance locale
  • Routing : React Router 6
  • Build : Vite
  • Linting : Biome
  • PWA Ready : Vite PWA

📁 Structure du Projet

chase-button/
├── src/
│   ├── components/     # Composants réutilisables
│   ├── contexts/      # Contextes React
│   ├── hooks/         # Hooks personnalisés
│   ├── layouts/       # Layouts de l'app
│   ├── pages/         # Pages
│   └── stores/        # Stores Zustand

🎯 Règles du Jeu

Mode Normal

  1. Cliquez sur la cible qui apparaît
  2. Atteignez 10 clics pour gagner
  3. Les modes spéciaux ajoutent des défis

Mode Temps

  1. Vous avez 10 secondes
  2. Faites le maximum de clics
  3. Les modes spéciaux sont compatibles

🏆 Système de Score

  • Stockage des 100 derniers scores
  • Historique détaillé par partie
  • Statistiques par mode et difficulté
  • Persistance locale des données

🎨 Personnalisation

Thèmes

  • Mode clair/sombre
  • UI moderne et responsive
  • Composants shadcn personnalisables

Difficultés

  • 🌱 Débutant : Pour commencer
  • 👊 Intermédiaire : Challenge équilibré
  • 🎯 Sniper : Pour les experts

🔧 Scripts

  • npm run dev : Développement
  • npm run build : Production
  • npm run deploy : Déploiement
  • npm run lint : Vérification du code
  • npm run format : Formatage
  • npm run preview : Preview du build
  • npm run generate-pwa-assets : Assets PWA

📱 PWA Support

L'application est installable sur :

  • 📱 Mobile (iOS/Android)
  • 💻 Desktop (Windows/Mac/Linux)
  • Fonctionne hors-ligne

🤝 Contribution

  1. Fork le projet
  2. Créez votre branche (git checkout -b feature/AmazingFeature)
  3. Commit (git commit -m 'Add some AmazingFeature')
  4. Push (git push origin feature/AmazingFeature)
  5. Ouvrez une Pull Request

📜 Conventions

Code

  • TypeScript strict
  • Composants fonctionnels
  • Custom hooks pour la logique
  • Tests pour les features critiques

Style

  • Tailwind pour le styling
  • Classes utilitaires
  • Responsive design
  • Accessibilité (a11y)

🔜 Roadmap

  • Classements en ligne
  • Nouveaux modes de jeu
  • Achievements
  • Mode multijoueur
  • Statistiques avancées

📝 License

MIT License - voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

  • shadcn/ui pour les composants
  • Radix UI pour l'accessibilité
  • La communauté React pour l'inspiration

About

🐭 Click click click !

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published