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 locale:sync
bun run test
bun run release:package

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

locale 官方基线提交在 options/locale/，项目增量只在 options/locale-overrides/ 维护。构建会合并基线和增量后输出到 .gitea/custom/options/locale/，CI 不依赖外网拉取 locale。

发布

.github/workflows/release.yml 会在非纯文档提交时自动构建并发布当前 package.json 版本。发布前会删除同名 v{version} release/tag，再用当前提交重新创建，适合手动维护版本号后持续覆盖当前版本。

默认使用平台提供的 GITHUB_TOKEN。如果 Gitea Actions 的默认 token 权限不够，可以配置 RELEASE_TOKEN secret。