Web

DuelDeDame

2026 loupix57 MIT Actif
DuelDeDame

Jeu de dames en ligne temps reel, Next.js et NestJS, design patterns (Strategy, Factory)

Technologies

Next.jsNestJSTypeScript

Documentation du projet

Duel de Dame

Un jeu de dames moderne, jouable en ligne avec un ami, développé avec Next.js (front) et NestJS (API temps réel) en TypeScript.

🎮 Fonctionnalités

  • Plateau de jeu 8x8
  • Pions blancs et noirs
  • Déplacement des pièces
  • Alternance des tours
  • Jouable à deux en ligne (temps réel)
  • Interface moderne et responsive

🚀 Installation & Lancement

  • Clone le repository :
  • git clone [URLDUREPO]
    cd duel-de-dame
    
  • Installe toutes les dépendances :
  • npm install
    
  • Configure les variables d'environnement :
  • Crée un fichier .env à la racine (voir exemple plus bas).
  • Lance le projet en mode développement (front + back) :
  • npm run dev
    

    Scripts utiles

    • npm run dev:front : Lance uniquement le front Next.js
    • npm run dev:back : Lance uniquement le backend NestJS (API temps réel)
    • npm run build : Build front + back pour la prod
    • npm run start:front : Démarre le front Next.js en mode prod
    • npm run start:back : Démarre l'API NestJS en mode prod

    ⚙️ Variables d'environnement

    Exemple de .env à la racine :
    # --- Backend ---
    NESTPORT=3001
    NESTCORSORIGIN=http://localhost:3000
    

    --- Frontend ---

    NEXT
    PUBLICAPIURL=http://localhost:3001

    👥 Jouer en ligne avec un ami

    • Clique sur "Créer une partie" pour obtenir un code de partie.
    • Envoie ce code à ton ami pour qu'il puisse rejoindre.
    • Quand vous êtes deux, la partie commence et chaque coup est synchronisé en temps réel !

    🛠️ Technologies utilisées

    • Next.js 14 (frontend)
    • NestJS 11 (backend temps réel)
    • TypeScript
    • Tailwind CSS
    • Socket.IO (temps réel)
    • Design Patterns (MVC, Observer, Factory, Strategy)

    🎯 Règles du jeu

  • Les pions se déplacent uniquement en diagonale vers l'avant
  • Les pions peuvent capturer les pièces adverses en sautant par-dessus
  • Un pion qui atteint la dernière rangée devient une dame
  • Les dames peuvent se déplacer en diagonale sur n'importe quelle distance
  • Le joueur qui capture toutes les pièces adverses gagne
  • 🤝 Contribution

    Les contributions sont les bienvenues ! N'hésite pas à :

  • Fork le projet
  • Créer une branche pour ta fonctionnalité
  • Commiter tes changements
  • Pousser vers la branche
  • Ouvrir une Pull Request
  • 📝 Licence

    Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

    Code source

    Projet open source hébergé sur GitHub.

    • 0 étoiles
    • 0 forks
    • TypeScript
    Voir le dépôt GitHub

    Projets suggeres