# Gitea Theme Dev

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

## 技术选型

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

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

## 常用命令

```bash
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。