diff --git a/Directory.Build.props b/Directory.Build.props
index 5c9c478..89de84f 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -27,6 +27,7 @@
     <RepositoryType>git</RepositoryType>
     <PackageTags>blazor;docs;documentation;framework;shellui;shadcn;fumadocs;tailwind</PackageTags>
     <PackageReadmeFile>README.md</PackageReadmeFile>
+    <PackageIcon>icon.png</PackageIcon>
     <IncludeSymbols>true</IncludeSymbols>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
     <PublishRepositoryUrl>true</PublishRepositoryUrl>
@@ -39,6 +40,7 @@
 
   <ItemGroup Condition="'$(IsPackable)' == 'true'">
     <None Include="$(MSBuildThisFileDirectory)README.md" Pack="true" PackagePath="\" />
+    <None Include="$(MSBuildThisFileDirectory)assets\icon.png" Pack="true" PackagePath="\" Visible="false" />
   </ItemGroup>
 
 </Project>
diff --git a/README.md b/README.md
index ddc4861..78dc291 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+![ShellDocs](https://raw.githubusercontent.com/shellui-dev/shelldocs/main/assets/readme-logo.svg)
+
 # ShellDocs
 
 **The docs framework for .NET.** Markdown-driven documentation sites with live Blazor component previews, versioned docs, `Cmd+K` search, and a static export. Styled with shadcn-shaped design tokens and composable with any Blazor component library. The fumadocs / shadcn pattern, ported to .NET.
diff --git a/assets/icon.png b/assets/icon.png
new file mode 100644
index 0000000..dcbf55b
Binary files /dev/null and b/assets/icon.png differ
diff --git a/assets/readme-logo.svg b/assets/readme-logo.svg
new file mode 100644
index 0000000..f100849
--- /dev/null
+++ b/assets/readme-logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 32 32"><style>rect{fill:#0a0a0a}circle{fill:#fafafa}@media (prefers-color-scheme:dark){rect{fill:#fafafa}circle{fill:#0a0a0a}}</style><rect width="32" height="32" rx="7.04"/><circle cx="7.30" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="7.30" r="1.74"/><circle cx="16.00" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="7.30" r="1.74"/><circle cx="24.70" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="7.30" cy="11.65" r="1.74"/><circle cx="11.65" cy="11.65" r="1.74"/><circle cx="16.00" cy="11.65" r="1.74"/><circle cx="20.35" cy="11.65" r="1.74"/><circle cx="24.70" cy="11.65" r="1.74"/><circle cx="7.30" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="16.00" r="1.74"/><circle cx="16.00" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="16.00" r="1.74"/><circle cx="24.70" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="7.30" cy="20.35" r="1.74"/><circle cx="11.65" cy="20.35" r="1.74"/><circle cx="16.00" cy="20.35" r="1.74"/><circle cx="20.35" cy="20.35" r="1.74"/><circle cx="24.70" cy="20.35" r="1.74"/><circle cx="7.30" cy="24.70" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="24.70" r="1.74"/><circle cx="16.00" cy="24.70" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="24.70" r="1.74"/><circle cx="24.70" cy="24.70" r="1.74" fill-opacity="0.22"/></svg>
diff --git a/examples/ShellDocs.Preview/Components/App.razor b/examples/ShellDocs.Preview/Components/App.razor
index 6379185..3946b08 100644
--- a/examples/ShellDocs.Preview/Components/App.razor
+++ b/examples/ShellDocs.Preview/Components/App.razor
@@ -6,6 +6,9 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>ShellDocs — the docs framework for .NET</title>
     <base href="/" />
+    <link rel="icon" type="image/svg+xml" href="favicon.svg" />
+    <link rel="icon" type="image/png" sizes="32x32" href="favicon.png" />
+    <link rel="apple-touch-icon" href="apple-touch-icon.png" />
     <link rel="stylesheet" href="_content/ShellDocs.Tokens/tokens.css" />
     <link rel="stylesheet" href="_content/ShellDocs.Components/shelldocs-theme.css" />
     <link rel="stylesheet" href="ShellDocs.Preview.styles.css" />
diff --git a/examples/ShellDocs.Preview/wwwroot/apple-touch-icon.png b/examples/ShellDocs.Preview/wwwroot/apple-touch-icon.png
new file mode 100644
index 0000000..5c77fc7
Binary files /dev/null and b/examples/ShellDocs.Preview/wwwroot/apple-touch-icon.png differ
diff --git a/examples/ShellDocs.Preview/wwwroot/favicon.png b/examples/ShellDocs.Preview/wwwroot/favicon.png
new file mode 100644
index 0000000..1090a07
Binary files /dev/null and b/examples/ShellDocs.Preview/wwwroot/favicon.png differ
diff --git a/examples/ShellDocs.Preview/wwwroot/favicon.svg b/examples/ShellDocs.Preview/wwwroot/favicon.svg
new file mode 100644
index 0000000..5f07ed6
--- /dev/null
+++ b/examples/ShellDocs.Preview/wwwroot/favicon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><style>rect{fill:#0a0a0a}circle{fill:#fafafa}@media (prefers-color-scheme:dark){rect{fill:#fafafa}circle{fill:#0a0a0a}}</style><rect width="32" height="32" rx="7.04"/><circle cx="7.30" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="7.30" r="1.74"/><circle cx="16.00" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="7.30" r="1.74"/><circle cx="24.70" cy="7.30" r="1.74" fill-opacity="0.22"/><circle cx="7.30" cy="11.65" r="1.74"/><circle cx="11.65" cy="11.65" r="1.74"/><circle cx="16.00" cy="11.65" r="1.74"/><circle cx="20.35" cy="11.65" r="1.74"/><circle cx="24.70" cy="11.65" r="1.74"/><circle cx="7.30" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="16.00" r="1.74"/><circle cx="16.00" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="16.00" r="1.74"/><circle cx="24.70" cy="16.00" r="1.74" fill-opacity="0.22"/><circle cx="7.30" cy="20.35" r="1.74"/><circle cx="11.65" cy="20.35" r="1.74"/><circle cx="16.00" cy="20.35" r="1.74"/><circle cx="20.35" cy="20.35" r="1.74"/><circle cx="24.70" cy="20.35" r="1.74"/><circle cx="7.30" cy="24.70" r="1.74" fill-opacity="0.22"/><circle cx="11.65" cy="24.70" r="1.74"/><circle cx="16.00" cy="24.70" r="1.74" fill-opacity="0.22"/><circle cx="20.35" cy="24.70" r="1.74"/><circle cx="24.70" cy="24.70" r="1.74" fill-opacity="0.22"/></svg>