Update README.md

Author: bocaletto-luca

README.md

@@ -1,2 +1,51 @@
-# texas-holdem
-texas-holdem
+# Texas Hold'em Web Game
+
+![HTML5](https://img.shields.io/badge/HTML5-E34F26?logo=html5&style=for-the-badge)
+![CSS3](https://img.shields.io/badge/CSS3-1572B6?logo=css3&style=for-the-badge)
+![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&style=for-the-badge)
+![WebGame](https://img.shields.io/badge/WebGame-TexasHold%27em-blue?style=for-the-badge)
+![Project Completed](https://img.shields.io/badge/Project-Completed-green?style=for-the-badge)
+![GPLv3](https://img.shields.io/badge/License-GPLv3-blue?style=for-the-badge)
+
+## Overview
+
+**Texas Hold'em Web Game** is a dynamic, browser‑based poker experience that faithfully replicates the excitement of the classic Texas Hold'em variant. Built with HTML5, CSS3, and JavaScript, the game offers authentic gameplay with customizable options, smart AI opponents, and a responsive, modern interface that lets you play directly in your browser—no installation required.
+
+## Installation
+
+No installation is necessary. Simply host the files on any HTTP/HTTPS server (for example, using Apache or a static hosting service) and open `index.html` in your browser.
+
+## Usage
+
+- **Objective:**  
+  Compete in a Texas Hold'em poker game by playing against AI opponents. Make the best hand from your two hole cards and five community cards to win the pot.
+
+- **Game Features:**  
+  - **Realistic Gameplay:** Experience authentic Texas Hold'em rules including betting rounds, hand ranking, and pot splitting.
+  - **Customizable Settings:** Adjust game options such as blind levels, number of AI players, and chip counts.
+  - **Responsive Interface:** Enjoy smooth animations and an intuitive UI that works on desktops and mobile devices.
+  - **Score and Bankroll Tracking:** Keep track of your wins, losses, and chip totals as you progress.
+
+- **Controls:**  
+  Interact using on-screen buttons for betting, checking, folding, and calling. The game provides clear visual feedback and prompts during each round.
+
+## Technologies Used
+
+- **HTML5** – Provides the structure and semantic markup.
+- **CSS3** – Delivers responsive styling and smooth animations.
+- **JavaScript** – Powers the game logic, card shuffling, betting system, and AI decision-making.
+- **Custom Poker Engine** – Implements Texas Hold'em rules, hand evaluation, and smart AI behavior.
+- **Bootstrap 5** – Offers modern UI components and responsiveness.
+
+## License
+
+This project is released under the [GPLv3 License](https://www.gnu.org/licenses/gpl-3.0.en.html).
+
+## Author
+
+**Bocaletto Luca**  
+[GitHub](https://bocaletto-luca.github.io) • [Official Site](https://bocalettoluca.altervista.org)
+
+---
+
+Enjoy the game, refine your poker skills, and immerse yourself in the thrill of Texas Hold'em!