diff --git a/Guess_my_number/README.md b/Guess_my_number/README.md
index 3cfcaf49f..3d8a2b5af 100644
--- a/Guess_my_number/README.md
+++ b/Guess_my_number/README.md
@@ -1,19 +1,41 @@
-# Guess my number
+๐ข Guess My Number
-This is a simple game of guessing correct number from 1 to 20 with functionalities like score and highscore.
-### Technologies Used :
+A fun, interactive web-based browser game where the player must guess a secretly generated number between 1 and 20. The game features dynamic score tracking, helpful hints, and saves your highest score during the session!
-
HTML
-CSS
-JavaScript
+โจ Features
+Interactive Gameplay: Guess the correct number with helpful hints provided (e.g., "๐ Too high!" or "๐ Too low!").
-### Steps to use :
+Dynamic Scoring: Start with a maximum score of 20, which decreases with every incorrect guess.
-Download or clone the repository
-Go to (Guess_my_number) folder
-Run the index.html in your browser
-Play ๐
+Highscore Tracking: Keeps a record of your best (highest) score across multiple rounds.
+
+Play Again: Easily reset the game to play another round without losing your high score.
+
+๐ ๏ธ Technologies Used
+HTML5: For structuring the game interface and layout.
+
+CSS3: For styling and visual feedback (like changing the background color when the player wins).
+
+Vanilla JavaScript: For implementing the game logic, state management, and DOM manipulation.
+
+๐ Getting Started
+Follow these simple steps to run the game locally on your machine.
+
+Installation & Usage
+Clone the repository:
+
+Bash
+git clone https://github.com/Ayushparikh-code/Web-dev-mini-projects.git
+Navigate to the project directory:
+
+Bash
+cd Web-dev-mini-projects/Guess_my_number
+Run the game:
+Simply open the index.html file in your preferred web browser. You can do this by double-clicking the file or right-clicking and selecting "Open with -> [Your Browser]".
+
+Play! ๐
+Start guessing numbers between 1 and 20, watch your score, and try to set a new high score.
### Screenshot :
diff --git a/breaking-bad-characters/README.md b/breaking-bad-characters/README.md
index b80369463..f44212945 100644
--- a/breaking-bad-characters/README.md
+++ b/breaking-bad-characters/README.md
@@ -1,33 +1,44 @@
-# Breaking Bad Characters - React Application
+# ๐งช Breaking Bad Characters Explorer
-## About the Project
-A single page web application that uses the breaking bad API to display and filter characters from the show
+A sleek, single-page React application that fetches and displays character data from the Breaking Bad universe. Users can easily browse and dynamically filter through their favorite characters using real-time API data.
-## Technologies Used
+This project is part of the `Web-dev-mini-projects` collection.
-- React
- - Hooks
- - Components
-- CSS
- - CSS Grid
-- Javascript
- - Axios
- - ES6
-- API
- - Breaking Bad API
+## โจ Key Features
+* **Dynamic Grid Layout:** Displays character profiles in a highly responsive CSS Grid.
+* **Live Filtering:** Instantly search and filter characters by name.
+* **API Integration:** Asynchronously fetches character details (like name, nickname, and portrait) from an external endpoint.
+## ๐ ๏ธ Tech Stack
+* **Frontend Framework:** React (Functional Components & Hooks)
+* **Styling:** CSS3 (focused on CSS Grid for layout)
+* **JavaScript:** ES6+ syntax
+* **Data Fetching:** Axios for handling asynchronous HTTP requests
-## API Used
-Breaking Bad Character API
+## ๐ก API Reference
+This project relies on the Breaking Bad Character API to populate the user interface.
+* **Endpoint Used:** `https://www.breakingbadapi.com/api/characters`
-Link : https://www.breakingbadapi.com/api/characters
+## ๐โโ๏ธ How to Run Locally
-## How to use the Project
+To get this React application running on your local machine, follow these steps:
-1. Download or clone the repository `git clone https://github.com/Ayushparikh-code/Web-dev-mini-projects.git`
-2. Go to the directory
-3. Open the terminal, and type `npm start`
+1. **Clone the repository:**
+ ```bash
+ git clone [https://github.com/Ayushparikh-code/Web-dev-mini-projects.git](https://github.com/Ayushparikh-code/Web-dev-mini-projects.git)
+Navigate to the directory:
+Open your terminal and change into the specific Breaking Bad project folder.
+Install dependencies:
+Because this project uses React and Axios, you must install the Node modules first:
+
+Bash
+npm install
+Start the development server:
+
+Bash
+npm start
+The application will automatically compile and open in your default browser at http://localhost:3000
## Screenshots
diff --git a/speed-distance-time-calculator/readme.md b/speed-distance-time-calculator/readme.md
index f45819b1b..ed56c50e0 100644
--- a/speed-distance-time-calculator/readme.md
+++ b/speed-distance-time-calculator/readme.md
@@ -1,5 +1,34 @@
-# Welcome ๐ to the Speed-Distance-Time Calculator Website
-It is a multi pager Speed Distance Time Calculator with simple but user-friendly design.
+# โฑ๏ธ Speed-Distance-Time Calculator
+
+A clean, multi-page web application designed to instantly calculate speed, distance, or time. Featuring a simple and user-friendly interface, this tool provides dedicated calculation pages for each specific metric to ensure a frictionless user experience.
+
+This project is part of the `Web-dev-mini-projects` collection.
+
+## โจ Key Features
+* **Multi-Page Architecture:** Dedicated pages tailored specifically for calculating Speed, Time, and Distance individually.
+* **Instant Results:** Performs mathematical conversions and calculations in real-time.
+* **Intuitive UI:** A straightforward, accessible design that makes navigation and data entry effortless.
+* **No Dependencies:** Built entirely with pure web technologies for rapid load times.
+
+## ๐ ๏ธ Tech Stack
+* **HTML5:** Semantic structure and multi-page routing.
+* **CSS3:** Custom styling for a clean, responsive layout.
+* **Vanilla JavaScript:** Mathematical logic and DOM manipulation.
+
+## ๐โโ๏ธ How to Run Locally
+
+Getting this project running on your machine takes just a few seconds:
+
+1. **Clone the repository:**
+ ```bash
+ git clone [https://github.com/Ayushparikh-code/Web-dev-mini-projects.git](https://github.com/Ayushparikh-code/Web-dev-mini-projects.git)
+Navigate to the correct directory:
+Open your terminal and change into the specific calculator folder:
+
+Bash
+cd Web-dev-mini-projects/speed-distance-time-calculator
+Run the application:
+Simply double-click the index.html file to open the Homepage in your default web browser. (Alternatively, use the "Live Server" extension in VS Code for a better development experience).
## Default view of the website
HOMEPAGE
@@ -25,23 +54,6 @@ Distance Calculator
-### How to get the website on your local machine:
-
----
-
-- Download or clone the repository
-
-```
-git clone https://github.com/Ayushparikh-code/Web-dev-mini-projects.git
-```
-
-- Go to the directory
-```
-cd speed-distance-time-calculator
-````
- - Run the index.html file and see the results
-
-
## Happy Coding!