diff --git a/README.md b/README.md
index 2734d66..0b44be2 100644
--- a/README.md
+++ b/README.md
@@ -1,70 +1,162 @@
-# sexy.pivoine.art
+# ๐ sexy.pivoine.art
-An adult content platform built with SvelteKit, Directus CMS, and hardware integration via Buttplug.io.
+
-[](https://github.com/valknarxxx/sexy/actions/workflows/docker-build-push.yml)
-[](https://github.com/valknarxxx/sexy/actions/workflows/docker-scan.yml)
+
-## Quick Start
+*"Lust und Liebe gehรถren zusammen - wer das eine verteufelt, zerstรถrt auch das andere."*
+โ **Beate Uhse**, Pionierin der sexuellen Befreiung โ๏ธ
-### Using Docker (Recommended)
+---
+
+### ๐ An Intimate Platform for Liberation & Pleasure ๐
+
+Built with passion, technology, and the fearless spirit of sexual empowerment
+
+[](https://github.com/valknarxxx/sexy.pivoine.art/actions/workflows/docker-build-push.yml)
+[](https://github.com/valknarxxx/sexy.pivoine.art/actions/workflows/docker-scan.yml)
+[](LICENSE)
+[](http://sexy.pivoine.art)
+
+
+
+---
+
+## ๐
What Is This Delicious Creation?
+
+Welcome, dear pleasure-seeker! This is **sexy.pivoine.art** โ a modern, sensual platform combining the elegance of **SvelteKit**, the power of **Directus CMS**, and the intimate connection of **Buttplug.io** hardware integration.
+
+Like Beate Uhse breaking barriers in post-war Germany, we believe in the freedom to explore, create, and celebrate sexuality without shame. This platform is built for **models**, **creators**, and **connoisseurs** of adult content who deserve technology as sophisticated as their desires.
+
+### โ Features That'll Make You Blush โ
+
+- ๐ **Sensual SvelteKit Frontend** with Tailwind CSS 4 styling
+- ๐๏ธ **Headless CMS** powered by Directus for content liberation
+- ๐ฎ **Hardware Integration** via Buttplug.io (yes, really!)
+- ๐ **Multi-Platform Support** (AMD64 + ARM64) โ pleasure everywhere
+- ๐ **Session-Based Authentication** โ discretion guaranteed
+- ๐ฑ **Responsive Design** that looks sexy on any device
+- ๐ **Internationalization** โ pleasure speaks all languages
+- ๐ **Analytics Integration** (Umami) โ know your admirers
+- ๐ง **Newsletter Integration** (Letterspace) โ stay connected
+
+
+
+### ๐ Technology Stack ๐
+
+
+
+```
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+โ ๐ Frontend Layer โ
+โ โโ SvelteKit 2.0 โ Smooth as silk โ
+โ โโ Tailwind CSS 4 โ Styled to seduce โ
+โ โโ bits-ui Components โ Building blocks of pleasure โ
+โ โโ Vite โ Fast and furious โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ ๐ท Backend Layer โ
+โ โโ Directus CMS โ Content with no limits โ
+โ โโ Custom Extensions โ Bespoke pleasures โ
+โ โโ PostgreSQL โ Data deep and secure โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ ๐ Hardware Layer โ
+โ โโ Buttplug.io โ Real connections โ
+โ โโ TypeScript + Rust โ Power and precision โ
+โ โโ WebBluetooth API โ Wireless intimacy โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
+โ ๐ธ DevOps Layer โ
+โ โโ Docker โ Containerized ecstasy โ
+โ โโ GitHub Actions โ Automated seduction โ
+โ โโ GHCR โ Images served hot โ
+โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
+```
+
+---
+
+## ๐ฅ Quick Start โ Get Intimate Fast
+
+### ๐ Option 1: Using Docker (Recommended)
```bash
-# Pull and run the latest image
+# Pull the pleasure
docker pull ghcr.io/valknarxxx/sexy:latest
+
+# Run with passion
docker run -d -p 3000:3000 \
-e PUBLIC_API_URL=https://api.your-domain.com \
-e PUBLIC_URL=https://your-domain.com \
ghcr.io/valknarxxx/sexy:latest
+
+# Visit your creation at http://localhost:3000 ๐
```
-See [QUICKSTART.md](QUICKSTART.md) for detailed instructions.
+See [QUICKSTART.md](QUICKSTART.md) for the full seduction guide.
-### Local Development
+### ๐ Option 2: Local Development
**Prerequisites:**
-1. Install Node.js 20.19.1
-2. Enable corepack: `corepack enable`
-3. Install dependencies: `pnpm install`
-4. Install Rust and wasm-bindgen: `cargo install wasm-bindgen-cli`
+1. Node.js 20.19.1 โ *the foundation*
+2. `corepack enable` โ *unlock the tools*
+3. `pnpm install` โ *gather your ingredients*
+4. Rust + `cargo install wasm-bindgen-cli` โ *forge the connection*
-**Start development environment:**
+**Start your pleasure journey:**
```bash
-# Start all services (Docker Compose + frontend)
+# Awaken all services
pnpm dev
-# Or start individually
-pnpm dev:data # Start data services
-pnpm dev:directus # Start Directus CMS
-pnpm --filter @sexy.pivoine.art/frontend dev # Start frontend
+# Or tease them one by one
+pnpm dev:data # The foundation
+pnpm dev:directus # The content
+pnpm --filter @sexy.pivoine.art/frontend dev # The face
```
-Access the application at `http://localhost:3000`
+Visit `http://localhost:3000` and let the experience begin... ๐
-## Project Structure
+---
-This is a pnpm monorepo with three packages:
+## ๐น Project Structure
-- **`packages/frontend`** - SvelteKit application with Tailwind CSS 4
-- **`packages/bundle`** - Directus extensions (endpoints, hooks, themes)
-- **`packages/buttplug`** - Hardware control library (TypeScript + Rust/WASM)
+This monorepo contains three packages, each serving its purpose:
-## Documentation
+```
+sexy.pivoine.art/
+โโ ๐ packages/frontend/ โ SvelteKit app (the seduction)
+โโ ๐ญ packages/bundle/ โ Directus extensions (the power)
+โโ ๐ฎ packages/buttplug/ โ Hardware control (the connection)
+```
-- **[QUICKSTART.md](QUICKSTART.md)** - Get running in 5 minutes with Docker
-- **[DOCKER.md](DOCKER.md)** - Comprehensive Docker deployment guide
-- **[CLAUDE.md](CLAUDE.md)** - Development guide and architecture
-- **[.github/workflows/README.md](.github/workflows/README.md)** - CI/CD workflows
+---
-## Building
+## ๐ Documentation โ Your Guide to Pleasure
+
+
+
+| Document | Purpose | Emoji |
+|----------|---------|-------|
+| [QUICKSTART.md](QUICKSTART.md) | Get wet... I mean, get started! | ๐ฆ |
+| [DOCKER.md](DOCKER.md) | Complete deployment manual | ๐ณ |
+| [CLAUDE.md](CLAUDE.md) | Architecture & development | ๐ค |
+| [.github/workflows/README.md](.github/workflows/README.md) | CI/CD workflows | โ๏ธ |
+
+
+
+---
+
+## ๐จ Building โ Craft Your Masterpiece
### Build All Packages
```bash
+# Prepare everything
pnpm install
+
+# Build the WASM foundation
pnpm --filter @sexy.pivoine.art/buttplug build:wasm
+
+# Build the packages
pnpm --filter @sexy.pivoine.art/buttplug build
pnpm --filter @sexy.pivoine.art/frontend build
pnpm --filter @sexy.pivoine.art/bundle build
@@ -73,102 +165,114 @@ pnpm --filter @sexy.pivoine.art/bundle build
### Build Docker Image
```bash
-# Using the build script
+# Quick build
./build.sh
-# Or manually
+# Manual control
docker build -t sexy.pivoine.art:latest .
-# Multi-platform
+# Multi-platform pleasure
docker buildx build --platform linux/amd64,linux/arm64 -t sexy.pivoine.art:latest .
```
-## Deployment
+---
+
+## ๐ Deployment โ Share Your Creation
### Production with Docker
```bash
-# Using docker-compose
+# Configure your secrets
cp .env.production.example .env.production
-# Edit .env.production with your values
+# Edit .env.production with your intimate details
+
+# Deploy with grace
docker-compose -f docker-compose.production.yml up -d
```
### Production without Docker
```bash
-# Build all packages
+# Build everything
pnpm build:frontend
-# Start the server
+# Start serving
pnpm --filter @sexy.pivoine.art/frontend start
```
-## Features
+---
-- ๐จ Modern SvelteKit frontend with Tailwind CSS 4
-- ๐๏ธ Headless CMS powered by Directus
-- ๐ฎ Hardware integration via Buttplug.io
-- ๐ Multi-platform support (AMD64/ARM64)
-- ๐ Session-based authentication
-- ๐ฑ Responsive design with bits-ui components
-- ๐ Internationalization support (i18n)
-- ๐ Built-in analytics integration (Umami)
-- ๐ง Newsletter integration (Letterspace)
+## ๐ Environment Variables
-## Technology Stack
+### ๐ Required (The Essentials)
-### Frontend
-- **Framework:** SvelteKit 2
-- **Styling:** Tailwind CSS 4
-- **UI Components:** bits-ui, custom component library
-- **Build Tool:** Vite
-- **Deployment:** Node.js adapter
+- `PUBLIC_API_URL` โ Your Directus backend
+- `PUBLIC_URL` โ Your frontend domain
-### Backend
-- **CMS:** Directus (headless)
-- **Extensions:** Custom endpoints, hooks, and themes
-- **Database:** PostgreSQL (via Directus)
+### ๐ Optional (The Extras)
-### Hardware
-- **Library:** Buttplug.io
-- **Languages:** TypeScript + Rust (compiled to WASM)
-- **Protocols:** WebBluetooth API
+- `PUBLIC_UMAMI_ID` โ Analytics tracking
+- `LETTERSPACE_API_URL` โ Newsletter endpoint
+- `LETTERSPACE_API_KEY` โ Newsletter key
+- `LETTERSPACE_LIST_ID` โ Mailing list
-### DevOps
-- **Containerization:** Docker + Docker Compose
-- **CI/CD:** GitHub Actions
-- **Registry:** GitHub Container Registry (GHCR)
-- **Security:** Trivy vulnerability scanning
+See [.env.production.example](.env.production.example) for the full configuration.
-## Environment Variables
+---
-### Required
+## ๐ญ Development Workflow
-- `PUBLIC_API_URL` - Directus API endpoint
-- `PUBLIC_URL` - Frontend application URL
+```mermaid
+graph LR
+ A[๐ก Idea] --> B[๐ป Code]
+ B --> C[๐งช Test Locally]
+ C --> D[๐ฟ Feature Branch]
+ D --> E[๐ค Push & PR]
+ E --> F{โ
CI Pass?}
+ F -->|Yes| G[๐ Merge to Main]
+ F -->|No| B
+ G --> H[๐ Auto Deploy]
+ H --> I[๐ท๏ธ Tag Release]
+ I --> J[๐ Celebrate]
+```
-### Optional
+1. Create โ `git checkout -b feature/my-sexy-feature`
+2. Develop โ Write beautiful code
+3. Test โ `pnpm dev`
+4. Push โ Create PR (triggers CI build)
+5. Merge โ Automatic deployment to production
+6. Release โ `git tag v1.0.0 && git push origin v1.0.0`
-- `PUBLIC_UMAMI_ID` - Umami analytics tracking ID
-- `LETTERSPACE_API_URL` - Newsletter API endpoint
-- `LETTERSPACE_API_KEY` - Newsletter API key
-- `LETTERSPACE_LIST_ID` - Mailing list identifier
+---
-See [.env.production.example](.env.production.example) for full reference.
+## ๐ Security โ Protected Pleasure
-## Development Workflow
+- ๐ก๏ธ Daily vulnerability scans with Trivy
+- ๐ Non-root Docker containers
+- ๐ Security reports in GitHub Security tab
+- ๐ค Confidential issue reporting available
-1. Make changes to code
-2. Test locally with `pnpm dev`
-3. Create a feature branch
-4. Push and create PR (triggers CI build)
-5. Merge to `main` (triggers production build)
-6. Tag release: `git tag v1.0.0 && git push origin v1.0.0`
+*Report security concerns privately via GitHub Security.*
-## CI/CD Pipeline
+---
-Automated workflows handle:
+## ๐ Contributing โ Join the Movement
+
+Like Beate Uhse fought for sexual liberation, we welcome contributors who believe in freedom, pleasure, and quality code.
+
+1. **Fork** this repository
+2. **Create** your feature branch
+3. **Commit** your changes
+4. **Push** to your branch
+5. **Submit** a pull request
+
+All contributors are bound by our code of conduct: **Respect, Consent, and Quality.**
+
+---
+
+## ๐ฏ CI/CD Pipeline โ Automated Seduction
+
+Our GitHub Actions workflows handle:
- โ
Multi-platform Docker builds (AMD64 + ARM64)
- โ
Automated publishing to GHCR
@@ -176,38 +280,82 @@ Automated workflows handle:
- โ
Weekly cleanup of old images
- โ
Semantic versioning from git tags
-Images are available at: `ghcr.io/valknarxxx/sexy`
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Ensure tests pass (when implemented)
-5. Submit a pull request
-
-## Security
-
-- Docker images are scanned daily for vulnerabilities
-- Security reports available in GitHub Security tab
-- Report security issues privately via GitHub Security
-
-## License
-
-See [LICENSE](LICENSE) file for details.
-
-## Support
-
-- **Issues:** [GitHub Issues](https://github.com/valknarxxx/sexy/issues)
-- **Discussions:** [GitHub Discussions](https://github.com/valknarxxx/sexy/discussions)
-
-## Acknowledgments
-
-- Built with [SvelteKit](https://kit.svelte.dev/)
-- Powered by [Directus](https://directus.io/)
-- Hardware control via [Buttplug.io](https://buttplug.io/)
-- UI components from [bits-ui](https://www.bits-ui.com/)
+**Images available at:** `ghcr.io/valknarxxx/sexy`
---
-**Note:** This is an adult content platform. Users must be 18+ or the age of majority in their jurisdiction.
+## ๐ Credits & Acknowledgments
+
+
+
+### ๐ธ Created with Love by ๐ธ
+
+**[Palina](http://sexy.pivoine.art) & [Valknar](http://sexy.pivoine.art)**
+
+*Fรผr die Mรคuse...* ๐ญ๐
+
+---
+
+### ๐ Built With
+
+| Technology | Purpose |
+|------------|---------|
+| [SvelteKit](https://kit.svelte.dev/) | Framework |
+| [Directus](https://directus.io/) | CMS |
+| [Buttplug.io](https://buttplug.io/) | Hardware |
+| [bits-ui](https://www.bits-ui.com/) | Components |
+
+---
+
+### ๐ Inspired by Beate Uhse
+
+Pioneer of sexual liberation (1919-2001)
+Pilot, Entrepreneur, Freedom Fighter
+
+*"Eine Frau, die ihre Sexualitรคt selbstbestimmt lebt, ist eine freie Frau."*
+
+
+
+
+
+---
+
+## โ๏ธ License & Legal
+
+- ๐ See [LICENSE](LICENSE) file for details
+- ๐ **18+ Only** โ This platform is for adults
+- ๐ Users must be of legal age in their jurisdiction
+- โ๏ธ We support equality, freedom, and consensual pleasure
+
+---
+
+## ๐ฌ Support & Community
+
+
+
+[](https://github.com/valknarxxx/sexy.pivoine.art/issues)
+[](https://github.com/valknarxxx/sexy.pivoine.art/discussions)
+[](http://sexy.pivoine.art)
+
+
+
+---
+
+
+
+### ๐ Made with ๐ for Freedom, Pleasure & Technology ๐
+
+```
+ โโโโโโโ โโโโโโโโโโโ โโโโโโ โโโ
+โโโโโโโโ โโโโโโโโโโโโโโโโโโโโ โโโโ
+โโโโโโโ โโโโโโ โโโโโโ โโโโโโโ
+ โโโโโโโ โโโโโโ โโโโโโ โโโโโ
+โโโโโโโโ โโโโโโโโโโโโโโโโ โโโ
+โโโโโโโ โโโโโโโโโโโ โโโ โโโ
+```
+
+*Pleasure is a human right. Technology is freedom. Together, they are power.*
+
+**[sexy.pivoine.art](http://sexy.pivoine.art)** | ยฉ 2025 Palina & Valknar
+
+