diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 461bd30..1dcec2d 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -4,5 +4,8 @@ import tailwind from "@astrojs/tailwind";
 
 // https://astro.build/config
 export default defineConfig({
+  experimental: {
+    viewTransitions: true
+  },
   integrations: [tailwind()]
 });
\ No newline at end of file
diff --git a/docs/package-lock.json b/docs/package-lock.json
index 746438e..692ed6f 100644
--- a/docs/package-lock.json
+++ b/docs/package-lock.json
@@ -10,7 +10,7 @@
       "dependencies": {
         "@astrojs/tailwind": "^4.0.0",
         "@tailwindcss/typography": "^0.5.9",
-        "astro": "^2.9.1",
+        "astro": "^2.10.7",
         "tailwindcss": "^3.3.3"
       },
       "devDependencies": {
@@ -53,14 +53,14 @@
       }
     },
     "node_modules/@astrojs/compiler": {
-      "version": "1.6.1",
-      "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-1.6.1.tgz",
-      "integrity": "sha512-QZZhV2kOhvyXEfpaGLgHWNPUOlkMVx3Zw+5IlXXU2p448NwtyYt3C6MuS7baVsTlluH3EedAoDBmelt9hPhfiQ=="
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-1.8.1.tgz",
+      "integrity": "sha512-C28qplQzgIJ+JU9S+1wNx+ue2KCBUp0TTAd10EWAEkk4RsL3Tzlw0BYvLDDb4KP9jS48lXmR4/1TtZ4aavYJ8Q=="
     },
     "node_modules/@astrojs/internal-helpers": {
-      "version": "0.1.1",
-      "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.1.1.tgz",
-      "integrity": "sha512-+LySbvFbjv2nO2m/e78suleQOGEru4Cnx73VsZbrQgB2u7A4ddsQg3P2T0zC0e10jgcT+c6nNlKeLpa6nRhQIg=="
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.1.2.tgz",
+      "integrity": "sha512-YXLk1CUDdC9P5bjFZcGjz+cE/ZDceXObDTXn/GCID4r8LjThuexxi+dlJqukmUpkSItzQqgzfWnrPLxSFPejdA=="
     },
     "node_modules/@astrojs/language-server": {
       "version": "1.0.8",
@@ -2210,12 +2210,12 @@
       }
     },
     "node_modules/astro": {
-      "version": "2.9.1",
-      "resolved": "https://registry.npmjs.org/astro/-/astro-2.9.1.tgz",
-      "integrity": "sha512-cY+ilz7zbKx21QA4LRJtE49NakkhUVh6kU9LqNMThz/Fqv1Rkz0uJBWIUJfJqpOmqnpFEW2G245gF4+bUA7aRQ==",
+      "version": "2.10.7",
+      "resolved": "https://registry.npmjs.org/astro/-/astro-2.10.7.tgz",
+      "integrity": "sha512-R8aF4yphrsbhxW2UxHZ1DslBn8e8vPQ23+Z/OnajNE1Q4HEZCOZ4CAbHJx2PDwq2p+CRWArNalpr3+rTqyOYBQ==",
       "dependencies": {
-        "@astrojs/compiler": "^1.6.0",
-        "@astrojs/internal-helpers": "^0.1.1",
+        "@astrojs/compiler": "^1.8.0",
+        "@astrojs/internal-helpers": "^0.1.2",
         "@astrojs/language-server": "^1.0.0",
         "@astrojs/markdown-remark": "^2.2.1",
         "@astrojs/telemetry": "^2.1.1",
@@ -2249,7 +2249,7 @@
         "html-escaper": "^3.0.3",
         "js-yaml": "^4.1.0",
         "kleur": "^4.1.4",
-        "magic-string": "^0.27.0",
+        "magic-string": "^0.30.2",
         "mime": "^3.0.0",
         "network-information-types": "^0.1.1",
         "ora": "^6.3.1",
@@ -2267,7 +2267,7 @@
         "typescript": "*",
         "unist-util-visit": "^4.1.2",
         "vfile": "^5.3.7",
-        "vite": "^4.3.9",
+        "vite": "^4.4.6",
         "vitefu": "^0.2.4",
         "which-pm": "^2.0.0",
         "yargs-parser": "^21.1.1",
@@ -7770,11 +7770,11 @@
       }
     },
     "node_modules/magic-string": {
-      "version": "0.27.0",
-      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.27.0.tgz",
-      "integrity": "sha512-8UnnX2PeRAPZuN12svgR9j7M1uWMovg/CEnIwIG0LFkXSJJe4PdfUGiTGl8V9bsBHFUtfVINcSyYxd7q+kx9fA==",
+      "version": "0.30.2",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.2.tgz",
+      "integrity": "sha512-lNZdu7pewtq/ZvWUp9Wpf/x7WzMTsR26TWV03BRZrXFsv+BI6dy8RAiKgm1uM/kyR0rCfUcqvOlXKG66KhIGug==",
       "dependencies": {
-        "@jridgewell/sourcemap-codec": "^1.4.13"
+        "@jridgewell/sourcemap-codec": "^1.4.15"
       },
       "engines": {
         "node": ">=12"
diff --git a/docs/package.json b/docs/package.json
index a14edcd..68b2694 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -13,7 +13,7 @@
   "dependencies": {
     "@astrojs/tailwind": "^4.0.0",
     "@tailwindcss/typography": "^0.5.9",
-    "astro": "^2.9.1",
+    "astro": "^2.10.7",
     "tailwindcss": "^3.3.3"
   },
   "devDependencies": {
diff --git a/docs/src/components/Footer.astro b/docs/src/components/Footer.astro
index 215c0c1..bbe7216 100644
--- a/docs/src/components/Footer.astro
+++ b/docs/src/components/Footer.astro
@@ -1,12 +1,11 @@
-<footer
-  class="h-36 pt-12 flex flex-col items-center justify-center"
->
+<footer 
+  transition:persist
+  class="h-36 pt-12 flex flex-col items-center justify-center">
   <a
     class="mx-2 text-sm underline"
     href="https://github.com/codediodeio/sveltefire">Source Code</a
   >
-  <!-- Place this tag where you want the button to render. -->
-  <!-- Place this tag where you want the button to render. -->
+
   <a
     class="github-button"
     href="https://github.com/codediodeio/sveltefire"
diff --git a/docs/src/components/SideNav.astro b/docs/src/components/SideNav.astro
index d50eec7..b2cc0e9 100644
--- a/docs/src/components/SideNav.astro
+++ b/docs/src/components/SideNav.astro
@@ -1,4 +1,4 @@
-<nav class="pt-12 w-1/6 min-w-[16rem] bg-gray1 dark:bg-gray7">
+<nav id="sidebar" class="pt-12 w-1/6 min-w-[16rem] bg-gray1 dark:bg-gray7 hidden lg:block">
   <ul class="pl-8 font-code mb-20">
     <li class="heading">guide</li>
     <li><a href="/">why?</a></li>
diff --git a/docs/src/components/TopNav.astro b/docs/src/components/TopNav.astro
index 5e5ff70..06a635e 100644
--- a/docs/src/components/TopNav.astro
+++ b/docs/src/components/TopNav.astro
@@ -1,60 +1,116 @@
-<nav class="flex justify-between mx-auto h-20 px-6 w-full bg-gray1 dark:bg-gray7 z-50 relative">
-    <a
-      class="grid place-items-center w-14"
-      href="/"
-    >
+<nav
+  transition:persist
+  class="flex justify-between mx-auto h-20 px-6 w-full bg-gray1 dark:bg-gray7 z-50 relative"
+>
+  <div class="flex justify-center items-center">
+    <button id="sidebarBtn" class="lg:hidden">
+      <svg
+        class="fill-gray6 dark:fill-gray2 w-8 mx-2"
+        xmlns="http://www.w3.org/2000/svg"
+        viewBox="0 0 24 24"
+        fill="currentColor"
+      >
+        <path
+          fill-rule="evenodd"
+          clip-rule="evenodd"
+          d="M4 5C3.44772 5 3 5.44772 3 6C3 6.55228 3.44772 7 4 7H20C20.5523 7 21 6.55228 21 6C21 5.44772 20.5523 5 20 5H4ZM7 12C7 11.4477 7.44772 11 8 11H20C20.5523 11 21 11.4477 21 12C21 12.5523 20.5523 13 20 13H8C7.44772 13 7 12.5523 7 12ZM13 18C13 17.4477 13.4477 17 14 17H20C20.5523 17 21 17.4477 21 18C21 18.5523 20.5523 19 20 19H14C13.4477 19 13 18.5523 13 18Z"
+        ></path>
+      </svg>
+    </button>
+    <a class="grid place-items-center w-14" href="/">
       <img id="logo" src="/logo.svg" alt="sveltefire logo" />
     </a>
-  
-    <ul class="flex justify-center items-center list-none">
+  </div>
+
+  <ul class="flex justify-center items-center list-none">
+    <li class="mx-2 md:mx-4 hidden md:block">
+      <a
+        href="/guide/start"
+        class="font-code font-bold text-gray5 dark:text-gray2">start</a
+      >
+    </li>
 
-      <li class="mx-2 md:mx-4">
-        <a href="/guide/start" class="font-code font-bold text-gray5 dark:text-gray2">start</a>
-      </li>
+    <li class="mx-4">
+      <button
+        class="p-2 mr-2 hidden md:flex justify-between items-center bg-gray3 bg-opacity-10 hover:bg-opacity-20 border border-gray4 hover:border-orange-500 transition-all"
+      >
+        <span class="text-gray4 dark:text-gray2 w-4 mx-2">
+          <svg
+            aria-hidden="true"
+            focusable="false"
+            data-prefix="fad"
+            data-icon="search"
+            role="img"
+            xmlns="http://www.w3.org/2000/svg"
+            viewBox="0 0 512 512"
+            class="svg-inline--fa fk-search fk-w-16 fk-9x"
+          >
+            <g class="fk-group"
+              ><path
+                fill="currentColor"
+                d="M208 80a128 128 0 1 1-90.51 37.49A127.15 127.15 0 0 1 208 80m0-80C93.12 0 0 93.12 0 208s93.12 208 208 208 208-93.12 208-208S322.88 0 208 0z"
+                class="fk-secondary"></path><path
+                fill="currentColor"
+                d="M504.9 476.7L476.6 505a23.9 23.9 0 0 1-33.9 0L343 405.3a24 24 0 0 1-7-17V372l36-36h16.3a24 24 0 0 1 17 7l99.7 99.7a24.11 24.11 0 0 1-.1 34z"
+                class="fk-primary"
+              >
+              </path></g
+            ></svg
+          >
+        </span>
+        <span class="mr-12 font-code">search</span>
+        <span class="mx-2 text-xs border border-gray4 rounded-md p-1 px-2"
+          >/</span
+        >
+      </button>
+      <button class="flex md:hidden">
+        <span class="text-gray2 w-6 mx-2"></span>
+      </button>
+    </li>
 
-      <li class="mx-4">
-          <button class="p-2 mr-2 hidden md:flex justify-between items-center bg-gray3 bg-opacity-10 hover:bg-opacity-20 border border-gray4 hover:border-orange-500 
-                    transition-all">
-            <span class="text-gray4 dark:text-gray2 w-4 mx-2">
-              <svg aria-hidden="true" focusable="false" data-prefix="fad" data-icon="search" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="svg-inline--fa fk-search fk-w-16 fk-9x">
-                <g class="fk-group"><path fill="currentColor" d="M208 80a128 128 0 1 1-90.51 37.49A127.15 127.15 0 0 1 208 80m0-80C93.12 0 0 93.12 0 208s93.12 208 208 208 208-93.12 208-208S322.88 0 208 0z" class="fk-secondary"></path><path fill="currentColor" d="M504.9 476.7L476.6 505a23.9 23.9 0 0 1-33.9 0L343 405.3a24 24 0 0 1-7-17V372l36-36h16.3a24 24 0 0 1 17 7l99.7 99.7a24.11 24.11 0 0 1-.1 34z" class="fk-primary">
-                </path></g></svg>
-            </span>
-            <span class="mr-12 font-code">search</span>
-            <span class="mx-2 text-xs border border-gray4 rounded-md p-1 px-2">/</span>
-          </button>
-          <button class="flex md:hidden">
-            <span class="text-gray2 w-6 mx-2"></span>
-          </button>
-        </li>
-        
+    <li
+      id="dark"
+      class="w-5 cursor-pointer fill-gray3 dark:fill-orange-500 mr-2"
+    >
+      <svg
+        xmlns="http://www.w3.org/2000/svg"
+        xml:space="preserve"
+        style="enable-background:new 0 0 312.812 312.812"
+        viewBox="0 0 312.812 312.812"
+        ><path
+          d="M305.2 178.159c-3.2-.8-6.4 0-9.2 2-10.4 8.8-22.4 16-35.6 20.8-12.4 4.8-26 7.2-40.4 7.2-32.4 0-62-13.2-83.2-34.4-21.2-21.2-34.4-50.8-34.4-83.2 0-13.6 2.4-26.8 6.4-38.8 4.4-12.8 10.8-24.4 19.2-34.4 3.6-4.4 2.8-10.8-1.6-14.4-2.8-2-6-2.8-9.2-2-34 9.2-63.6 29.6-84.8 56.8-20.4 26.8-32.4 60-32.4 96 0 43.6 17.6 83.2 46.4 112s68 46.4 112 46.4c36.8 0 70.8-12.8 98-34 27.6-21.6 47.6-52.4 56-87.6 1.6-5.6-1.6-11.2-7.2-12.4z"
+        ></path></svg>
+    </li>
+    <li id="light" class="w-5 cursor-pointer fill-orange-500 dark:fill-gray3">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"
+        ><path
+          d="M100.307 168.213a180.083 180.083 0 0 1 67.905-67.905L90.7 71.547A14.9 14.9 0 0 0 71.547 90.7zM77.22 256c0-16.617 2.287-32.71 6.549-47.986L8.687 242.457a14.9 14.9 0 0 0 0 27.086l75.083 34.443A178.326 178.326 0 0 1 77.22 256zM256 77.22a178.32 178.32 0 0 1 47.986 6.549L269.543 8.687a14.9 14.9 0 0 0-27.086 0L208.014 83.77A178.28 178.28 0 0 1 256 77.22zM411.693 168.213l28.76-77.513A14.9 14.9 0 0 0 421.3 71.547l-77.513 28.76a180.102 180.102 0 0 1 67.906 67.906zM256 434.78a178.32 178.32 0 0 1-47.986-6.549l34.443 75.083a14.9 14.9 0 0 0 27.086-.001l34.444-75.083A178.333 178.333 0 0 1 256 434.78zM100.307 343.787 71.547 421.3A14.9 14.9 0 0 0 90.7 440.453l77.513-28.76a180.102 180.102 0 0 1-67.906-67.906zM503.313 242.457l-75.083-34.444c4.262 15.277 6.549 31.369 6.549 47.986s-2.287 32.71-6.549 47.986l75.083-34.443a14.9 14.9 0 0 0 0-27.085zM411.693 343.787a180.083 180.083 0 0 1-67.905 67.905l77.513 28.76a14.897 14.897 0 0 0 15.719-3.434 14.9 14.9 0 0 0 3.434-15.719zM256 404.98c-82.148 0-148.98-66.832-148.98-148.98S173.852 107.02 256 107.02 404.98 173.852 404.98 256 338.148 404.98 256 404.98z"
+        ></path></svg>
+    </li>
+  </ul>
+</nav>
 
-        <li id="dark" class="w-5 cursor-pointer fill-gray3 dark:fill-orange-500 mr-2"><svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" style="enable-background:new 0 0 312.812 312.812" viewBox="0 0 312.812 312.812"><path d="M305.2 178.159c-3.2-.8-6.4 0-9.2 2-10.4 8.8-22.4 16-35.6 20.8-12.4 4.8-26 7.2-40.4 7.2-32.4 0-62-13.2-83.2-34.4-21.2-21.2-34.4-50.8-34.4-83.2 0-13.6 2.4-26.8 6.4-38.8 4.4-12.8 10.8-24.4 19.2-34.4 3.6-4.4 2.8-10.8-1.6-14.4-2.8-2-6-2.8-9.2-2-34 9.2-63.6 29.6-84.8 56.8-20.4 26.8-32.4 60-32.4 96 0 43.6 17.6 83.2 46.4 112s68 46.4 112 46.4c36.8 0 70.8-12.8 98-34 27.6-21.6 47.6-52.4 56-87.6 1.6-5.6-1.6-11.2-7.2-12.4z"/></svg></li>
-        <li id="light" class="w-5 cursor-pointer fill-orange-500 dark:fill-gray3"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path d="M100.307 168.213a180.083 180.083 0 0 1 67.905-67.905L90.7 71.547A14.9 14.9 0 0 0 71.547 90.7zM77.22 256c0-16.617 2.287-32.71 6.549-47.986L8.687 242.457a14.9 14.9 0 0 0 0 27.086l75.083 34.443A178.326 178.326 0 0 1 77.22 256zM256 77.22a178.32 178.32 0 0 1 47.986 6.549L269.543 8.687a14.9 14.9 0 0 0-27.086 0L208.014 83.77A178.28 178.28 0 0 1 256 77.22zM411.693 168.213l28.76-77.513A14.9 14.9 0 0 0 421.3 71.547l-77.513 28.76a180.102 180.102 0 0 1 67.906 67.906zM256 434.78a178.32 178.32 0 0 1-47.986-6.549l34.443 75.083a14.9 14.9 0 0 0 27.086-.001l34.444-75.083A178.333 178.333 0 0 1 256 434.78zM100.307 343.787 71.547 421.3A14.9 14.9 0 0 0 90.7 440.453l77.513-28.76a180.102 180.102 0 0 1-67.906-67.906zM503.313 242.457l-75.083-34.444c4.262 15.277 6.549 31.369 6.549 47.986s-2.287 32.71-6.549 47.986l75.083-34.443a14.9 14.9 0 0 0 0-27.085zM411.693 343.787a180.083 180.083 0 0 1-67.905 67.905l77.513 28.76a14.897 14.897 0 0 0 15.719-3.434 14.9 14.9 0 0 0 3.434-15.719zM256 404.98c-82.148 0-148.98-66.832-148.98-148.98S173.852 107.02 256 107.02 404.98 173.852 404.98 256 338.148 404.98 256 404.98z"/></svg></li>
-  
-    </ul>
-  </nav>
-  
 <script>
-    function light() {
-        // Whenever the user explicitly chooses light mode
-        localStorage.theme = 'light'
-        document.documentElement.classList.add('light')
-        document.documentElement.classList.remove('dark')
-    }
-    function dark() {
-        // Whenever the user explicitly chooses dark mode
-        localStorage.theme = 'dark'
-        document.documentElement.classList.add('dark')
-        document.documentElement.classList.remove('light')
-    }
-    document.getElementById("light")!.addEventListener("click", light);
-    document.getElementById("dark")!.addEventListener("click", dark);
+  function light() {
+    // Whenever the user explicitly chooses light mode
+    localStorage.theme = "light";
+    document.documentElement.classList.add("light");
+    document.documentElement.classList.remove("dark");
+  }
+  function dark() {
+    // Whenever the user explicitly chooses dark mode
+    localStorage.theme = "dark";
+    document.documentElement.classList.add("dark");
+    document.documentElement.classList.remove("light");
+  }
+  document.getElementById("light")!.addEventListener("click", light);
+  document.getElementById("dark")!.addEventListener("click", dark);
 
+  const sidebarBtn = document.getElementById("sidebarBtn");
+  sidebarBtn.onclick = function () {
+    const sidebar = document.getElementById("sidebar");
+    sidebar.classList.toggle("hidden");
+  };
 </script>
 
-
-
-<style>
-
-</style>
\ No newline at end of file
+<style></style>
diff --git a/docs/src/layouts/MainLayout.astro b/docs/src/layouts/MainLayout.astro
index 4467bcb..faaa56c 100644
--- a/docs/src/layouts/MainLayout.astro
+++ b/docs/src/layouts/MainLayout.astro
@@ -1,22 +1,9 @@
 ---
+import { ViewTransitions } from "astro:transitions";
 import SideNav from "../components/SideNav.astro";
 import TopNav from "../components/TopNav.astro";
 import Footer from "../components/Footer.astro";
 ---
-
-<script is:inline>
-  // On page load or when changing themes, best to add inline in `head` to avoid FOUC
-  if (
-    localStorage.theme === "dark" ||
-    (!("theme" in localStorage) &&
-      window.matchMedia("(prefers-color-scheme: dark)").matches)
-  ) {
-    document.documentElement.classList.add("dark");
-  } else {
-    document.documentElement.classList.remove("dark");
-  }
-</script>
-
 <html lang="en">
   <head>
     <meta charset="utf-8" />
@@ -31,12 +18,15 @@ import Footer from "../components/Footer.astro";
 
     <title>SvelteFire Documentation</title>
     <script async defer src="https://buttons.github.io/buttons.js"></script>
+    <ViewTransitions />
   </head>
   <body class="dark:bg-gray6 dark:text-white transition-colors duration-500">
     <TopNav />
-    <div class="flex items-stretch">
+    <div class="flex items-stretch overflow-x-hidden">
       <SideNav />
-      <main class="max-w-screen-2xl min-h-screen p-20 mx-auto prose dark:prose-invert w-full flex flex-col justify-between">
+      <main
+        class="max-w-screen-2xl min-h-screen p-6 lg:p-20 mx-auto prose dark:prose-invert w-full flex flex-col justify-between"
+      >
         <article>
           <slot />
         </article>
@@ -44,5 +34,22 @@ import Footer from "../components/Footer.astro";
         <Footer />
       </main>
     </div>
+
+    <script>
+      function colorMode() {
+        if (
+          localStorage.theme === "dark" ||
+          (!("theme" in localStorage) &&
+            window.matchMedia("(prefers-color-scheme: dark)").matches)
+        ) {
+          document.documentElement.classList.add("dark");
+        } else {
+          document.documentElement.classList.remove("dark");
+        }
+      }
+    
+      colorMode();
+      document.addEventListener('astro:beforeload', colorMode);
+    </script>
   </body>
 </html>
diff --git a/docs/tailwind.config.cjs b/docs/tailwind.config.cjs
index b11079e..96be3e1 100644
--- a/docs/tailwind.config.cjs
+++ b/docs/tailwind.config.cjs
@@ -42,14 +42,17 @@ module.exports = {
             h1: {
               "font-weight": "bold",
               "font-size": "2.5rem",
+              "overflow-wrap": "break-word"
             },
             h2: {
               "font-weight": "bold",
               "font-size": "2rem",
+              "overflow-wrap": "break-word"
             },
             h3: {
               "font-weight": "normal",
               "font-size": "1.5rem",
+              "overflow-wrap": "break-word"
             },
             h4: {
               "font-weight": "normal",