diff --git a/README.md b/README.md
index 9621c6e..00c10ac 100644
--- a/README.md
+++ b/README.md
@@ -1,146 +1,222 @@
-# 🌌 COSMOS
-
-### *Turn your old PC into a personal cloud workstation.*
-
-[](https://golang.org)
-[](https://min.io)
-[](https://www.scylladb.com)
-[](https://gitea.com)
-[](LICENSE)
+
+
-**COSMOS** is a self-hosted cloud workstation operating system that transforms any spare PC, repurposed office desktop, or home server into an enterprise-grade personal cloud. It combines S3-compatible object storage, private Git repositories, edge CDN caching, and real-time 3D observability under a unified single-sign-on (SSO) experience.
+
+[](https://golang.org)
+[](https://min.io)
+[](https://www.scylladb.com)
+[](https://gitea.com)
+[](LICENSE)
-[Architecture](docs/ARCHITECTURE.md) • [Deployment Guide](docs/SETUP_GUIDE.md) • [Schema](deploy/schema.cql) • [Report Issue](https://github.com/vaishnosingh/COSMOS/issues)
+
+
+**[⚡ Architecture](docs/ARCHITECTURE.md)** •
+**[🛠️ Setup Guide](docs/SETUP_GUIDE.md)** •
+**[📜 CQL Schema](deploy/schema.cql)** •
+**[🐳 Docker Stack](deploy/docker-compose.yml)** •
+**[💬 Report Issue](https://github.com/vaishnosingh/COSMOS/issues)**
+
+
+
+> 🌌 *"Self-hosted infrastructure that answers to you alone. Private code, infinite storage, zero compromises."*
---
-## ⚡ Highlights & Capabilities
+## 🛰️ Overview
-### 🌌 Unified Workstation SSO
-* Single credentials grant seamless access across all workstation tools.
-* Account registration with automated OTP email verification and secure self-service password recovery.
-* Zero plain-text credentials stored in database storage; bcrypt-salted authentication throughout.
+**COSMOS** is a space-themed, self-hosted cloud workstation operating environment engineered to transform old laptops, decommissioned office desktop towers, or home lab computers into high-performance developer workstations.
-### 🗄️ Oort Cloud Storage (S3 Engine)
-* **S3 Compatible:** Direct API compatibility with AWS CLI, SDKs, Cyberduck, and rclone.
-* **Automated Multi-Tenancy:** Each registered user automatically gets their own isolated bucket, credentials, and custom AWS IAM access policy.
-* **Full Console UI:** Browse, upload, download, generate presigned URLs, inspect versions, and manage access policies directly in the browser.
-* **Custom Vanity Domains:** Map arbitrary external domains (CNAME) directly to specific buckets.
-
-### 🧑💻 Source Forge (Self-Hosted Git)
-* Powered by lightweight Gitea engine.
-* Instant repository creation, pull requests, issue tracking, and SSH/HTTPS Git clones.
-* Automated credential synchronization with the Cosmos master identity directory.
-
-### ⚡ Edge CDN & In-Memory Caching
-* High-speed in-memory cache layer (`sync.Map`) for frequently accessed objects.
-* Standard HTTP caching semantics: conditional ETags (`If-None-Match`), `304 Not Modified` responses, and cache-purge queries.
-
-### 📊 Real-time 3D Telemetry Dashboard
-* Live operational metrics for request volume, cache hit ratios, bandwidth consumption, and error rates.
-* Interactive 3D rotating orthographic globe rendered on HTML5 Canvas visualizing global network activity.
-* Granular hourly time-series stored in ScyllaDB for historical analytics.
+Instead of paying recurring cloud fees for AWS S3, GitHub private repos, or Cloudflare edge caching, **COSMOS runs the entire workstation directly on your local hardware** with unified Single Sign-On (SSO), automated IAM multi-tenancy, and real-time 3D planetary observability.
---
-## 🏗️ System Architecture
+## ⚡ Core Capabilities
-```
- ┌───────────────────────────┐
- │ Browser / Developer │
- └─────────────┬─────────────┘
- │ HTTPS (:443)
- ▼
- ┌───────────────────────────┐
- │ Nginx Reverse Proxy │
- └──────┬────────────┬───────┘
- │ │
- Portals │ │ Git Forge
- (:8080) │ │ (:3000)
- ▼ ▼
- ┌──────────────┐ ┌──────────┐
- │ Cosmos Core │ │ Gitea │
- │ (Golang) │ │ Engine │
- └───────┬──────┘ └──────────┘
- │
- ┌─────────────┴─────────────┐
- │ │
- ▼ ▼
- ┌──────────────┐ ┌──────────────┐
- │ ScyllaDB │ │ MinIO S3 │
- │ (CQL Store) │ │(Object Store)│
- └──────────────┘ └──────────────┘
-```
+