diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 1d3f2706f..c08fd13bb 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -62,14 +62,14 @@ theme:
   logo: assets/img/swarms-logo.png
   palette:
     - scheme: default
-      primary: black      # Black background for default theme
-      accent: red         # Red for interactive elements
+      primary: white      # White background
+      accent: black       # Black accents for interactive elements
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
-    - scheme: slate       # Dark mode alternative with slightly lighter tones
-      primary: black
-      accent: red
+    - scheme: slate       # Optional: lighter shades for accessibility
+      primary: white
+      accent: black
       toggle:
         icon: material/brightness-4
         name: Switch to light mode
@@ -82,8 +82,8 @@ theme:
     - navigation.top
     - announce.dismiss
   font:
-    text: "Fira Sans"      # Use Fira Sans for clean readability
-    code: "Fira Code"      # Use Fira Code for code snippets
+    text: "Fira Sans"      # Clean and readable text
+    code: "Fira Code"      # Modern look for code snippets
 
 
 # Extensions