Update README.md

Add detailed README

Author: augusto-mate

README.md

@@ -1,2 +1,28 @@
-# css-box-model-assignment
-Demonstration of CSS basics — color, typography, spacing, borders — and a clear visualization of the Box Model.
+# CSS Basics & The Box Model — Assignment
+
+This repository contains my solution for the **CSS Basics & The Box Model** assignment.  
+It demonstrates the use of fundamental CSS properties and provides a clear visualization of the Box Model.
+
+## 📂 Project Structure
+- `index.html` — semantic HTML structure of the page
+- `styles.css` — external CSS stylesheet (organized, commented, and clean)
+- `index-pt.html` + `styles-pt.css` — Portuguese version (for personal study)
+
+## 🎯 Features Demonstrated
+- Use of **basic CSS properties**: 
+  - `color`
+  - `background`
+  - `font-size` and `font-style`
+  - `margin`
+  - `padding`
+  - `border` and `border-radius`
+- Explicit **Box Model demo** with content, padding, border, and margin
+- Semantic and accessible HTML (`header`, `nav`, `main`, `section`, `footer`)
+- Clean, commented, and maintainable code
+
+## 🌍 Live Demo
+If deployed via GitHub Pages:  
+👉 [View on GitHub Pages](https://USERNAME.github.io/css-box-model-assignment/)
+
+## 📜 License
+This project is provided for educational purposes only.