diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98f181f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# POS Customer Orders
+
+Show the last 2 orders of a customer directly in the POS Customer Details screen.
+
+## Features
+
+- **Order History Visibility**: Quick view of a customer's recent purchases without leaving the customer selection or edit screen.
+- **Enhanced Customer Insight**: Helps cashiers better understand customer preferences and recent interactions.
+- **Seamless Integration**: Integrated directly into the standard Odoo POS Customer Information display.
+
+## Usage
+
+1. **Open POS**: Launch the Point of Sale application.
+2. **Select Customer**: Click on the "Customer" button to select or search for a customer.
+3. **View Details**: Click on the "i" (info) icon or "Edit" button for a customer.
+4. **Recent Orders**: The last 2 orders associated with that customer will be displayed in the details panel.
+
+## Technical Details
+
+- **Module Name**: `pos_customer_orders`
+- **Dependency**: `point_of_sale`
+- **Odoo Version**: 19.0
+- **Authors**: Suherdy Yacob