Adopt ESLint for frontend static analysis

未关闭
#33 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
43/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
停滞
技术栈
eslint, github-actions, react, tauri, typescript

调研方向

Start by reading the current frontend scripts and CLAUDE.md, then inspect .github/workflows/ci.yml and CONTRIBUTING.md to see how checks are run and documented. Add the flat ESLint setup and npm run lint described in the issue, then run it on main and address violations without undocumented suppressions. Done means lint passes locally and CI runs it on every PR.

由索引模型根据 Issue 内容生成。

描述

Context

Today the only frontend static-analysis gate is npx tsc --noEmit (per CLAUDE.md). CodeRabbit also flags this on every PR ("ESLint skipped: no ESLint configuration detected").

tsc catches type errors but misses real classes of bugs in a React + Tauri codebase:

  • React Hooks violations — missing useEffect deps, conditional hooks, stale closures. eslint-plugin-react-hooks's exhaustive-deps is the highest-value rule here and catches actual runtime bugs tsc cannot see.
  • Floating promises — easy to miss in a Tauri app where every IPC call is async. @typescript-eslint/no-floating-promises catches them.
  • Contributor PR floor — raises baseline quality without manual nitpicking in review.

Proposal

Minimal flat-config ESLint setup, additive to existing CI.

Scope:

  • eslint.config.js (flat config)
  • Presets: @eslint/js recommended, typescript-eslint recommended (not recommended-type-checked — too noisy on first run), eslint-plugin-react-hooks, eslint-plugin-react-refresh
  • New script: npm run lint
  • Wire into .github/workflows/ci.yml alongside tsc --noEmit
  • Update CLAUDE.md to reflect ESLint as a gate
  • Update CONTRIBUTING.md to mention the lint step

Explicitly out of scope:

  • Prettier — separate decision, separate PR
  • recommended-type-checked rules — can be enabled later once the codebase is clean against the base ruleset
  • Backend (Rust) — cargo clippy -- -D warnings is already wired

Acceptance criteria

  • npm run lint passes on main
  • CI runs lint on every PR
  • No suppressions added to make the initial pass green that don't have a tracking comment or follow-up issue
  • CLAUDE.md updated

Notes

Expect a non-trivial first-pass cleanup. If the violation count is large, split into:

  1. Land config + CI wiring with whatever minimum suppressions are needed
  2. Follow-up PR(s) to remove suppressions
主要语言
TypeScript
星标
6
派生
1
平均合并
17 分钟
30 天内合并 PR
2

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

openidle-dev/queryden 的其他 Issue

查看 openidle-dev/queryden 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。