diff --git a/README.md b/README.md
new file mode 100644
index 0000000..44e3009
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+# POS Cash Opening Adjustment
+
+This module provides adjustments for the POS opening cash mechanism in Odoo 19.
+
+## Features
+- Overrides `_set_opening_control_data` to properly initialize and track `opening_cash_expected` and `opening_cash_counted` while utilizing Odoo's native functionality.
+- Tracks opening cash correctly so that the system correctly calculates differences.
+- Leverages standard Odoo 19 journal handling for robust accounting integration.
+- Suppresses positive cash differences automatically via standard backend validations, adjusting the `cash_register_balance_end_real` to match the expected balance when there is a surplus.
+
+## Technical Details
+This module modifies the `pos.session` object, tracking:
+- **`opening_cash_expected`**: The expected cash balance when opening the session.
+- **`opening_cash_counted`**: The actual cash counted by the cashier.
+- **`opening_cash_difference`**: Computed difference between counted and expected opening cash.
+
+It modifies the standard `_validate_session` process strictly for suppressing positive discrepancies (where the ending cash register is higher than expected), logging the event into the chatter.
+
+## Author
+Suherdy Yacob