gitea-themes/README.md

Gitea Theme Dev

用于开发 Gitea 自定义主题样式和模板覆盖的工作区。

技术选型

当前项目使用 Bun + TypeScript token + Lightning CSS + Preview。

样式按 tokens -> primitives -> components -> pages 分层聚合，主题值放在 themes/，模板覆盖放在 templates/。详细规则见 docs/rules.md。

常用命令

bun install
bun run build
bun run build:min
bun run dev
bun run preview
bun run test

构建会生成 dist/theme-github-dev.css 和 dist/theme-github-dev-dark.css，并同步输出到 .gitea/custom/public/assets/css/ 供 Gitea custom 目录使用。Docker 预览当前默认加载 github-dev-dark，便于检查未登录页面 dark 模式。