Skip to content

build(deps): upgrade Docusaurus 3.10, React 19, eslint 9 flat config#8

Merged
darioAnongba merged 1 commit into
mainfrom
deps/upgrade-docusaurus
Jun 18, 2026
Merged

build(deps): upgrade Docusaurus 3.10, React 19, eslint 9 flat config#8
darioAnongba merged 1 commit into
mainfrom
deps/upgrade-docusaurus

Conversation

@darioAnongba

Copy link
Copy Markdown
Contributor

Summary

Dependency alignment + upgrade for the docs site (mirrors the dashboard's modernization). Latest versions where the ecosystem allows.

Upgrades

  • Docusaurus (@docusaurus/*) 3.5.2 → 3.10.1
  • React 18 → 19 (Docusaurus 3.10 peer-supports it)
  • TypeScript 5.5 → 5.9 — held below 6 on purpose (typescript-eslint 8 doesn't support TS 6 yet)
  • @easyops-cn/docusaurus-search-local 0.44 → 0.55, @mdx-js/react → 3.1, prism-react-renderer → 2.4, clsx → 2.1, prettier → 3.8
  • Tooling: Yarn 4.4 → 4.17

ESLint: 8 + airbnb → 9 flat config

eslint-config-airbnb / airbnb-typescript don't support eslint 9 and are effectively unmaintained. Replaced with a lean eslint 9 flat config (eslint.config.mjs) on typescript-eslint 8 + react / react-hooks / unused-imports + prettier-disable — consistent with the dashboard. Removed .eslintrc.js and the obsolete .eslintignore (eslint 9 uses the ignores key). The auto-removed React imports are the expected result of the JSX automatic runtime.

Notes

  • Kept .yarnrc.yml minimal (enableScripts is required for core-js build scripts). Stripped the lines the Yarn migration auto-added — npmMinimalAgeGate: 0 and approvedGitRepositories: "**" — to avoid silently weakening supply-chain settings (the repo has no git deps).
  • The remaining react@^18 peer warning comes from search-local's transitive Docusaurus plugin; the build runs the local search index fine.

Verification

yarn install --immutable · yarn build · yarn typecheck · yarn lint · yarn fm:check — all green.

Part of the v0.2.0 docs alignment (#7). Content alignment with the current SwissKnife API/features follows in a separate PR.

Bump @docusaurus/* 3.5.2->3.10.1, React 18->19, TypeScript ->5.9, search-local/mdx/prism/prettier to latest, Yarn ->4.17. Migrate eslint 8 + airbnb to an eslint 9 flat config on typescript-eslint 8; drop unmaintained airbnb configs and the legacy .eslintignore.
@darioAnongba darioAnongba self-assigned this Jun 18, 2026
@darioAnongba darioAnongba merged commit ceccfad into main Jun 18, 2026
1 check passed
@darioAnongba darioAnongba deleted the deps/upgrade-docusaurus branch June 18, 2026 17:34
@darioAnongba darioAnongba mentioned this pull request Jun 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant