diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1d835c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+
+# terminal.css
+
+A modern CSS framework for terminal-style websites.
+
+## Installation
+
+### CDN Installation
+
+Add these links to your HTML file:
+
+```html
+
+
+
+
+
+
+```
+
+Optional: Add Tailwind CSS for layout utilities (flex, grid, spacing)
+
+```html
+
+```
+
+## How to Use Components
+
+To use any component, simply:
+
+1. Go to the [Components page](./index.html)
+2. Find the component you want to use
+3. Press F12 to open DevTools
+4. Inspect the component and copy the HTML code
+5. Paste it into your project
+
+### Complete HTML Template
+
+```html
+
+
+