diff --git a/README.md b/README.md
deleted file mode 100644
index 3a88af411..000000000
--- a/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# THIS PROJECT IS STILL UNSTABLE AND WE DO NOT PROVIDE ANY SUPPORT FOR ISSUES THAT OCCURE.
-
-## PLEASE DO NOT OPEN ANY ISSUES OR DISCUSSIONS
-
-### EVERYTHING IS SUBJECT TO CHANGE
-
-Please use [this](https://github.com/ajnart/homarr) version of Homarr when you want to use it
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 000000000..658c070ed
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,130 @@
+
+
+
+
+
+
+
+ 
+
+
+ 
+
+
+
+
+
+ 
+
+
+
+
+
+
+ Demo ✨
+
+ •
+
+ Install 💻
+ •
+
+ Translations 🈺
+ •
+
+ Discord 👋
+
+
+
+> [!WARNING]
+> This is a beta version of Homarr. You can download the old but stable version at https://github.com/ajnart/homarr/. Running this version is at your own risk.
+
+Simplify the management of your server with Homarr - a sleek, modern dashboard that puts all of your apps and services at your fingertips. With Homarr, you can access and control everything in one location. Homarr seamlessly integrates with the apps you've added, providing you with valuable information and giving you complete control. Installation is a breeze, and Homarr supports a wide range of deployment methods.
+
+
+
+
+
+
+- 🖌️ Highly customizable with an extensive drag and drop grid system
+- ✨ Integrates seamlessly with your favorite self-hosted applications
+- 📌 Easy and fast app management - no YAML involved
+- 👤 Detailed and easy to use user management with permissions and groups
+- 👥 Support for single sign on via OIDC / LDAP
+- 🙊 Safe encryption using BCrypt and AES-256-CBC for your valuable data
+- 🕔 Realtime widget updates using WebSockets, tRPC and Redis
+- 🔍 Search through thousands of data points in supported integrations or your data in Homarr using the fast built-in search
+- 🦞 Icon picker with over 11K icons
+- 🚀 Compatible with any major consumer hardware (x86, Raspberry Pi, old laptops, ...) and most OS (Windows, Linux, TrueNAS, Unraid)
+- 🖥️ Extensive Kubernetes support with Helm for efficient scaling & high reliability
+
+
+
+
+
+
+Homarr has a [built-in collection of widgets and integrations](https://homarr.dev/docs/category/integrations), that connect to your applications and enable you to control them directly from the dashboard.
+
+- 📥 **Torrent clients**
+ - [Deluge](https://homarr.dev/docs/integrations/torrent#deluge)
+ - [Transmission](https://homarr.dev/docs/integrations/torrent#transmission)
+ - [qBittorent](https://homarr.dev/docs/integrations/torrent#qbittorrent-integration)
+- 📥 **Usenet clients**
+ - [SABnzbd](https://homarr.dev/docs/integrations/usenet#sabnzbd)
+ - [NZBGet](https://homarr.dev/docs/integrations/usenet#nzbget)
+- 📺 **Media servers**
+ - [Plex](https://homarr.dev/docs/integrations/media-server/#plex)
+ - [Jellyfin](https://homarr.dev/docs/integrations/media-server#jellyfin-and-emby)
+- 📚 **Media collection managers**
+ - [Sonarr](https://homarr.dev/docs/integrations/servarr#sonarr)
+ - [Radarr](https://homarr.dev/docs/integrations/servarr#radarr)
+ - [Lidarr](https://homarr.dev/docs/integrations/servarr#lidarr)
+ - [Readarr](https://homarr.dev/docs/integrations/servarr#readarr)
+- 🎞️ **Media request managers**
+ - [Overseerr](https://homarr.dev/docs/integrations/media-requester)
+ - [Jellyseerr](https://homarr.dev/docs/integrations/media-requester)
+- 🚫 **DNS ad-blockers**
+ - [Pihole](https://homarr.dev/docs/integrations/dns#pihole)
+ - [AdGuard Home](https://homarr.dev/docs/integrations/dns#adguard-home)
+- 🖥️ **Monitoring**
+ - [Dash.](https://homarr.dev/docs/integrations/hardware)
+ - [OpenMediaVault.](https://homarr.dev/docs/integrations/hardware/#openmediavault)
+ - [Proxmox.](https://homarr.dev/docs/integrations/hardware/#proxmox)
+- 🐳 **Container management**:
+ - [Docker](https://homarr.dev/docs/integrations/containers)
+
+
+
+
+
+
+Since we are updating Homarr very frequently, we recommend reading our official installation guides:
+
+
+
+
+
+
+
+
+
+
+Homarr is a free to use open source project that is maintained by volunteers and developers from all over the world. We publish under the ``Apache License 2.0`` license which allows commercial usage. We invest multiple hours daily in to providing support, developing Homarr, integrating to third party software and more. We also pay for licensing and server hosting fees.
+Please consider to help us cover these costs to enable the future development of Homarr. Thank you!
+
+
+
+You can also support us by helping with [translating the entire project](https://homarr.dev/docs/community/translations) to as many languages as possible or contributing directly to the code or documentation. Please read our [Contribution Guidelines](/CONTRIBUTING.md). All contributions, regardless of their size or scope, are welcome and highly appreciated! Thank you ❤️
+
+## Sponsors
+Thanks to your generous sponsors we can continue to build Homarr. Check them out for high quality and easy to use development tools.
+Feel free to contact us at homarr-labs@proton.me if you wish to become a sponsor.
+
+[](https://argos-ci.com?utm_source=%5Bhomarr%5D&utm_campaign=oss)
diff --git a/docs/banner.png b/docs/banner.png
new file mode 100644
index 000000000..823bb50b1
Binary files /dev/null and b/docs/banner.png differ
diff --git a/docs/installation-button.png b/docs/installation-button.png
new file mode 100644
index 000000000..991cb9b27
Binary files /dev/null and b/docs/installation-button.png differ
diff --git a/docs/section-contribute.png b/docs/section-contribute.png
new file mode 100644
index 000000000..3700fee95
Binary files /dev/null and b/docs/section-contribute.png differ
diff --git a/docs/section-features.png b/docs/section-features.png
new file mode 100644
index 000000000..b1854bf3a
Binary files /dev/null and b/docs/section-features.png differ
diff --git a/docs/section-installation.png b/docs/section-installation.png
new file mode 100644
index 000000000..92fa4474f
Binary files /dev/null and b/docs/section-installation.png differ
diff --git a/docs/section-preview.png b/docs/section-preview.png
new file mode 100644
index 000000000..6e43e043d
Binary files /dev/null and b/docs/section-preview.png differ
diff --git a/docs/section-widgets-and-integrations.png b/docs/section-widgets-and-integrations.png
new file mode 100644
index 000000000..67fcbc9ea
Binary files /dev/null and b/docs/section-widgets-and-integrations.png differ