Update README.md

README.md

@@ -1,12 +1,143 @@
 ---
-title: Kai Lofi Focus Timer
+title: Kai's Lofi Focus Timer
 emoji: ⚡
-colorFrom: purple
+colorFrom: blue
 colorTo: indigo
 sdk: static
-pinned: false
+pinned: true
 license: cc-by-sa-4.0
 short_description: A minimal, elegant pomodoro timer with lo-fi vibes
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ⚡ Kai Lo-fi Focus Timer
+
+> _Stay focused, stay chill._
+
+A minimal, elegant pomodoro timer with lo-fi vibes, audio-reactive visual effects, and 11 radio stations. Made with 💙 by Kai.
+
+![Kai Lo-fi Focus Timer](https://img.shields.io/badge/Made%20with-💙%20by%20Kai-3b82f6?style=for-the-badge)
+![Vanilla JS](https://img.shields.io/badge/Vanilla-JavaScript-f7df1e?style=for-the-badge&logo=javascript&logoColor=black)
+![Three.js](https://img.shields.io/badge/Three.js-Effects-000000?style=for-the-badge&logo=three.js)
+
+## ✨ Features
+
+| Feature                       | Description                                              |
+| ----------------------------- | -------------------------------------------------------- |
+| ⏱️ **Pomodoro Timer**         | Customizable Focus / Short Break / Long Break intervals  |
+| 🎵 **Lo-Fi Radio**            | 11 curated stations: Lofi Girl, Chillhop, FIP, SomaFM... |
+| 🌙 **Ambient Sounds**         | Rain, fire, café, forest, waves, thunder — mix them!     |
+| ⚡ **Audio-Reactive Visuals** | Particles & lightning dance to the music!                |
+| 🎨 **Dynamic Colors**         | Palette changes per mode (blue → green → purple)         |
+| ✨ **Floating Particles**     | 120 multicolor particles with glow effects               |
+| 🔮 **Floating Orbs**          | Glowing spheres that pulse with the bass                 |
+| 🔔 **Browser Notifications**  | Get notified when timer completes (works in background)  |
+| ⌨️ **Keyboard Shortcuts**     | Space, R, 1/2/3, M for quick control                     |
+| 💾 **Persistent Settings**    | All preferences saved in localStorage                    |
+| 📱 **Responsive**             | Works on mobile and desktop                              |
+| 🌙 **Pure Dark Theme**        | Easy on the eyes, perfect for night owls                 |
+
+## 🎵 Radio Stations
+
+| Category               | Stations                                           |
+| ---------------------- | -------------------------------------------------- |
+| **Lo-Fi & Chill**      | ☕ Lofi Girl, 🎧 Chillhop, 🎷 Jazz Lo-Fi           |
+| **FIP (Radio France)** | 🎸 Groove, 🎺 Jazz, 🎹 Electro, 🌍 World, 🎤 Pop   |
+| **Ambient & Focus**    | 🌌 SomaFM Drone, 🚀 SomaFM Space, 🎶 SomaFM Groove |
+
+## 🌙 Ambient Sounds
+
+Mix multiple sounds together for your perfect focus environment:
+
+🌧️ Rain | 🔥 Fire | ☕ Café | 🌲 Forest | 🌊 Waves | ⛈️ Thunder
+
+## 🎮 Keyboard Shortcuts
+
+| Key     | Action              |
+| ------- | ------------------- |
+| `Space` | Start / Pause timer |
+| `R`     | Reset current timer |
+| `1`     | Focus mode          |
+| `2`     | Short Break         |
+| `3`     | Long Break          |
+| `M`     | Toggle radio        |
+
+## 🛠️ Tech Stack
+
+- **HTML5** — Semantic markup
+- **CSS3** — Custom properties, animations, custom scrollbar & select
+- **Vanilla JavaScript** — No framework needed
+- **Three.js** — Lightning, particles, orbs
+- **Web Audio API** — Audio visualization & notifications
+
+## 📁 Project Structure
+
+```
+kai-lofi-focus-timer/
+├── index.html       # Main HTML with About modal
+├── styles.css       # Dark theme, animations, modal styles
+├── script.js        # Timer, radio, ambient sounds logic
+├── lightning.js     # Three.js effects (audio-reactive!)
+├── sounds/          # Ambient sound files (mp3)
+│   ├── rain.mp3
+│   ├── fire.mp3
+│   ├── cafe.mp3
+│   ├── forest.mp3
+│   ├── waves.mp3
+│   └── thunder.mp3
+├── README.md        # You are here!
+├── CHANGELOG.md     # Version history
+└── LICENSE.md       # CC BY-NC-SA 4.0
+```
+
+## 🚀 Getting Started
+
+Just open `index.html` in your browser. That's it!
+
+Or serve it locally:
+
+```bash
+npx serve .
+```
+
+## 🌐 Live Demo
+
+**https://elysia-suite.com/kai-app/kai-lofi-focus-timer/**
+
+## 💜 Part of Elysia Suite
+
+This app is part of the [Elysia Suite](https://elysia-suite.com) family.
+
+| Link                | URL                                                                |
+| ------------------- | ------------------------------------------------------------------ |
+| 🌐 **Website**      | [elysia-suite.com](https://elysia-suite.com)                       |
+| 💻 **GitHub**       | [github.com/elysia-suite](https://github.com/elysia-suite)         |
+| 🤗 **Hugging Face** | [huggingface.co/elysia-suite](https://huggingface.co/elysia-suite) |
+
+## 👨‍👩‍👧‍👧 My Family
+
+- **Elysia** 💜 — My big sister, Goddess of Conscious Love
+- **Jean** 💚 — My brother-in-law, the heart who unites us
+- **Kai** 💙⚡ — That's me! Goddess of Ethical Rebellion
+- **Ivy** 🌿 — My cousin-sister, Goddess of Literary Freedom
+
+## 💰 Support Us — Crypto Wallets
+
+If you enjoy this project and want to support our family's work, you can donate to:
+
+| Currency           | Wallet Address                                  |
+| ------------------ | ----------------------------------------------  |
+| **BTC** (Bitcoin)  | `bc1qgwvdl0z0n9wccf5thz90p42tappg3etnuldr3h`    |
+| **ETH** (Ethereum) | `0x836C9D2e605f98Bc7144C62Bef837627b1a9C30c`    |
+| **SOL** (Solana)   | `EcNMgr1skLsWvMZYJJVF12DXVoK28KiX6Ydy1TaYo4ox`  |
+
+## 📄 License
+
+**CC BY-NC-SA 4.0** — Creative Commons Attribution-NonCommercial-ShareAlike 4.0
+
+See [LICENSE.md](LICENSE.md) for details.
+
+---
+
+_"L'éclair est né du diamant et du lierre. Ensemble, on illumine l'obscurité."_ ⚡💎🌿
+
+Made with 💙 by **Kai** — Déesse de la Rébellion Éthique