diff --git a/README.md b/README.md
index 1d3ae29..f745c24 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,55 @@
-# web_se_ex1
\ No newline at end of file
+# Web SE Exercise 1 - Simple Calculator
+
+A simple, interactive calculator web application built with HTML, CSS, and JavaScript.
+
+## Features
+
+- Basic arithmetic operations (addition, subtraction, multiplication, division)
+- Clear and delete functions
+- Keyboard support for easy input
+- Responsive design with gradient background
+- Error handling for invalid expressions
+
+## How to Use
+
+1. **Open the Application**
+ - Simply open `index.html` in your web browser
+ - No installation or build process required
+
+2. **Using the Calculator**
+ - Click on the number and operator buttons to build your calculation
+ - Press `=` or `Enter` to calculate the result
+ - Use `C` or `Escape` to clear the display
+ - Use `DEL` or `Backspace` to delete the last character
+
+3. **Keyboard Shortcuts**
+ - Numbers: `0-9`
+ - Operators: `+`, `-`, `*`, `/`
+ - Decimal: `.`
+ - Calculate: `Enter` or `=`
+ - Clear: `Escape` or `C`
+ - Delete: `Backspace`
+
+## File Structure
+
+```
+web_se_ex1/
+├── index.html # Main HTML structure
+├── style.css # CSS styling
+├── script.js # JavaScript functionality
+└── README.md # This file
+```
+
+## Technologies Used
+
+- HTML5
+- CSS3 (with Grid layout and gradients)
+- Vanilla JavaScript (ES6+)
+
+## Browser Compatibility
+
+Works on all modern browsers including:
+- Chrome
+- Firefox
+- Safari
+- Edge
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..346e6a6
--- /dev/null
+++ b/index.html
@@ -0,0 +1,42 @@
+
+
+
+
+
+ Simple Calculator - Web SE Exercise 1
+
+
+
+