diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4702da1c2bc2..d94ea05c7c62 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,35 @@
-# [1.0.0-alpha.1](https://github.com/vuejs/vitepress/compare/v0.22.4...v1.0.0-alpha.1) (2022-06-01)
+## [1.0.0-alpha.2](https://github.com/vuejs/vitepress/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2022-06-14)
+
+### Bug Fixes
+
+* use h1 for title in hero instead of p ([#776](https://github.com/vuejs/vitepress/issues/776)) ([919d230](https://github.com/vuejs/vitepress/commit/919d23079b636c188ea2049039461b88e0c02fc2))
+* add background color in navbar to avoid contrast issues ([#695](https://github.com/vuejs/vitepress/issues/695)) ([305bcc0](https://github.com/vuejs/vitepress/commit/305bcc02e68f8f9aea0000e6950e78455cf572f5))
+* add default value for base in `createMarkdownRenderer` ([#555](https://github.com/vuejs/vitepress/issues/555)) ([#556](https://github.com/vuejs/vitepress/issues/556)) ([78a2e84](https://github.com/vuejs/vitepress/commit/78a2e84e7bb7acfda50e686bbd404961babb91e8))
+* allow lang='ts' on scripts in markdown ([#693](https://github.com/vuejs/vitepress/issues/693)) ([#701](https://github.com/vuejs/vitepress/issues/701)) ([59df105](https://github.com/vuejs/vitepress/commit/59df10590b958bbc39cc2e8c81a2209eda9d431b))
+* better nav item types ([#714](https://github.com/vuejs/vitepress/issues/714)) ([263607b](https://github.com/vuejs/vitepress/commit/263607b279cbfd3db80bbe0ea66000560d24993a))
+* double base in sidebar links ([#756](https://github.com/vuejs/vitepress/issues/756)) ([aa65cb5](https://github.com/vuejs/vitepress/commit/aa65cb58f508bb8e79c20b6370bdfe1b7e470abf))
+* use `pre-wrap` for text and tagline ([#746](https://github.com/vuejs/vitepress/issues/746)) ([94704c9](https://github.com/vuejs/vitepress/commit/94704c95637f1cc844d526d4743818d38d1cbae0))
+* nav nested items type error ([#710](https://github.com/vuejs/vitepress/issues/710)) ([#711](https://github.com/vuejs/vitepress/issues/711)) ([e5bf15a](https://github.com/vuejs/vitepress/commit/e5bf15a21ee777b4e56ad86ec5ebb5b0e161b721))
+* page layout breaks when page name matches the css class name ([#696](https://github.com/vuejs/vitepress/issues/696)) ([#699](https://github.com/vuejs/vitepress/issues/699)) ([9c0ed93](https://github.com/vuejs/vitepress/commit/9c0ed9397f35827a261d45c789d23ce7faa7ecee))
+* remove title bg transition to avoid flush on sidebar on/off ([1942418](https://github.com/vuejs/vitepress/commit/1942418f9570feb81d8066a2413d70b0f36fb8ce))
+* sidebar right blur notch ([#712](https://github.com/vuejs/vitepress/issues/712)) ([64c3654](https://github.com/vuejs/vitepress/commit/64c3654b4ba82c16fefdf396106f3077d066c67b))
+* typo ([#708](https://github.com/vuejs/vitepress/issues/708)) ([#716](https://github.com/vuejs/vitepress/issues/716)) ([1fe5153](https://github.com/vuejs/vitepress/commit/1fe5153f47465efed05e087119c93d50da6e92a3))
+* title in containers not working with markdown content ([#765](https://github.com/vuejs/vitepress/issues/765)) ([#768](https://github.com/vuejs/vitepress/issues/768)) ([c5c3c64](https://github.com/vuejs/vitepress/commit/c5c3c64851b240279a304198fd97e3dc8b5f2fd0))
+* use base in links ([#717](https://github.com/vuejs/vitepress/issues/717)) ([#718](https://github.com/vuejs/vitepress/issues/718)) ([8e50154](https://github.com/vuejs/vitepress/commit/8e5015462c8f42c5404525ac8de33af8862c204d))
+* use h2 for feature headers ([#774](https://github.com/vuejs/vitepress/issues/774)) ([b1ff725](https://github.com/vuejs/vitepress/commit/b1ff72561182c91b4912ebef44204a53ee3aca5e))
+
+### Features
+
+* add `lastUpdated` option to frontmatter ([b31fbf3](https://github.com/vuejs/vitepress/commit/b31fbf3621bbd7f627a1b80c581b7a8444bc6b0d))
+* add doc before and after slot ([#762](https://github.com/vuejs/vitepress/issues/762)) ([#786](https://github.com/vuejs/vitepress/issues/786)) ([9c2a36f](https://github.com/vuejs/vitepress/commit/9c2a36f5428bd98eafb6e2e9bc63f5e532b596b7))
+* allow custom edit links ([#698](https://github.com/vuejs/vitepress/issues/698)) ([535e176](https://github.com/vuejs/vitepress/commit/535e176b9a230f692f58a79813a12d2ffbe90be3)), closes [#694](https://github.com/vuejs/vitepress/issues/694) [#697](https://github.com/vuejs/vitepress/issues/697)
+* allow custom outline title ([#689](https://github.com/vuejs/vitepress/issues/689)) ([#690](https://github.com/vuejs/vitepress/issues/690)) ([a8a1623](https://github.com/vuejs/vitepress/commit/a8a16237cd8e3e4bb180fbd523a4668a4555b732))
+* allow external links in sidebar ([#205](https://github.com/vuejs/vitepress/issues/205)) ([#686](https://github.com/vuejs/vitepress/issues/686)) ([ce17f50](https://github.com/vuejs/vitepress/commit/ce17f5035cbbd1e07373ce0f44913f25269bd80b))
+* support custom content in home layout ([#702](https://github.com/vuejs/vitepress/issues/702)) ([92659a2](https://github.com/vuejs/vitepress/commit/92659a2e9dde13e35fadf2d2dca157d648bc9013))
+* emit 404.html on build ([#729](https://github.com/vuejs/vitepress/issues/729)) ([#740](https://github.com/vuejs/vitepress/issues/740)) ([23276ba](https://github.com/vuejs/vitepress/commit/23276bae050190b6c1d57347424360fe2c3a57be))
+* setup devtools and remove debug component ([#721](https://github.com/vuejs/vitepress/issues/721)) ([421f641](https://github.com/vuejs/vitepress/commit/421f641a76ddc0e8b0f23ab7ad711833fc98c245))
+
+## [1.0.0-alpha.1](https://github.com/vuejs/vitepress/compare/v0.22.4...v1.0.0-alpha.1) (2022-06-01)
 
 Complete rewrite on default theme, with bunch of features added. Please refer to the docs for the new feature and changes.
 
diff --git a/docs/guide/deploying.md b/docs/guide/deploying.md
index 4b7c4c33e461..f67faf8162fd 100644
--- a/docs/guide/deploying.md
+++ b/docs/guide/deploying.md
@@ -258,3 +258,23 @@ Go to https://vercel.com/new and import the project into Vercel using your Git o
 After your project has been imported, all subsequent pushes to branches will generate Preview Deployments, and all changes made to the Production Branch (commonly "main") will result in a Production Deployment.
 
 Once deployed, you will get a URL to see your app live, such as the following: https://vitepress.vercel.app
+
+## Layer0
+
+See [Creating and Deploying a VitePress App with Layer0](https://docs.layer0.co/guides/vitepress).
+
+## Cloudflare Pages
+
+1. Go to [Cloudflare dashboard](https://dash.cloudflare.com/) > Account Home > Pages and selecting **Create a project**.
+2. You will see three options, just select first **Connect to a git provider**.
+3. Click Connect GitHub or Connect GitLab. Then select the repo you want to deploy.
+4. Set up build docs command, like `npm run build` or `npm run docs:build`.
+5. Now deploy, you will get a domain like `my-project.pages.dev`.
+
+::: warning Do not Auto Minify HTML
+If you want or are using Cloudflare's Auto minify feature, you should not check the html box.
+
+With Auto Minify, Cloudflare will automatically remove the comments in the html file, however, html comments for Vue has meanings. For example, it works as a placeholder for `v-if`.
+
+If it gets removed, then you will probably see a hydration mismatch error.
+:::
diff --git a/docs/guide/migration-from-vuepress.md b/docs/guide/migration-from-vuepress.md
index 75faf43a219d..c18c754f697b 100644
--- a/docs/guide/migration-from-vuepress.md
+++ b/docs/guide/migration-from-vuepress.md
@@ -1,3 +1,24 @@
 # Migration from VuePress
 
-Coming soon...
+## Markdown
+
+### Images
+
+Unlike VuePress, VitePress handles [`base`](/guide/asset-handling.html#base-url) of your config automatically when you use static image.
+
+Hence, now you can render images without `img` tag.
+
+```diff
+- <img :src="$withBase('/foo.png')" alt="foo">
++ ![foo](/foo.png)
+```
+
+::: warning
+For dynamic images you still need `withBase` as shown in [Base URL guide](/guide/asset-handling.html#base-url).
+:::
+
+Use `<img.*withBase\('(.*)'\).*alt="([^"]*)".*>` regex to find and replace it with `![$2]($1)` to replace all the images with `![](...)` syntax.
+
+---
+
+more to follow...
diff --git a/package.json b/package.json
index cd4787ba4a54..6aa478d5e964 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "vitepress",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.2",
   "description": "Vite & Vue powered static site generator",
   "type": "module",
   "packageManager": "pnpm@7.1.7",
diff --git a/scripts/release.js b/scripts/release.js
index 8da3732a4e96..3585bef705d5 100644
--- a/scripts/release.js
+++ b/scripts/release.js
@@ -33,7 +33,7 @@ async function main() {
     message: 'Select release type',
     choices: versions
   })
-  console.log(release, release === 3)
+
   if (release === 3) {
     targetVersion = (
       await prompts({
diff --git a/src/client/app/data.ts b/src/client/app/data.ts
index fb68378f7aa4..3e3fa7a2be40 100644
--- a/src/client/app/data.ts
+++ b/src/client/app/data.ts
@@ -1,6 +1,6 @@
 import { InjectionKey, Ref, shallowRef, readonly, computed, inject } from 'vue'
 import { Route } from './router'
-import serializedSiteData from '@siteData'
+import siteData from '@siteData'
 import {
   PageData,
   SiteData,
@@ -25,17 +25,14 @@ export interface VitePressData<T = any> {
 // site data is a singleton
 export type SiteDataRef<T = any> = Ref<SiteData<T>>
 
-export const siteDataRef: Ref<SiteData> = shallowRef(parse(serializedSiteData))
-
-function parse(data: string): SiteData {
-  const parsed = JSON.parse(data)
-  return (import.meta.env.DEV ? readonly(parsed) : parsed) as SiteData
-}
+export const siteDataRef: Ref<SiteData> = shallowRef(
+  import.meta.env.PROD ? siteData : readonly(siteData)
+)
 
 // hmr
 if (import.meta.hot) {
   import.meta.hot!.accept('/@siteData', (m) => {
-    siteDataRef.value = parse(m.default)
+    siteDataRef.value = m.default
   })
 }
 
diff --git a/src/client/shim.d.ts b/src/client/shim.d.ts
index 7bbd1c464ebb..f627e1022e81 100644
--- a/src/client/shim.d.ts
+++ b/src/client/shim.d.ts
@@ -10,7 +10,8 @@ declare module '*.vue' {
 }
 
 declare module '@siteData' {
-  const data: string
+  import type { SiteData } from './shared'
+  const data: SiteData
   export default data
 }
 
diff --git a/src/client/theme-default/components/VPBox.vue b/src/client/theme-default/components/VPFeature.vue
similarity index 91%
rename from src/client/theme-default/components/VPBox.vue
rename to src/client/theme-default/components/VPFeature.vue
index 7461f53bee98..7f24f3f351a9 100644
--- a/src/client/theme-default/components/VPBox.vue
+++ b/src/client/theme-default/components/VPFeature.vue
@@ -7,7 +7,7 @@ defineProps<{
 </script>
 
 <template>
-  <article class="VPBox">
+  <article class="VPFeature">
     <div v-if="icon" class="icon">{{ icon }}</div>
     <h2 class="title">{{ title }}</h2>
     <p class="details">{{ details }}</p>
@@ -15,8 +15,8 @@ defineProps<{
 </template>
 
 <style scoped>
-.VPBox {
-  border: 1px solid var(--vp-c-divider-light);
+.VPFeature {
+  border: 1px solid var(--vp-c-bg-soft);
   border-radius: 12px;
   padding: 24px;
   height: 100%;
diff --git a/src/client/theme-default/components/VPFeatures.vue b/src/client/theme-default/components/VPFeatures.vue
new file mode 100644
index 000000000000..db49bde43cc3
--- /dev/null
+++ b/src/client/theme-default/components/VPFeatures.vue
@@ -0,0 +1,107 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import VPFeature from './VPFeature.vue'
+
+export interface Feature {
+  icon?: string
+  title: string
+  details: string
+}
+
+const props = defineProps<{
+  features: Feature[]
+}>()
+
+const grid = computed(() => {
+  const length = props.features.length
+
+  if (!length) {
+    return
+  } else if (length === 2) {
+    return 'grid-2'
+  } else if (length === 3) {
+    return 'grid-3'
+  } else if (length % 3 === 0) {
+    return 'grid-6'
+  } else if (length % 2 === 0) {
+    return 'grid-4'
+  }
+})
+</script>
+
+<template>
+  <div v-if="features" class="VPFeatures">
+    <div class="container">
+      <div class="items">
+        <div v-for="feature in features" :key="feature.title" class="item" :class="[grid]">
+          <VPFeature
+            :icon="feature.icon"
+            :title="feature.title"
+            :details="feature.details"
+          />
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.VPFeatures {
+  position: relative;
+  padding: 0 24px;
+}
+
+@media (min-width: 640px) {
+  .VPFeatures {
+    padding: 0 48px;
+  }
+}
+
+@media (min-width: 960px) {
+  .VPFeatures {
+    padding: 0 64px;
+  }
+}
+
+.container {
+  margin: 0 auto;
+  max-width: 1152px;
+}
+
+.items {
+  display: flex;
+  flex-wrap: wrap;
+  margin: -8px;
+}
+
+.item {
+  padding: 8px;
+  width: 100%;
+}
+
+@media (min-width: 640px) {
+  .item.grid-2,
+  .item.grid-4,
+  .item.grid-6 {
+    width: calc(100% / 2);
+  }
+}
+
+@media (min-width: 768px) {
+  .item.grid-2,
+  .item.grid-4 {
+    width: calc(100% / 2);
+  }
+
+  .item.grid-3,
+  .item.grid-6 {
+    width: calc(100% / 3);
+  }
+}
+
+@media (min-width: 960px) {
+  .item.grid-4 {
+    width: calc(100% / 4);
+  }
+}
+</style>
diff --git a/src/client/theme-default/components/VPHero.vue b/src/client/theme-default/components/VPHero.vue
index 11100c7281a9..81770bb268e4 100644
--- a/src/client/theme-default/components/VPHero.vue
+++ b/src/client/theme-default/components/VPHero.vue
@@ -1,5 +1,7 @@
 <script setup lang="ts">
+import type { DefaultTheme } from 'vitepress/theme'
 import VPButton from './VPButton.vue'
+import VPImage from './VPImage.vue'
 
 export interface HeroAction {
   theme?: 'brand' | 'alt'
@@ -7,16 +9,11 @@ export interface HeroAction {
   link: string
 }
 
-export interface Image {
-  src: string
-  alt?: string
-}
-
 defineProps<{
   name?: string
   text: string
   tagline?: string
-  image?: Image
+  image?: DefaultTheme.ThemeableImage
   actions?: HeroAction[]
 }>()
 </script>
@@ -25,7 +22,9 @@ defineProps<{
   <div class="VPHero" :class="{ 'has-image': image }">
     <div class="container">
       <div class="main">
-        <h1 v-if="name" class="name"><span class="clip">{{ name }}</span></h1>
+        <h1 v-if="name" class="name">
+          <span class="clip">{{ name }}</span>
+        </h1>
         <p v-if="text" class="text">{{ text }}</p>
         <p v-if="tagline" class="tagline">{{ tagline }}</p>
 
@@ -45,7 +44,7 @@ defineProps<{
       <div v-if="image" class="image">
         <div class="image-container">
           <div class="image-bg" />
-          <img class="image-src" :src="image.src" :alt="image.alt">
+          <VPImage class="image-src" :image="image" />
         </div>
       </div>
     </div>
@@ -64,11 +63,17 @@ defineProps<{
   }
 }
 
+@media (min-width: 960px) {
+  .VPHero {
+    padding: calc(var(--vp-nav-height) + 80px) 64px 64px;
+  }
+}
+
 .container {
   display: flex;
   flex-direction: column;
   margin: 0 auto;
-  max-width: 960px;
+  max-width: 1152px;
 }
 
 @media (min-width: 960px) {
@@ -98,13 +103,11 @@ defineProps<{
 @media (min-width: 960px) {
   .main {
     order: 1;
+    width: calc((100% / 3) * 2);
   }
-}
 
-@media (min-width: 960px) {
-  .main {
-    width: 100%;
-    max-width: calc((100% / 3) * 2);
+  .VPHero.has-image .main {
+    max-width: 592px;
   }
 }
 
@@ -157,7 +160,7 @@ defineProps<{
 }
 
 .tagline {
-  padding-top: 16px;
+  padding-top: 8px;
   max-width: 392px;
   line-height: 28px;
   font-size: 18px;
@@ -172,7 +175,7 @@ defineProps<{
 
 @media (min-width: 640px) {
   .tagline {
-    padding-top: 24px;
+    padding-top: 12px;
     max-width: 576px;
     line-height: 32px;
     font-size: 20px;
@@ -181,7 +184,6 @@ defineProps<{
 
 @media (min-width: 960px) {
   .tagline {
-    padding-top: 24px;
     line-height: 36px;
     font-size: 24px;
   }
@@ -232,9 +234,9 @@ defineProps<{
 
 @media (min-width: 960px) {
   .image {
+    flex-grow: 1;
     order: 2;
     margin: 0;
-    width: calc(100% / 3);
     min-height: 100%;
   }
 }
@@ -290,7 +292,7 @@ defineProps<{
   }
 }
 
-.image-src {
+:deep(.image-src) {
   position: absolute;
   top: 50%;
   left: 50%;
diff --git a/src/client/theme-default/components/VPHomeFeatures.vue b/src/client/theme-default/components/VPHomeFeatures.vue
index 86fc2a50cf69..ee593fc14db7 100644
--- a/src/client/theme-default/components/VPHomeFeatures.vue
+++ b/src/client/theme-default/components/VPHomeFeatures.vue
@@ -1,97 +1,14 @@
 <script setup lang="ts">
-import { computed } from 'vue'
 import { useData } from 'vitepress'
-import VPBox from './VPBox.vue'
+import VPFeatures from './VPFeatures.vue'
 
 const { frontmatter: fm } = useData()
-
-const grid = computed(() => {
-  const length = fm.value.features?.length
-
-  if (!length) {
-    return
-  }
-
-  if (length === 2) {
-    return 'grid-2'
-  } else if (length === 3) {
-    return 'grid-3'
-  } else if (length % 3 === 0) {
-    return 'grid-6'
-  } else if (length % 2 === 0) {
-    return 'grid-4'
-  }
-})
 </script>
 
 <template>
-  <div v-if="fm.features" class="VPHomeFeatures">
-    <div class="container">
-      <div class="items">
-        <div v-for="feature in fm.features" :key="feature.title" class="item" :class="[grid]">
-          <VPBox
-            :icon="feature.icon"
-            :title="feature.title"
-            :details="feature.details"
-          />
-        </div>
-      </div>
-    </div>
-  </div>
+  <VPFeatures
+    v-if="fm.features"
+    class="VPHomeFeatures"
+    :features="fm.features"
+  />
 </template>
-
-<style scoped>
-.VPHomeFeatures {
-  position: relative;
-  padding: 0 24px;
-}
-
-@media (min-width: 640px) {
-  .VPHomeFeatures {
-    padding: 0 48px;
-  }
-}
-
-.container {
-  margin: 0 auto;
-  max-width: 960px;
-}
-
-.items {
-  display: flex;
-  flex-wrap: wrap;
-  margin: -8px;
-}
-
-.item {
-  padding: 8px;
-  width: 100%;
-}
-
-@media (min-width: 640px) {
-  .item.grid-2,
-  .item.grid-4,
-  .item.grid-6 {
-    width: calc(100% / 2);
-  }
-}
-
-@media (min-width: 768px) {
-  .item.grid-2,
-  .item.grid-4 {
-    width: calc(100% / 2);
-  }
-
-  .item.grid-3,
-  .item.grid-6 {
-    width: calc(100% / 3);
-  }
-}
-
-@media (min-width: 960px) {
-  .item.grid-4 {
-    width: calc(100% / 4);
-  }
-}
-
-</style>
diff --git a/src/client/theme-default/components/VPHomeHero.vue b/src/client/theme-default/components/VPHomeHero.vue
index a12be5a606d0..9aa64aa9dda0 100644
--- a/src/client/theme-default/components/VPHomeHero.vue
+++ b/src/client/theme-default/components/VPHomeHero.vue
@@ -6,13 +6,13 @@ const { frontmatter: fm } = useData()
 </script>
 
 <template>
-  <div v-if="fm.hero" class="VPHomeHero">
-    <VPHero
-      :name="fm.hero.name"
-      :text="fm.hero.text"
-      :tagline="fm.hero.tagline"
-      :image="fm.hero.image"
-      :actions="fm.hero.actions"
-    />
-  </div>
+  <VPHero
+    v-if="fm.hero"
+    class="VPHomeHero"
+    :name="fm.hero.name"
+    :text="fm.hero.text"
+    :tagline="fm.hero.tagline"
+    :image="fm.hero.image"
+    :actions="fm.hero.actions"
+  />
 </template>
diff --git a/src/client/theme-default/components/VPHomeSponsors.vue b/src/client/theme-default/components/VPHomeSponsors.vue
index 102912d596bb..88249522d283 100644
--- a/src/client/theme-default/components/VPHomeSponsors.vue
+++ b/src/client/theme-default/components/VPHomeSponsors.vue
@@ -55,7 +55,7 @@ defineProps<{
 
 .container {
   margin: 0 auto;
-  max-width: 960px;
+  max-width: 1152px;
 }
 
 .love {
diff --git a/src/client/theme-default/components/VPImage.vue b/src/client/theme-default/components/VPImage.vue
new file mode 100644
index 000000000000..90f5b8be1bbb
--- /dev/null
+++ b/src/client/theme-default/components/VPImage.vue
@@ -0,0 +1,38 @@
+<script setup lang="ts">
+import { withBase } from 'vitepress'
+import type { DefaultTheme } from 'vitepress/theme'
+
+defineProps<{
+  image: DefaultTheme.ThemeableImage
+}>()
+</script>
+
+<script lang="ts">
+export default {
+  inheritAttrs: false
+}
+</script>
+
+<template>
+  <template v-if="image">
+    <img
+      v-if="typeof image === 'string' || 'src' in image"
+      class="VPImage"
+      v-bind="typeof image === 'string' ? $attrs : { ...image, ...$attrs }"
+      :src="withBase(typeof image === 'string' ? image : image.src)"
+    />
+    <template v-else>
+      <VPImage class="dark" :image="image.dark" v-bind="$attrs" />
+      <VPImage class="light" :image="image.light" v-bind="$attrs" />
+    </template>
+  </template>
+</template>
+
+<style scoped>
+html:not(.dark) .VPImage.dark {
+  display: none;
+}
+.dark .VPImage.light {
+  display: none;
+}
+</style>
diff --git a/src/client/theme-default/components/VPNavBarTitle.vue b/src/client/theme-default/components/VPNavBarTitle.vue
index 6f2e0cb66f86..5b037cff50e9 100644
--- a/src/client/theme-default/components/VPNavBarTitle.vue
+++ b/src/client/theme-default/components/VPNavBarTitle.vue
@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { useData } from 'vitepress'
 import { useSidebar } from '../composables/sidebar'
+import VPImage from './VPImage.vue'
 
 const { site, theme } = useData()
 const { hasSidebar } = useSidebar()
@@ -9,7 +10,7 @@ const { hasSidebar } = useSidebar()
 <template>
   <div class="VPNavBarTitle" :class="{ 'has-sidebar': hasSidebar }">
     <a class="title" :href="site.base">
-      <img v-if="theme.logo" class="logo" :src="theme.logo">
+      <VPImage class="logo" :image="theme.logo" />
       <template v-if="theme.siteTitle">{{ theme.siteTitle }}</template>
       <template v-else-if="theme.siteTitle === undefined">{{ site.title }}</template>
     </a>
@@ -52,7 +53,7 @@ const { hasSidebar } = useSidebar()
   }
 }
 
-.logo {
+:deep(.logo) {
   margin-right: 8px;
   height: 24px;
 }
diff --git a/src/client/theme-default/composables/copy-code.ts b/src/client/theme-default/composables/copy-code.ts
index bd5d73ab8f99..35aca1c10579 100644
--- a/src/client/theme-default/composables/copy-code.ts
+++ b/src/client/theme-default/composables/copy-code.ts
@@ -20,6 +20,50 @@ export function useCopyCode() {
     )
 }
 
+async function copyToClipboard(text: string) {
+  try {
+    return navigator.clipboard.writeText(text)
+  } catch {
+    const element = document.createElement('textarea')
+    const previouslyFocusedElement = document.activeElement
+
+    element.value = text
+
+    // Prevent keyboard from showing on mobile
+    element.setAttribute('readonly', '')
+
+    element.style.contain = 'strict'
+    element.style.position = 'absolute'
+    element.style.left = '-9999px'
+    element.style.fontSize = '12pt' // Prevent zooming on iOS
+
+    const selection = document.getSelection()
+    const originalRange = selection
+      ? selection.rangeCount > 0 && selection.getRangeAt(0)
+      : null
+
+    document.body.appendChild(element)
+    element.select()
+
+    // Explicit selection workaround for iOS
+    element.selectionStart = 0
+    element.selectionEnd = text.length
+
+    document.execCommand('copy')
+    document.body.removeChild(element)
+
+    if (originalRange) {
+      selection!.removeAllRanges() // originalRange can't be truthy when selection is falsy
+      selection!.addRange(originalRange)
+    }
+
+    // Get the focus back on the previously focused element, if any
+    if (previouslyFocusedElement) {
+      ;(previouslyFocusedElement as HTMLElement).focus()
+    }
+  }
+}
+
 function handleElement(el: HTMLElement) {
   el.onclick = () => {
     const parent = el.parentElement
@@ -38,7 +82,7 @@ function handleElement(el: HTMLElement) {
       text = text.replace(/^ *\$ /gm, '')
     }
 
-    navigator.clipboard.writeText(text).then(() => {
+    copyToClipboard(text).then(() => {
       el.classList.add('copied')
       setTimeout(() => {
         el.classList.remove('copied')
diff --git a/src/client/theme-default/fonts/inter-cyrillic-ext.woff2 b/src/client/theme-default/fonts/inter-cyrillic-ext.woff2
index e5ccce41a9f7..f2728758683c 100644
Binary files a/src/client/theme-default/fonts/inter-cyrillic-ext.woff2 and b/src/client/theme-default/fonts/inter-cyrillic-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-cyrillic.woff2 b/src/client/theme-default/fonts/inter-cyrillic.woff2
index 560639606c12..de6a128bc11e 100644
Binary files a/src/client/theme-default/fonts/inter-cyrillic.woff2 and b/src/client/theme-default/fonts/inter-cyrillic.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-greek-ext.woff2 b/src/client/theme-default/fonts/inter-greek-ext.woff2
index e07f5c96f711..701afd3cb0c9 100644
Binary files a/src/client/theme-default/fonts/inter-greek-ext.woff2 and b/src/client/theme-default/fonts/inter-greek-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-greek.woff2 b/src/client/theme-default/fonts/inter-greek.woff2
index 94c69138488a..74125bbc86cd 100644
Binary files a/src/client/theme-default/fonts/inter-greek.woff2 and b/src/client/theme-default/fonts/inter-greek.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-cyrillic-ext.woff2 b/src/client/theme-default/fonts/inter-italic-cyrillic-ext.woff2
new file mode 100644
index 000000000000..2a687296748f
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-cyrillic-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-cyrillic.woff2 b/src/client/theme-default/fonts/inter-italic-cyrillic.woff2
new file mode 100644
index 000000000000..f64035158d7e
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-cyrillic.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-greek-ext.woff2 b/src/client/theme-default/fonts/inter-italic-greek-ext.woff2
new file mode 100644
index 000000000000..00218960325a
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-greek-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-greek.woff2 b/src/client/theme-default/fonts/inter-italic-greek.woff2
new file mode 100644
index 000000000000..71c265f85c9b
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-greek.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-latin-ext.woff2 b/src/client/theme-default/fonts/inter-italic-latin-ext.woff2
new file mode 100644
index 000000000000..9c1b9440ed41
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-latin-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-latin.woff2 b/src/client/theme-default/fonts/inter-italic-latin.woff2
new file mode 100644
index 000000000000..01fcf20724f9
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-latin.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-italic-vietnamese.woff2 b/src/client/theme-default/fonts/inter-italic-vietnamese.woff2
new file mode 100644
index 000000000000..e4f788ee02bb
Binary files /dev/null and b/src/client/theme-default/fonts/inter-italic-vietnamese.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-latin-ext.woff2 b/src/client/theme-default/fonts/inter-latin-ext.woff2
index 0e5999b6893c..2fa148c30c8d 100644
Binary files a/src/client/theme-default/fonts/inter-latin-ext.woff2 and b/src/client/theme-default/fonts/inter-latin-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-latin.woff2 b/src/client/theme-default/fonts/inter-latin.woff2
index 2fbab974a9e1..1a4cd429ecff 100644
Binary files a/src/client/theme-default/fonts/inter-latin.woff2 and b/src/client/theme-default/fonts/inter-latin.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-cyrillic-ext.woff2 b/src/client/theme-default/fonts/inter-roman-cyrillic-ext.woff2
new file mode 100644
index 000000000000..28593ccb8a4d
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-cyrillic-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-cyrillic.woff2 b/src/client/theme-default/fonts/inter-roman-cyrillic.woff2
new file mode 100644
index 000000000000..a20adc161f43
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-cyrillic.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-greek-ext.woff2 b/src/client/theme-default/fonts/inter-roman-greek-ext.woff2
new file mode 100644
index 000000000000..e3b0be76db26
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-greek-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-greek.woff2 b/src/client/theme-default/fonts/inter-roman-greek.woff2
new file mode 100644
index 000000000000..f790e047daa3
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-greek.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-latin-ext.woff2 b/src/client/theme-default/fonts/inter-roman-latin-ext.woff2
new file mode 100644
index 000000000000..715bd903b9b1
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-latin-ext.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-latin.woff2 b/src/client/theme-default/fonts/inter-roman-latin.woff2
new file mode 100644
index 000000000000..a540b7afe7a4
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-latin.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-roman-vietnamese.woff2 b/src/client/theme-default/fonts/inter-roman-vietnamese.woff2
new file mode 100644
index 000000000000..5a9f9cb9ca0c
Binary files /dev/null and b/src/client/theme-default/fonts/inter-roman-vietnamese.woff2 differ
diff --git a/src/client/theme-default/fonts/inter-vietnamese.woff2 b/src/client/theme-default/fonts/inter-vietnamese.woff2
index f29f5de6841d..c2ffbb0913ef 100644
Binary files a/src/client/theme-default/fonts/inter-vietnamese.woff2 and b/src/client/theme-default/fonts/inter-vietnamese.woff2 differ
diff --git a/src/client/theme-default/styles/fonts.css b/src/client/theme-default/styles/fonts.css
index e9c9db97bba5..7d18208c88be 100644
--- a/src/client/theme-default/styles/fonts.css
+++ b/src/client/theme-default/styles/fonts.css
@@ -1,67 +1,217 @@
 @font-face {
-  font-family: Inter;
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
   font-style: normal;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-cyrillic.woff2') format('woff2');
+  unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
+}
+
+@font-face {
+  font-family: 'Inter var';
   font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-latin.woff2) format('woff2');
-  unicode-range: U+00??, U+0131, U+0152-0153, U+02bb-02bc, U+02c6, U+02da,
-    U+02dc, U+2000-206f, U+2074, U+20ac, U+2122, U+2191, U+2193, U+2212, U+2215,
-    U+feff, U+fffd;
+  font-style: normal;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-cyrillic-ext.woff2') format('woff2');
+  unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F,
+    U+FE2E-FE2F;
 }
 
 @font-face {
-  font-family: Inter;
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
   font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-greek.woff2') format('woff2');
+  unicode-range: U+0370-03FF;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-latin-ext.woff2) format('woff2');
-  unicode-range: U+0100-024f, U+0259, U+1e??, U+2020, U+20a0-20ab, U+20ad-20cf,
-    U+2113, U+2c60-2c7f, U+a720-a7ff;
+  font-style: normal;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-greek-ext.woff2') format('woff2');
+  unicode-range: U+1F00-1FFF;
 }
 
 @font-face {
-  font-family: Inter;
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
   font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215,
+    U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-cyrillic.woff2) format('woff2');
-  unicode-range: U+0400-045f, U+0490-0491, U+04b0-04b1, U+2116;
+  font-style: normal;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB,
+    U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
 }
 
 @font-face {
-  font-family: Inter;
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
   font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-named-instance: 'Regular';
+  src: url('../fonts/inter-roman-vietnamese.woff2') format('woff2');
+  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1,
+    U+01AF-01B0, U+1EA0-1EF9, U+20AB;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-cyrillic-ext.woff2) format('woff2');
-  unicode-range: U+0460-052f, U+1c80-1c88, U+20b4, U+2de0-2dff, U+a640-a69f,
-    U+fe2e-fe2f;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-cyrillic.woff2') format('woff2');
+  unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
 }
 
 @font-face {
-  font-family: Inter;
-  font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-family: 'Inter var';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-greek.woff2) format('woff2');
-  unicode-range: U+0370-03ff;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-cyrillic-ext.woff2') format('woff2');
+  unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F,
+    U+FE2E-FE2F;
 }
 
 @font-face {
-  font-family: Inter;
-  font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-family: 'Inter var';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-greek-ext.woff2) format('woff2');
-  unicode-range: U+1f??;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-greek.woff2') format('woff2');
+  unicode-range: U+0370-03FF;
 }
 
 @font-face {
-  font-family: Inter;
-  font-style: normal;
-  font-weight: 400 500 600 700 900;
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-greek-ext.woff2') format('woff2');
+  unicode-range: U+1F00-1FFF;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215,
+    U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB,
+    U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'Inter var';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: italic;
+  font-named-instance: 'Italic';
+  src: url('../fonts/inter-italic-vietnamese.woff2') format('woff2');
+  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1,
+    U+01AF-01B0, U+1EA0-1EF9, U+20AB;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-cyrillic.woff2') format('woff2');
+  unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-cyrillic-ext.woff2') format('woff2');
+  unicode-range: U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F,
+    U+FE2E-FE2F;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-greek.woff2') format('woff2');
+  unicode-range: U+0370-03FF;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-greek-ext.woff2') format('woff2');
+  unicode-range: U+1F00-1FFF;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-latin.woff2') format('woff2');
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
+    U+02DC, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215,
+    U+FEFF, U+FFFD;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
+  font-display: swap;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-latin-ext.woff2') format('woff2');
+  unicode-range: U+0100-024F, U+0259, U+1E00-1EFF, U+2020, U+20A0-20AB,
+    U+20AD-20CF, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+  font-family: 'Inter var experimental';
+  font-weight: 100 900;
   font-display: swap;
-  src: url(../fonts/inter-vietnamese.woff2) format('woff2');
-  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01a0-01a1,
-    U+01af-01b0, U+1ea0-1ef9, U+20ab;
+  font-style: oblique 0deg 10deg;
+  src: url('../fonts/inter-vietnamese.woff2') format('woff2');
+  unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1,
+    U+01AF-01B0, U+1EA0-1EF9, U+20AB;
 }
diff --git a/src/client/theme-default/styles/vars.css b/src/client/theme-default/styles/vars.css
index ee03cfd19abe..f6d5248cad40 100644
--- a/src/client/theme-default/styles/vars.css
+++ b/src/client/theme-default/styles/vars.css
@@ -145,7 +145,7 @@
  * -------------------------------------------------------------------------- */
 
 :root {
-  --vp-font-family-base: Inter, -apple-system,
+  --vp-font-family-base: 'Inter var experimental', 'Inter var', -apple-system,
     BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell,
     'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
   --vp-font-family-mono: Menlo, Monaco, Consolas, 'Courier New', monospace;
@@ -179,7 +179,7 @@
  * Icons
  * -------------------------------------------------------------------------- */
 
- :root {
+:root {
   --vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' height='20' width='20' stroke='rgba(128,128,128,1)' stroke-width='2' class='h-6 w-6' viewBox='0 0 24 24'%3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='M9 5H7a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2M9 5a2 2 0 0 0 2 2h2a2 2 0 0 0 2-2M9 5a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2'/%3E%3C/svg%3E");
   --vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' height='20' width='20' stroke='rgba(128,128,128,1)' stroke-width='2' class='h-6 w-6' viewBox='0 0 24 24'%3E%3Cpath stroke-linecap='round' stroke-linejoin='round' d='M9 5H7a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2h-2M9 5a2 2 0 0 0 2 2h2a2 2 0 0 0 2-2M9 5a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2m-6 9 2 2 4-4'/%3E%3C/svg%3E");
 }
diff --git a/src/client/tsconfig.json b/src/client/tsconfig.json
index eb2b39eedbcd..9208c9f6ccd4 100644
--- a/src/client/tsconfig.json
+++ b/src/client/tsconfig.json
@@ -12,7 +12,8 @@
     "types": ["vite/client"],
     "paths": {
       "/@theme/*": ["theme-default/*"],
-      "vitepress": ["index.ts"]
+      "vitepress": ["index.ts"],
+      "vitepress/theme": ["../../types/default-theme.d"]
     }
   },
   "include": ["."]
diff --git a/src/node/plugin.ts b/src/node/plugin.ts
index 89188f5c0267..e3f141313ef9 100644
--- a/src/node/plugin.ts
+++ b/src/node/plugin.ts
@@ -8,8 +8,6 @@ import { OutputAsset, OutputChunk } from 'rollup'
 import { staticDataPlugin } from './staticDataPlugin'
 import { PageDataPayload } from './shared'
 
-type Awaited<T> = T extends Promise<infer P> ? P : never
-
 const hashRE = /\.(\w+)\.js$/
 const staticInjectMarkerRE =
   /\b(const _hoisted_\d+ = \/\*(?:#|@)__PURE__\*\/\s*createStaticVNode)\("(.*)", (\d+)\)/g
@@ -126,7 +124,9 @@ export async function createVitePressPlugin(
         if (config.command === 'build') {
           data = { ...siteData, head: [] }
         }
-        return `export default ${JSON.stringify(JSON.stringify(data))}`
+        return `export default JSON.parse(${JSON.stringify(
+          JSON.stringify(data)
+        )})`
       }
     },
 
diff --git a/types/default-theme.d.ts b/types/default-theme.d.ts
index ec0d69a79c23..945773672e6f 100644
--- a/types/default-theme.d.ts
+++ b/types/default-theme.d.ts
@@ -5,7 +5,7 @@ export namespace DefaultTheme {
      *
      * @example '/logo.svg'
      */
-    logo?: string
+    logo?: ThemeableImage
 
     /**
      * Custom site title in navbar. If the value is undefined,
@@ -96,6 +96,11 @@ export namespace DefaultTheme {
     items: (NavItemChildren | NavItemWithLink)[]
   }
 
+  // image -----------------------------------------------------------------------
+
+  export type ThemeableImage = Image | { light: Image; dark: Image }
+  export type Image = string | { src: string; alt?: string }
+
   // sidebar -------------------------------------------------------------------
 
   export type Sidebar = SidebarGroup[] | SidebarMulti