diff --git a/docs/.partials/index-header.html b/docs/.partials/index-header.html
index 04450a1..3e9e9d1 100644
--- a/docs/.partials/index-header.html
+++ b/docs/.partials/index-header.html
@@ -5,21 +5,18 @@
   -->
 
 <div class="text-center">
-    <img class="index-header off-glb" src="./img/pydantic-ai-dark.svg#only-dark" alt="PydanticAI">
+    <img class="index-header off-glb" src="./img/banner-dark.png#only-dark" alt="PydanticAI">
 </div>
 <div class="text-center">
-    <img class="index-header off-glb" src="./img/pydantic-ai-light.svg#only-light" alt="PydanticAI">
+    <img class="index-header off-glb" src="./img/banner-light.png#only-light" alt="PydanticAI">
 </div>
 <p class="text-center">
-    <em>Agent Framework / shim to use Pydantic with LLMs</em>
+    <em>Empowering Collaboration, Simplifying Complexity</em>
 </p>
 <p class="text-center">
     <a href="https://github.com/ceylonai/ceylon/actions/workflows/ci.yml?query=branch%3Amain">
         <img src="https://github.com/ceylonai/ceylon/actions/workflows/ci.yml/badge.svg?event=push" alt="CI">
     </a>
-    <a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/ceylonai/ceylon">
-        <img src="https://coverage-badge.samuelcolvin.workers.dev/ceylonai/ceylon.svg" alt="Coverage">
-    </a>
     <a href="https://pypi.python.org/pypi/ceylon">
         <img src="https://img.shields.io/pypi/v/ceylon.svg" alt="PyPI">
     </a>
@@ -32,6 +29,5 @@
 </p>
 
 <p class="text-emphasis">
-    PydanticAI is a Python agent framework designed to make it less painful to
-    build production grade applications with Generative AI.
+    Ceylon orchestrates AI agents to automate complex tasks through collaborative problem-solving.
 </p>
\ No newline at end of file
diff --git a/docs/extra/tweaks.css b/docs/extra/tweaks.css
new file mode 100644
index 0000000..29fa086
--- /dev/null
+++ b/docs/extra/tweaks.css
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2024-Present, Syigen Ltd. and Syigen Private Limited. All rights reserved.
+ * Licensed under the Apache License, Version 2.0 (See LICENSE.md or http://www.apache.org/licenses/LICENSE-2.0).
+ *
+ */
+
+/* Revert hue value to that of pre mkdocs-material v9.4.0 */
+[data-md-color-scheme="slate"] {
+    --md-hue: 230;
+    --md-default-bg-color: hsla(230, 15%, 21%, 1);
+}
+
+.hide {
+    display: none;
+}
+
+.text-center {
+    text-align: center;
+}
+
+img.index-header {
+    width: 70%;
+    max-width: 500px;
+}
+
+.pydantic-pink {
+    color: #FF007F;
+}
+
+.team-blue {
+    color: #0072CE;
+}
+
+.secure-green {
+    color: #00A86B;
+}
+
+.shapes-orange {
+    color: #FF7F32;
+}
+
+.puzzle-purple {
+    color: #652D90;
+}
+
+.wheel-gray {
+    color: #6E6E6E;
+}
+
+.vertical-middle {
+    vertical-align: middle;
+}
+
+.text-emphasis {
+    font-size: 1rem;
+    font-weight: 300;
+    font-style: italic;
+}
+
+#version-warning {
+    min-height: 120px;
+    margin-bottom: 10px;
+}
+
+.mermaid {
+    text-align: center;
+}
\ No newline at end of file
diff --git a/docs/img/banner-dark.png b/docs/img/banner-dark.png
new file mode 100644
index 0000000..7d26b03
Binary files /dev/null and b/docs/img/banner-dark.png differ
diff --git a/docs/img/banner-light.png b/docs/img/banner-light.png
new file mode 100644
index 0000000..2dc9d7e
Binary files /dev/null and b/docs/img/banner-light.png differ
diff --git a/docs/index.md b/docs/index.md
index 8abf0c5..47e4f2f 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,8 +1,9 @@
-# Introduction
+# Introduction {.hide}
 
-> Empowering Collaboration, Simplifying Complexity
+--8<-- "docs/.partials/index-header.html"
 
-![PyPI - Version](https://img.shields.io/pypi/v/ceylon.svg) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ceylon.svg) ![PyPI Downloads](https://img.shields.io/pypi/dm/ceylon)
+
+[//]: # (![PyPI - Version]&#40;https://img.shields.io/pypi/v/ceylon.svg&#41; ![PyPI - Python Version]&#40;https://img.shields.io/pypi/pyversions/ceylon.svg&#41; ![PyPI Downloads]&#40;https://img.shields.io/pypi/dm/ceylon&#41;)
 
 ## Introduction
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 11e8f36..6d7e47a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -53,8 +53,31 @@ theme:
   locale: en
   highlightjs: true
 
+extra_css:
+  - "extra/tweaks.css"
+
+
 use_directory_urls: false
 
 plugins:
   - search
-  - tags
\ No newline at end of file
+  - tags
+
+markdown_extensions:
+  - tables
+  - admonition
+  - attr_list
+  - md_in_html
+  - pymdownx.details
+  - pymdownx.caret
+  - pymdownx.critic
+  - pymdownx.mark
+  - pymdownx.superfences
+  - pymdownx.snippets
+  - pymdownx.tilde
+  - pymdownx.inlinehilite
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - sane_lists # this means you can start a list from any number
\ No newline at end of file