Skip to content

About

Driftlog 博客前台

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

driftlog-web

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

许可证

双重授权:开源部分采用 AGPL-3.0;需要闭源或商用授权时见 商业授权。

About

Driftlog 博客前台

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages