chore(docs): add proper readme

README.md

@@ -0,0 +1,59 @@
+# Terraform Infrastructure Modules
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Terraform Infrastructure Modules](#terraform-infrastructure-modules)
+  - [🚀 Overview](#-overview)
+    - [🎯 Design Philosophy](#-design-philosophy)
+  - [🤝 Contributing](#-contributing)
+  - [� Notes](#-notes)
+  - [🌟 Motivation](#-motivation)
+  - [📄 License](#-license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## 🚀 Overview
+
+This repository contains a curated collection of OpenTofu/Terraform modules
+developed through years of Site Reliability Engineering (SRE) experience.
+
+These modules represent an opinionated, battle-tested approach to
+infrastructure as code (IaC) across diverse platforms and environments.
+
+### 🎯 Design Philosophy
+
+- **Pragmatic Solutions**: Modules crafted from real-world SRE challenges
+- **Best Practices Baked-In**: Incorporate industry standards and security
+  considerations
+- **Flexibility**: Adaptable to various infrastructure needs
+- **Minimal Configuration**: Sensible defaults with easy customization
+- **Sealed and Security Hardened**: Secure by default with minimal attack
+  surface, gated behind Checkov and trivy security checks on every commit
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Commit your changes
+4. Push and open a Pull Request
+
+## 📝 Notes
+
+> **Warning**: These modules are primarily developed for personal use. While
+  designed with general best practices, they may require adaptation for your
+  specific environment.
+
+## 🌟 Motivation
+
+Born from years of infrastructure management across varied technical
+landscapes, these modules represent a distillation of practical, scalable
+solutions to common infrastructure challenges.
+
+## 📄 License
+
+[Apache 2.0 License](LICENSE)
+
+---
+
+**Happy Terraforming! 🌍✨**

docs/README.md

@@ -0,0 +1,59 @@
+# Terraform Infrastructure Modules
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Terraform Infrastructure Modules](#terraform-infrastructure-modules)
+  - [🚀 Overview](#-overview)
+    - [🎯 Design Philosophy](#-design-philosophy)
+  - [🤝 Contributing](#-contributing)
+  - [� Notes](#-notes)
+  - [🌟 Motivation](#-motivation)
+  - [📄 License](#-license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## 🚀 Overview
+
+This repository contains a curated collection of OpenTofu/Terraform modules
+developed through years of Site Reliability Engineering (SRE) experience.
+
+These modules represent an opinionated, battle-tested approach to
+infrastructure as code (IaC) across diverse platforms and environments.
+
+### 🎯 Design Philosophy
+
+- **Pragmatic Solutions**: Modules crafted from real-world SRE challenges
+- **Best Practices Baked-In**: Incorporate industry standards and security
+  considerations
+- **Flexibility**: Adaptable to various infrastructure needs
+- **Minimal Configuration**: Sensible defaults with easy customization
+- **Sealed and Security Hardened**: Secure by default with minimal attack
+  surface, gated behind Checkov and trivy security checks on every commit
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Commit your changes
+4. Push and open a Pull Request
+
+## 📝 Notes
+
+> **Warning**: These modules are primarily developed for personal use. While
+  designed with general best practices, they may require adaptation for your
+  specific environment.
+
+## 🌟 Motivation
+
+Born from years of infrastructure management across varied technical
+landscapes, these modules represent a distillation of practical, scalable
+solutions to common infrastructure challenges.
+
+## 📄 License
+
+[Apache 2.0 License](LICENSE)
+
+---
+
+**Happy Terraforming! 🌍✨**

mkdocs.yml

@@ -114,11 +114,15 @@ theme:
         name: Switch to light mode
     - media: "(prefers-color-scheme: light)"
       scheme: default
+      primary: deep purple
+      accent: red
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
+      primary: deep purple
+      accent: deep orange
       toggle:
         icon: material/brightness-4
         name: Switch to system preference

scripts/build-docs.sh

@@ -14,7 +14,7 @@ for module in $modules; do
 done
 
 find docs -type f -name '*.md' | while read -r doc; do
-  if [[ "$doc" == "docs/index.md" ]]; then
+  if [[ "$doc" == "docs/README.md" ]]; then
     continue
   fi