diff --git a/README.md b/README.md
index 39bce0e..01948ab 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,77 @@
 
 
 
+## 📚 Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Documentation Index](docs/README.md) | Start here! |
+| [Architecture Overview](docs/architecture/README.md) | Deep dive into the kernel |
+| [Building and Running](docs/build/usage.md) | Set up your build environment |
+| [AppDev SDK](docs/appdev/custom_apps.md) | Build your own apps for BoredOS |
+
+---
+
+## Contributors
+
+<div align="center">
+  <img src="branding/bOS_full_gradient_cropped.png" alt="BoredOS Logo" width="450" />
+
+  <h3>A modern x86_64 hobbyist operating system built from the ground up.</h3>
+
+  [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+  ![Platform: x86_64](https://img.shields.io/badge/Platform-x86_64-lightgrey)
+  ![Status: Active](https://img.shields.io/badge/Status-Active-brightgreen)
+  ![GitHub all releases](https://img.shields.io/github/downloads/boreddevnl/BoredOS/total?color=brightgreen)
+
+  <br />
+
+  [Docs](docs/README.md) · [Build & Run](docs/build/usage.md) · [AppDev SDK](docs/appdev/sdk_reference.md) · [Discord](https://discord.gg/J2BxWaFAgY) · [Support](https://buymeacoffee.com/boreddevhq)
+
+</div>
+
+---
+
+![Screenshot](branding/screenshot.jpg)
+
+> [!NOTE]
+> The screenshot above may represent a previous build and is subject to change as the UI evolves.
+
+---
+
+## Features
+
+### Kernel and Architecture
+- **Long Mode Architecture** — Native x86_64 implementation utilizing 64-bit address space and registers
+- **Symmetric Multi-Processing** — Scalable multi-core support with IPI-based scheduling and synchronization
+- **Advanced Memory Management** — Custom slab allocator with object pooling and efficient physical/virtual page mapping
+- **Hybrid VFS Layer** — Unified filesystem interface supporting FAT32, TAR, ProcFS, and SysFS
+- **Preemptive Multitasking** — Prioritized process scheduling with full context isolation
+- **Hardware Abstraction** — Comprehensive driver support for PCI, AHCI, PS/2, and ACPI
+
+### Graphical Desktop Environment
+- **BoredWM** — High-performance window manager featuring window stacking, focus management, and drag-and-drop interactions
+- **Typography Engine** — Integrated font manager with TrueType (TTF) support and efficient glyph caching
+- **Rich Media Subsystem** — Native hardware-independent decoding for PNG, JPEG, GIF, BMP, and TGA formats
+- **LibWidget Toolkit** — Native UI component library for rapid application development
+
+### Networking Stack
+- **TCP/IP Integration** — Full lwIP-based network stack featuring DHCP, DNS, and Berkeley-style sockets
+- **Network Services** — Integrated support for basic web browsing and real-time network telemetry
+
+### Application Ecosystem
+| Category | Applications |
+|----------|--------------|
+| Productivity | Text Editor, Markdown Viewer, BoredWord Processor, Web Browser, Calculator |
+| Development | TCC (Tiny C Compiler), Lua|
+| System | Explorer (File Manager), Task Manager, System Monitor, Graphing Utility |
+| Games | doomgeneric, Minesweeper, 2048, Snake |
+
+
+---
+
+
+
 ## 📚 Documentation
 
 | Guide | Description |
@@ -99,6 +170,8 @@
     </a><br />
     Artwork
   </td>
+</tr>
+<tr>
   <td align="center">
     <a href="https://github.com/zeyadhost">
       <img src="https://github.com/zeyadhost.png?size=80" width="60" /><br />
@@ -113,6 +186,20 @@
     </a><br />
     Artwork
   </td>
+  <td align="center">
+    <a href="https://github.com/pixelyblah">
+      <img src="https://github.com/pixelyblah.png?size=80" width="60" /><br />
+      <sub><b>pixelyblah</b></sub>
+    </a><br />
+    Artwork
+  </td>
+  <td align="center">
+    <a href="https://github.com/qwroffc">
+      <img src="https://github.com/qwroffc.png?size=80" width="60" /><br />
+      <sub><b>qwroffc</b></sub>
+    </a><br />
+    Artwork
+  </td>  
 </tr>
 </table>
 
@@ -147,3 +234,35 @@ Distributed under the **GNU General Public License v3**. See [`LICENSE`](LICENSE
 
 > [!IMPORTANT]
 > You must retain all copyright headers and include the original attribution in any redistributions or derivative works. See the [`NOTICE`](NOTICE) file for more details.
+
+---
+
+## ☕ Support the Journey
+
+If you find BoredOS interesting or useful, consider fueling development with a coffee!
+
+<a href="https://buymeacoffee.com/boreddevhq" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50" style="border-radius: 8px;" />
+</a>
+
+---
+
+## History
+
+**BoredOS** is the successor to **[BrewKernel](https://github.com/boreddevnl/brewkernel)**, a project started in 2023. BrewKernel served as the foundational learning ground but has since been officially deprecated and archived — it no longer receives updates, bug fixes, or pull request reviews.
+
+BoredOS is a complete architectural reboot, applying years of lessons learned to build a cleaner, more modular, and more capable system.
+
+> [!IMPORTANT]
+> Please direct all issues, discussions, and contributions to this repository. Legacy BrewKernel code is preserved for historical purposes only and is not compatible with BoredOS.
+
+---
+
+## License
+
+**Copyright (C) 2023–2026 boreddevnl**
+
+Distributed under the **GNU General Public License v3**. See [`LICENSE`](LICENSE) for details.
+
+> [!IMPORTANT]
+> You must retain all copyright headers and include the original attribution in any redistributions or derivative works. See the [`NOTICE`](NOTICE) file for more details.