diff --git a/README.md b/README.md
index d60d5104c385..b349d3dec907 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,336 @@
-# The Algorithms - Java
+
+
+# ๐ท The Algorithms - Java
+
+
+
+### All algorithms implemented in Java (for educational purposes)
[](https://github.com/TheAlgorithms/Java/actions/workflows/build.yml)
[](https://codecov.io/gh/TheAlgorithms/Java)
[](https://discord.gg/c7MnfGFGa6)
[](https://gitpod.io/#https://github.com/TheAlgorithms/Java)
+[](https://gitpod.io/#https://github.com/TheAlgorithms/Java)
-You can run and edit the algorithms, or contribute to them using Gitpod.io (a free online development environment) with a single click.
+---
-[](https://gitpod.io/#https://github.com/TheAlgorithms/Java)
+**[๐ Explore Algorithms](DIRECTORY.md)** โข **[๐ค Contributing](CONTRIBUTING.md)** โข **[๐ฌ Community](https://discord.gg/c7MnfGFGa6)**
+
+
+
+```
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ โ
+โ ๐ Educational implementations of algorithms in Java โ
+โ ๐ฏ Focus on code clarity and learning โ
+โ ๐งช Comprehensive test coverage โ
+โ ๐ Well-documented with JavaDoc โ
+โ โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+```
+
+## ๐ Overview
+
+This repository contains **Java implementations** of common algorithms and data structures. These implementations are for **learning purposes** and prioritize code clarity over performance. They may be less efficient than the Java standard library.
+
+
+๐ What's Inside?
+
+
+
+| Feature | Description |
+|---------|-------------|
+| ๐ **Clean Code** | Readable implementations with clear variable names |
+| ๐งช **Test Coverage** | JUnit test coverage for most algorithms |
+| ๐ **Documentation** | JavaDoc comments with time/space complexity |
+| โ **Modern Java** | Leverages Java 21 features |
+| ๐๏ธ **Organized** | Algorithms grouped by category |
+
+
+
+---
+
+## ๐ Getting Started
+
+
+
+|
+
+### ๐ Prerequisites
+
+```bash
+โ Java 21+
+๐ฆ Maven 3.6+
+```
+
+ |
+
+
+### โก Quick Setup
+
+```bash
+git clone https://github.com/TheAlgorithms/Java.git
+cd Java
+mvn clean compile
+mvn test
+```
+
+ |
+
+
+
+---
+
+## ๐ก Usage Examples
+
+
+
+```mermaid
+graph LR
+ A[Import Algorithm] --> B[Call Method]
+ B --> C[Get Result]
+ style A fill:#e1f5ff
+ style B fill:#fff3e0
+ style C fill:#e8f5e9
+```
+
+
+
+All algorithms are implemented as static methods. Import and use them directly:
+
+
+
+|
+
+**๐ Dynamic Programming**
+```java
+import com.thealgorithms.dynamicprogramming.Fibonacci;
+
+int fib = Fibonacci.fibonacci(10); // 55
+```
+
+**๐ Sorting**
+```java
+import com.thealgorithms.sorts.QuickSort;
+
+int[] array = {64, 34, 25, 12, 22, 11, 90};
+QuickSort.quickSort(array, 0, array.length - 1);
+```
+
+ |
+
+
+**๐ Graph Algorithms**
+```java
+import com.thealgorithms.datastructures.graphs.DijkstraAlgorithm;
+
+int[][] graph = {{0, 4, 0}, {4, 0, 8}, {0, 8, 0}};
+DijkstraAlgorithm dijkstra = new DijkstraAlgorithm(3);
+int[] distances = dijkstra.run(graph, 0);
+```
+
+**๐ฆ Data Structures**
+```java
+import com.thealgorithms.datastructures.stacks.BalancedBrackets;
+
+boolean isBalanced = BalancedBrackets.isBalanced("{[()]}");
+```
+
+ |
+
+
+
+---
+
+## ๐ Algorithm Categories
+
+
+
+```
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ ALGORITHM CATEGORIES โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+```
+
+
+
+
+
+|
+
+### ๐ Sorting & Searching
+```
+โโโ Binary Search
+โโโ Linear Search
+โโโ Jump Search
+โโโ Quick Sort
+โโโ Merge Sort
+โโโ Heap Sort
+โโโ Radix Sort
+```
+
+### ๐ณ Data Structures
+```
+โโโ Trees
+โ โโโ BST
+โ โโโ AVL
+โ โโโ Red-Black
+โโโ Graphs
+โ โโโ DFS / BFS
+โ โโโ Dijkstra
+โ โโโ Bellman-Ford
+โโโ Collections
+ โโโ Stacks
+ โโโ Queues
+ โโโ Heaps
+```
+
+ |
+
+
+### ๐ฏ Algorithm Techniques
+```
+โโโ Dynamic Programming
+โ โโโ Knapsack
+โ โโโ LCS
+โ โโโ Edit Distance
+โโโ Greedy Algorithms
+โโโ Backtracking
+โ โโโ N-Queens
+โ โโโ Sudoku Solver
+โโโ Divide & Conquer
+```
+
+### ๐ Other Topics
+```
+โโโ Cryptography & Ciphers
+โโโ Mathematical Algorithms
+โโโ String Manipulation
+โโโ Bit Operations
+โโโ Audio Processing
+```
+
+ |
+
+
+
+
+
+๐ **[View Complete Directory โ](DIRECTORY.md)**
+
+
+
+---
+
+## ๐ค Contributing
+
+
+
+```mermaid
+graph LR
+ A[๐ด Fork] --> B[๐จ Code]
+ B --> C[โ
Test]
+ C --> D[๐ค PR]
+ D --> E[๐ Merge]
+ style A fill:#e3f2fd
+ style B fill:#fff3e0
+ style C fill:#e8f5e9
+ style D fill:#fce4ec
+ style E fill:#f3e5f5
+```
+
+
+
+We welcome contributions! Please read our **[Contribution Guidelines](CONTRIBUTING.md)** before you contribute.
+
+
+
+|
+
+### ๐ Quick Start
+
+```bash
+# 1. Fork & Clone
+git clone https://github.com/YOUR_USERNAME/Java.git
+
+# 2. Create Branch
+git checkout -b feature/your-algorithm
+
+# 3. Make Changes & Commit
+git commit -m "Add: Algorithm name"
+
+# 4. Push & Create PR
+git push origin feature/your-algorithm
+```
+
+ |
+
+
+### โ
Requirements
+
+- **JavaDoc** - Document your code
+- **Tests** - Include JUnit tests
+- **Style** - Follow existing patterns
+- **Directory** - Update DIRECTORY.md
+
+
+
+> โ ๏ธ **Note:** We do **not** accept LeetCode problems. Focus on well-known algorithms.
+
+ |
+
+
+
+---
+
+## ๐ Community & Support
+
+
+
+---
+
+
+
+## ๐ License
+
+Licensed under the [MIT License](LICENSE).
+
+
+
+```
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ Made with โค๏ธ by The Algorithms Community โ
+โ โญ Star this repository if you find it helpful! โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+```
-### All algorithms are implemented in Java (for educational purposes)
-These implementations are intended for learning purposes. As such, they may be less efficient than the Java standard library.
+
-## Contribution Guidelines
-Please read our [Contribution Guidelines](CONTRIBUTING.md) before you contribute to this project.
+**[โฌ Back to Top](#-the-algorithms---java)**
-## Algorithms
-Our [directory](DIRECTORY.md) has the full list of applications.
+
