major changes, including tailwind v4

README.md

@@ -183,12 +183,33 @@ uv run manage.py collectstatic
 
 ### CSS Development
 
-The project uses Tailwind CSS with a custom dark theme. CSS files are located in:
+The project uses **Tailwind CSS v4** with a custom dark theme. CSS files are located in:
 - Source: [`static/css/src/input.css`](static/css/src/input.css)
 - Compiled: [`static/css/`](static/css/) (auto-generated)
 
 Tailwind automatically compiles when using the `tailwind runserver` command.
 
+#### Tailwind CSS v4 Migration
+
+This project has been migrated from Tailwind CSS v3 to v4. For complete migration details:
+
+- **📖 Full Migration Documentation**: [`TAILWIND_V4_MIGRATION.md`](TAILWIND_V4_MIGRATION.md)
+- **⚡ Quick Reference Guide**: [`TAILWIND_V4_QUICK_REFERENCE.md`](TAILWIND_V4_QUICK_REFERENCE.md)
+
+**Key v4 Changes**:
+- New CSS-first approach with `@theme` blocks
+- Updated utility class names (e.g., `outline-none` → `outline-hidden`)
+- New opacity syntax (e.g., `bg-blue-500/50` instead of `bg-blue-500 bg-opacity-50`)
+- Enhanced performance and smaller bundle sizes
+
+**Custom Theme Variables** (available in CSS):
+```css
+var(--color-primary)    /* #4f46e5 - Indigo-600 */
+var(--color-secondary)  /* #e11d48 - Rose-600 */
+var(--color-accent)     /* #8b5cf6 - Violet-500 */
+var(--font-family-sans) /* Poppins, sans-serif */
+```
+
 ## 🏗️ Project Structure
 
 ```