初始化 React TypeScript 模板并实现 Mantine 响应式基础布局

- 使用 Vite、React 和 TypeScript 初始化项目，配置 pnpm、Oxlint 与 Mantine PostCSS
- 接入 React Router Data Mode，将页面路由、菜单标题和图标统一维护在路由配置中
- 添加首页、关于概览与关于我页面，使用 Nested NavLinks 根据路由生成多级菜单
- 实现桌面侧栏展开和图标模式、移动端全宽抽屉以及与品牌区对齐的顶栏
- 将布局自定义样式拆分为 CSS Modules，统一 xs 间距并固定菜单图标列位置
- 添加文档流页脚，展示自动更新年份的示例版权说明
- 配置 Mantine 默认圆角、项目说明及中文提交约定

验证：pnpm build、pnpm lint、git diff --cached --check 均通过。

13 files changed, 410 insertions, 0 deletions

diff --git a/src/About.tsx b/src/About.tsx
new file mode 100644
index 0000000..21b4c1e
--- /dev/null
+++ b/src/About.tsx
@@ -0,0 +1,19 @@
+import { ActionIcon, Button, Group, Stack, Text, Title } from '@mantine/core'
+import { SlidersHorizontalIcon } from '@phosphor-icons/react'
+
+function About() {
+  return (
+    <Stack>
+      <Title order={1}>关于</Title>
+      <Text c="dimmed">A React + TypeScript starter built with Vite.</Text>
+      <Group gap="xs">
+        <Button variant="filled">Button</Button>
+        <ActionIcon variant="filled" aria-label="Settings">
+          <SlidersHorizontalIcon />
+        </ActionIcon>
+      </Group>
+    </Stack>
+  )
+}
+
+export default About
diff --git a/src/App.tsx b/src/App.tsx
new file mode 100644
index 0000000..8b213e6
--- /dev/null
+++ b/src/App.tsx
@@ -0,0 +1,12 @@
+import { Stack, Text, Title } from '@mantine/core'
+
+function App() {
+  return (
+    <Stack>
+      <Title order={1}>欢迎使用 Template React</Title>
+      <Text c="dimmed">从左侧菜单开始，探索你的应用。</Text>
+    </Stack>
+  )
+}
+
+export default App
diff --git a/src/Me.tsx b/src/Me.tsx
new file mode 100644
index 0000000..ab1d02f
--- /dev/null
+++ b/src/Me.tsx
@@ -0,0 +1,10 @@
+import { Stack, Text, Title } from '@mantine/core'
+
+export default function Me() {
+  return (
+    <Stack>
+      <Title order={1}>关于我</Title>
+      <Text c="dimmed">欢迎来到我的个人介绍页面。</Text>
+    </Stack>
+  )
+}
diff --git a/src/assets/hero.png b/src/assets/hero.png
new file mode 100644
index 0000000..02251f4
--- /dev/null
+++ b/src/assets/hero.png
diff --git a/src/assets/react.svg b/src/assets/react.svg
new file mode 100644
index 0000000..6c87de9
--- /dev/null
+++ b/src/assets/react.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>
\ No newline at end of file
diff --git a/src/assets/vite.svg b/src/assets/vite.svg
new file mode 100644
index 0000000..5101b67
--- /dev/null
+++ b/src/assets/vite.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="77" height="47" fill="none" aria-labelledby="vite-logo-title" viewBox="0 0 77 47"><title id="vite-logo-title">Vite</title><style>.parenthesis{fill:#000}@media (prefers-color-scheme:dark){.parenthesis{fill:#fff}}</style><path fill="#9135ff" d="M40.151 45.71c-.663.844-2.02.374-2.02-.699V34.708a2.26 2.26 0 0 0-2.262-2.262H24.493c-.92 0-1.457-1.04-.92-1.788l7.479-10.471c1.07-1.498 0-3.578-1.842-3.578H15.443c-.92 0-1.456-1.04-.92-1.788l9.696-13.576c.213-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.472c-1.07 1.497 0 3.578 1.842 3.578h11.376c.944 0 1.474 1.087.89 1.83L40.153 45.712z"/><mask id="a" width="48" height="47" x="14" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M40.047 45.71c-.663.843-2.02.374-2.02-.699V34.708a2.26 2.26 0 0 0-2.262-2.262H24.389c-.92 0-1.457-1.04-.92-1.788l7.479-10.472c1.07-1.497 0-3.578-1.842-3.578H15.34c-.92 0-1.456-1.04-.92-1.788l9.696-13.575c.213-.297.556-.474.92-.474H53.93c.92 0 1.456 1.04.92 1.788L47.37 13.03c-1.07 1.498 0 3.578 1.842 3.578h11.376c.944 0 1.474 1.088.89 1.831L40.049 45.712z"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#eee6ff" rx="5.508" ry="14.704" transform="rotate(269.814 20.96 11.29)scale(-1 1)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#eee6ff" rx="10.399" ry="29.851" transform="rotate(89.814 -16.902 -8.275)scale(1 -1)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#8900ff" rx="5.508" ry="30.487" transform="rotate(89.814 -19.197 -7.127)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#8900ff" rx="5.508" ry="30.599" transform="rotate(89.814 -25.928 4.177)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#8900ff" rx="5.508" ry="30.599" transform="rotate(89.814 -25.738 5.52)scale(1 -1)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#eee6ff" rx="14.072" ry="22.078" transform="rotate(93.35 31.245 55.578)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#8900ff" rx="3.47" ry="21.501" transform="rotate(89.009 35.419 55.202)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#8900ff" rx="3.47" ry="21.501" transform="rotate(89.009 35.419 55.202)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx="14.592" cy="9.743" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(39.51 14.592 9.743)"/></g><g filter="url(#k)"><ellipse cx="61.728" cy="-5.321" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 61.728 -5.32)"/></g><g filter="url(#l)"><ellipse cx="55.618" cy="7.104" fill="#00c2ff" rx="5.971" ry="9.665" transform="rotate(37.892 55.618 7.104)"/></g><g filter="url(#m)"><ellipse cx="12.326" cy="39.103" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 12.326 39.103)"/></g><g filter="url(#n)"><ellipse cx="12.326" cy="39.103" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 12.326 39.103)"/></g><g filter="url(#o)"><ellipse cx="49.857" cy="30.678" fill="#8900ff" rx="4.407" ry="29.108" transform="rotate(37.892 49.857 30.678)"/></g><g filter="url(#p)"><ellipse cx="52.623" cy="33.171" fill="#00c2ff" rx="5.971" ry="15.297" transform="rotate(37.892 52.623 33.17)"/></g></g><path d="M6.919 0c-9.198 13.166-9.252 33.575 0 46.789h6.215c-9.25-13.214-9.196-33.623 0-46.789zm62.424 0h-6.215c9.198 13.166 9.252 33.575 0 46.789h6.215c9.25-13.214 9.196-33.623 0-46.789" class="parenthesis"/><defs><filter id="b" width="60.045" height="41.654" x="-5.564" y="16.92" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-40.407" y="-6.762" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-35.435" y="2.801" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-30.84" y="20.8" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-29.307" y="21.949" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="29.961" y="-17.13" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="37.754" y="3.055" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="37.754" y="3.055" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-13.43" y="-22.082" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="34.321" y="-37.644" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="38.847" y="-10.552" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-15.081" y="6.78" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-15.081" y="6.78" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="22.45" y="-1.645" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="32.919" y="11.36" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17286" stdDeviation="4.596"/></filter></defs></svg>
diff --git a/src/index.css b/src/index.css
new file mode 100644
index 0000000..c2482e2
--- /dev/null
+++ b/src/index.css
@@ -0,0 +1,14 @@
+html,
+body,
+#root {
+  min-height: 100%;
+}
+
+body {
+  margin: 0;
+}
+
+#root {
+  min-height: 100dvh;
+  width: 100%;
+}
diff --git a/src/layouts/BasicLayout.module.css b/src/layouts/BasicLayout.module.css
new file mode 100644
index 0000000..a010ca5
--- /dev/null
+++ b/src/layouts/BasicLayout.module.css
@@ -0,0 +1,56 @@
+.main {
+  display: flex;
+  flex-direction: column;
+}
+
+.content {
+  flex: 1;
+  min-width: 0;
+}
+
+.footer {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-top: 1px solid var(--app-shell-border-color);
+}
+
+.menuItem {
+  justify-content: flex-start;
+}
+
+.menuItem .icon[data-position='left'] {
+  width: calc(var(--collapsed-navigation-width) - 4 * var(--mantine-spacing-xs));
+  flex-shrink: 0;
+  justify-content: center;
+  margin: 0;
+}
+
+.label {
+  padding-inline-start: var(--mantine-spacing-xs);
+}
+
+.menuItem[data-collapsed] .label {
+  visibility: hidden;
+  flex: 0 0 auto;
+  width: 0;
+  padding-inline-start: 0;
+}
+
+.brand {
+  height: var(--app-shell-header-height);
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  border-bottom: 1px solid var(--app-shell-border-color);
+  white-space: nowrap;
+}
+
+.brand[data-collapsed] {
+  justify-content: center;
+}
+
+.menuItem[data-collapsed] .icon[data-position='right'] {
+  display: none;
+}
diff --git a/src/layouts/BasicLayout.tsx b/src/layouts/BasicLayout.tsx
new file mode 100644
index 0000000..6af8564
--- /dev/null
+++ b/src/layouts/BasicLayout.tsx
@@ -0,0 +1,225 @@
+import { useEffect, useState } from 'react'
+import {
+  AppShell,
+  ActionIcon,
+  Box,
+  Burger,
+  Drawer,
+  Group,
+  NavLink,
+  Stack,
+  Text,
+  Tooltip,
+  rem,
+  useMantineTheme,
+} from '@mantine/core'
+import { useDisclosure, useMediaQuery } from '@mantine/hooks'
+import { CaretLeftIcon, CaretRightIcon } from '@phosphor-icons/react'
+import { NavLink as RouterNavLink, Outlet, useLocation, useMatches } from 'react-router'
+import { pageRoutes } from '../routes.ts'
+import type { PageRoute } from '../routes.ts'
+import classes from './BasicLayout.module.css'
+
+const collapsedNavbarWidth = rem(64)
+
+type NavigationProps = {
+  onNavigate?: () => void
+  collapsed?: boolean
+  routes?: PageRoute[]
+  parentPath?: string
+}
+
+function NavigationItem({
+  route,
+  parentPath,
+  collapsed,
+  onNavigate,
+}: {
+  route: PageRoute
+  parentPath: string
+  collapsed: boolean
+  onNavigate?: () => void
+}) {
+  const matches = useMatches()
+  const active = matches.some((match) => match.id === route.id)
+  const selected = matches.at(-1)?.id === route.id
+  const [opened, setOpened] = useState(active)
+
+  if (!route.handle) return null
+
+  const { title: label, icon: Icon } = route.handle
+  const to = !route.path
+    ? parentPath
+    : route.path.startsWith('/')
+      ? route.path
+      : `${parentPath.replace(/\/$/, '')}/${route.path}`
+  const hasChildren = route.children?.some((child) => child.handle)
+  const sharedProps = {
+    label,
+    noWrap: true,
+    p: 'xs',
+    'aria-label': label,
+    leftSection: <Icon size={20} aria-hidden="true" />,
+    active,
+    'data-collapsed': collapsed || undefined,
+    classNames: {
+      root: classes.menuItem,
+      section: classes.icon,
+      body: classes.label,
+    },
+  }
+
+  return (
+    <Tooltip label={label} position="right" disabled={!collapsed}
+      events={{ hover: true, focus: true, touch: false }}>
+      {hasChildren ? (
+        <NavLink
+          {...sharedProps}
+          component="button"
+          variant={selected ? 'light' : 'subtle'}
+          type="button"
+          opened={opened}
+          onChange={setOpened}
+          childrenOffset={collapsed ? 0 : 'xs'}
+        >
+          <Navigation
+            routes={route.children}
+            parentPath={to}
+            collapsed={collapsed}
+            onNavigate={onNavigate}
+          />
+        </NavLink>
+      ) : (
+        <NavLink
+          {...sharedProps}
+          component={RouterNavLink}
+          to={to}
+          end
+          onClick={onNavigate}
+        />
+      )}
+    </Tooltip>
+  )
+}
+
+function Navigation({
+  onNavigate,
+  collapsed = false,
+  routes = pageRoutes,
+  parentPath = '/',
+}: NavigationProps) {
+  const { key } = useLocation()
+
+  return (
+    <Stack gap="xs" style={{ '--collapsed-navigation-width': collapsedNavbarWidth }}>
+      {routes.map((route) => (
+        <NavigationItem
+          key={`${route.id}:${key}`}
+          route={route}
+          parentPath={parentPath}
+          collapsed={collapsed}
+          onNavigate={onNavigate}
+        />
+      ))}
+    </Stack>
+  )
+}
+
+export function BasicLayout() {
+  const theme = useMantineTheme()
+  const desktop = useMediaQuery(`(min-width: ${theme.breakpoints.sm})`)
+  const [opened, { toggle, close }] = useDisclosure(false)
+  const [sidebarOpened, { toggle: toggleSidebar }] = useDisclosure(true)
+  const { key } = useLocation()
+  const matches = useMatches()
+  const title = matches
+    .map(({ handle }) => (
+      handle && typeof handle === 'object' && 'title' in handle && typeof handle.title === 'string'
+        ? handle.title
+        : undefined
+    ))
+    .findLast((value) => value !== undefined) ?? 'Template React'
+
+  useEffect(() => {
+    close()
+  }, [key, close])
+
+  useEffect(() => {
+    if (desktop) close()
+  }, [desktop, close])
+
+  return (
+    <AppShell
+      layout="alt"
+      header={{ height: 60 }}
+      navbar={{
+        width: sidebarOpened ? 240 : collapsedNavbarWidth,
+        breakpoint: 'sm',
+        collapsed: { mobile: true },
+      }}
+    >
+      <AppShell.Navbar id="desktop-navigation" aria-label="主导航">
+        <Text fw={700} size="lg" px="xs" className={classes.brand}
+          data-collapsed={!sidebarOpened || undefined} aria-label="Template React">
+          {sidebarOpened ? 'Template React' : 'TR'}
+        </Text>
+        <Box p="xs">
+          <Navigation collapsed={!sidebarOpened} />
+        </Box>
+      </AppShell.Navbar>
+
+      <AppShell.Header>
+        <Group h="100%" px="md">
+          <ActionIcon
+            onClick={toggleSidebar}
+            visibleFrom="sm"
+            size="lg"
+            variant="subtle"
+            color="gray"
+            aria-label={sidebarOpened ? '折叠菜单' : '展开菜单'}
+            aria-expanded={sidebarOpened}
+            aria-controls="desktop-navigation"
+          >
+            {sidebarOpened
+              ? <CaretLeftIcon size={20} aria-hidden="true" />
+              : <CaretRightIcon size={20} aria-hidden="true" />}
+          </ActionIcon>
+          <Burger
+            opened={opened}
+            onClick={toggle}
+            hiddenFrom="sm"
+            size="sm"
+            aria-label={opened ? '关闭菜单' : '打开菜单'}
+            aria-expanded={opened}
+            aria-controls="mobile-navigation"
+          />
+          <Text fw={600}>{title}</Text>
+        </Group>
+      </AppShell.Header>
+
+      <AppShell.Main component="div" className={classes.main}>
+        <Box component="main" p="md" className={classes.content}>
+          <Outlet />
+        </Box>
+        <Box component="footer" px="md" py="xs" className={classes.footer}>
+          <Text size="xs" c="dimmed" ta="center">
+            © {new Date().getFullYear()} Template React. 仅供示例使用。
+          </Text>
+        </Box>
+      </AppShell.Main>
+
+      <Drawer
+        opened={opened && !desktop}
+        onClose={close}
+        title="Template React"
+        position="left"
+        size="100%"
+        closeButtonProps={{ 'aria-label': '关闭菜单' }}
+      >
+        <nav id="mobile-navigation" aria-label="移动端主导航">
+          <Navigation onNavigate={close} />
+        </nav>
+      </Drawer>
+    </AppShell>
+  )
+}
diff --git a/src/main.tsx b/src/main.tsx
new file mode 100644
index 0000000..39053ab
--- /dev/null
+++ b/src/main.tsx
@@ -0,0 +1,17 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { RouterProvider } from 'react-router/dom'
+import '@mantine/core/styles.css';
+import { MantineProvider } from '@mantine/core';
+
+import './index.css'
+import { router } from './router.ts'
+import { theme } from './theme.tsx'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <MantineProvider theme={theme}>
+      <RouterProvider router={router} />
+    </MantineProvider>
+  </StrictMode>,
+)
diff --git a/src/router.ts b/src/router.ts
new file mode 100644
index 0000000..32870e2
--- /dev/null
+++ b/src/router.ts
@@ -0,0 +1,11 @@
+import { createBrowserRouter } from 'react-router'
+import { BasicLayout } from './layouts/BasicLayout.tsx'
+import { pageRoutes } from './routes.ts'
+
+export const router = createBrowserRouter([
+  {
+    path: '/',
+    Component: BasicLayout,
+    children: pageRoutes,
+  },
+])
diff --git a/src/routes.ts b/src/routes.ts
new file mode 100644
index 0000000..83f97b6
--- /dev/null
+++ b/src/routes.ts
@@ -0,0 +1,39 @@
+import { HouseIcon, InfoIcon, UserIcon } from '@phosphor-icons/react'
+import type { Icon } from '@phosphor-icons/react'
+import type { RouteObject } from 'react-router'
+import App from './App.tsx'
+import About from './About.tsx'
+import Me from './Me.tsx'
+
+export type PageRoute = RouteObject & {
+  handle?: { title: string; icon: Icon }
+  children?: PageRoute[]
+}
+
+export const pageRoutes = [
+  {
+    id: 'home',
+    index: true,
+    Component: App,
+    handle: { title: '首页', icon: HouseIcon },
+  },
+  {
+    id: 'about',
+    path: '/about',
+    handle: { title: '关于', icon: InfoIcon },
+    children: [
+      {
+        id: 'about-index',
+        index: true,
+        Component: About,
+        handle: { title: '关于概览', icon: InfoIcon },
+      },
+      {
+        id: 'about-me',
+        path: 'me',
+        Component: Me,
+        handle: { title: '关于我', icon: UserIcon },
+      },
+    ],
+  },
+] satisfies PageRoute[]
diff --git a/src/theme.tsx b/src/theme.tsx
new file mode 100644
index 0000000..3f83dd2
--- /dev/null
+++ b/src/theme.tsx
@@ -0,0 +1,5 @@
+import { createTheme } from '@mantine/core';
+
+export const theme = createTheme({
+  defaultRadius: 'xs',
+})
\ No newline at end of file