diff --git a/README.md b/README.md
new file mode 100644
index 0000000..73b2a68
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+# 🎬 Movie Explorer (Java - GUI)
+
+**Movie Explorer** is a dynamic and user-friendly application designed to enhance the movie-watching experience by offering personalized movie recommendations. With an intuitive graphical user interface (GUI), Movie Explorer helps users discover films tailored to their preferences in a fast and engaging way.
+
+---
+
+## 1. Project Overview
+
+- **Project Title**: Movie Explorer
+- **Author**: Basel Al-Raoush
+- **Purpose**: The goal of Movie Explorer is to simplify the process of finding movies that align with the user's taste. Whether users are seeking random movie suggestions, top-rated films by year, or narrowing down choices by genre, Movie Explorer provides a seamless experience.
+
+---
+
+## 2. Features
+
+- **Random Movie Generator**: Instantly receive suggestions for a random movie selection.
+- **Top Rated Movies by Year**: Explore the highest-rated movies for a specified year.
+- **Genre-based Recommendations**: Find movies based on preferred genres.
+- **Search Functionality**: Easily search for movies by title or release year.
+- **User-friendly Interface**: The intuitive GUI ensures a smooth and enjoyable user experience.
+- **Add Movie**: Allows users to add a new movie to the collection.
+- **View Seen Movies**: Displays a list of movies marked as seen by the user.
+
+---
+
+## 3. Technology Stack
+
+- **Programming Language**: Java
+- **Graphical User Interface (GUI)**: Swing (Java)
+- **Data Serialization**: Java Object Serialization
+
+---
+
+## 4. How to Use
+
+### 4.1. Launching the Application
+
+- **Step 1**: Clone the repository
+  ```bash
+  git clone https://github.com/Al-RaoushBasel/Movie-Explorer-JavaGUI.git
+
+Step 2: Open the project in an IDE like IntelliJ IDEA or Eclipse.
+
+Step 3: Compile and run the Main class to launch the Movie Explorer application.