Driftlog 的博客前台和管理后台。服务端在 driftlog-core(以 git submodule 的形式放在 core/)。结构参考 Shiro。
apps/blog 博客前台:TanStack Start(SSR)+ boring-ui「低饱桌面」
apps/admin 管理后台:Vite SPA + shadcn/ui,Vercel 控制台风格
core/ submodule → driftlog-core(Eden 客户端、Zod schema、Markdown 管线都从这里来)
e2e/ Playwright
core/ 里的包直接列在本仓库的 Bun workspaces 里,所以 Eden Treaty 的类型直接来自服务端源码,改了接口两边一起类型检查。
git submodule update --init
bun install
cp apps/blog/.env.example apps/blog/.env
cp apps/admin/.env.example apps/admin/.env
cp core/.env.example core/apps/server/.env
bun --filter @driftlog/db migrate # 第一次跑
bun run dev # API :3900 · 博客 :5173 · 后台 :5174,一个终端里一起起bun run dev 跑的是 core/ 这个 submodule 里的 API。要改服务端,就直接在 web/core 里改、提交、推送(它本身是个完整的 git 仓库)。只想单独起某一个:bun run dev:api / dev:blog / dev:admin。
bun run typecheck # tsgo
bun run lint # oxlint
bun run fmt # oxfmt
E2E_EMAIL=… E2E_PASSWORD=… bun run test # Playwright;不给站长账号就跳过后台用例- 设计:boring-ui 的 tokens.css / desktop.css 原样放在
apps/blog/src/styles,桌面组件在components/boring,换过皮的 shadcn 在components/ui。文章页是「阅读」场景,左边文件夹列就是目录;分类页的文件夹就是分类。 - 数据:TanStack Router loader + TanStack Query(SSR 时预取、客户端复用)。
- SEO:每页 head、JSON-LD、
/sitemap.xml、/feed.xml(RSS)、/atom.xml、/og/:type/:slug(@cf-wasm/og,像素字用public/fonts里的 Fusion Pixel TTF,SIL OFL 1.1)。 - 实时:WebSocket 收在线人数、新评论、新文章。
- 搜索:⌘K 面板(Radix Dialog + cmdk),后端是 Meilisearch。
- 动效:Motion(新评论出现)+ CSS 动画(路由切换),曲线都是 tokens 里那四条。
- 部署:Cloudflare Workers。构建产物由 Nitro 的
cloudflare_module预设生成,apps/blog/wrangler.json合并进去;VITE_SITE_URL、VITE_API_URL写在apps/blog/.env.production.local,然后bun --filter @driftlog/blog deploy。
- 概览(Recharts)、文章 / 手记 / 页面(TanStack Table v9)、编辑器、分类(dnd-kit 拖拽 + 上移 / 下移按钮)、评论审核、文件(孤儿文件清理)、设置(备份、Passkey)。
- 编辑器:CodeMirror 6;宽屏三栏「源码 | 预览 | 属性」,中屏两栏,预览用和博客同一条 Markdown 管线。粘贴 / 拖进图片直接上传。⌘S 保存。
- 登录:Better Auth(邮箱密码、Passkey、GitHub / Google)。
- 部署:Vercel 静态托管,
vercel.json把所有路径改写到index.html。
git clone --recurse-submodules https://github.com/wling-art/driftlog-web.git