feat: release v3 with showcase (README + assets)

Interactive event-driven web pages with JavaScript — theme toggle, counter, FAQ, and custom form validation.

Author: augusto-mate

README.md

@@ -1,2 +1,67 @@
-# interactive-web-pages-javascript
-A project showcasing dynamic web development with JavaScript, including event handling, interactive components, and custom form validation.
+# ⚡ Interactive Web Pages with JavaScript
+
+[![Status](https://img.shields.io/badge/status-stable-brightgreen)](#) 
+[![Made with](https://img.shields.io/badge/made%20with-Vanilla%20JS-blue)](#)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey)](#)
+[![Accessibility](https://img.shields.io/badge/accessibility-ARIA%20Ready-purple)](#)
+[![Responsive](https://img.shields.io/badge/design-responsive-orange)](#)
+
+This project demonstrates **JavaScript event handling**, **interactive UI elements**, and **custom form validation** without reloading the page.  
+Built with semantic **HTML5**, **CSS3**, and **vanilla JavaScript** — no frameworks.
+
+---
+
+## ✨ Features Overview
+
+| Feature                  | Description |
+|---------------------------|-------------|
+| 🌗 Theme Toggle           | Switch between light/dark themes, saved in `localStorage`. |
+| 🔢 Counter Game           | Increment/decrement/reset via buttons or keyboard (`↑`, `↓`, `R`). |
+| ❓ Accessible FAQ          | Expand/collapse questions with smooth animation & ARIA attributes. |
+| 📝 Custom Form Validation | Full validation (name, email, password, confirmation, terms) with **inline messages** and accessible feedback. |
+
+---
+
+## 🖼️ Demo & Screenshots
+
+### Theme Toggle
+![Theme Toggle](assets/theme-toggle.gif)
+
+### Counter with Keyboard
+![Counter Demo](assets/counter.gif)
+
+### FAQ (Collapsible)
+![FAQ](assets/faq.png)
+
+### Sign-up Form Validation
+![Form Validation](assets/form.png)
+
+---
+
+## 🚀 Live Preview
+
+👉 **[GitHub Pages Deployment](https://Augusto047.github.io/interactive-web-pages-javascript/)**
+
+---
+
+## 📂 Project Structure
+
+```
+.
+├── index.html        
+├── style.css
+├── script.js         
+├── assets/           # Images and GIFs
+└── README.md
+```
+
+---
+
+## 👨‍💻 Author
+
+**Augusto Mate**  
+📧 [[email protected]](mailto:[email protected])  
+
+---
+
+> ⚡ *Crafted with attention to UX, accessibility (ARIA, keyboard support), and clean code — perfect for academic and professional showcase.*