Trim the root from 32 to 26 entries by parking metadata that GitHub auto-discovers under .github/ and grouping movable tool configs under a single config/ directory. Files that other tools / IDEs hard-code to the root (tsconfig.json, eslint.config.js, vite.config.mts, vitest.config.ts, .releaserc.js, package.json, pnpm-*, pyproject.toml, __init__.py, conftest.py, CHANGELOG.md, README.md, LICENSE, CLAUDE.md) stay where they were. Moves: CODEOWNERS → .github/CODEOWNERS CONTRIBUTING.md → .github/CONTRIBUTING.md CODE_OF_CONDUCT.md → .github/CODE_OF_CONDUCT.md commitlint.config.js → config/commitlint.config.js postcss.config.js → config/postcss.config.js tailwind.config.js → config/tailwind.config.js Reference updates: - `.husky/commit-msg` — pass --config config/commitlint.config.js - `vite.config.mts` — set `css.postcss` explicitly because Vite no longer auto-discovers the moved postcss config from the root - `config/postcss.config.js` — set Tailwind's `config:` option to `config/tailwind.config.js` for the same reason - `README.md` — link to .github/CONTRIBUTING.md Validation: pnpm typecheck / lint / test / build:both / size, ruff check, pytest -q — all green. Manager bundle hash + size unchanged (tailwind preflight + custom rules still emitted at 79 KB).
1010 B
1010 B
Contributing
Dev environment
Two supported paths:
Recommended: system Python ≥ 3.10 in a venv.
python -m venv .venv
.venv\Scripts\pip install -e ".[dev]"
pnpm install
Zero-install: ComfyUI-Easy-Install embedded Python.
"E:\ComfyUIDev\ComfyUI-Easy-Install\python_embeded\python.exe" -m pip install pytest ruff
pnpm install
Common commands
| Task | Command |
|---|---|
| Build extension | pnpm build:extension |
| Build manager | pnpm build:manager |
| Frontend tests | pnpm test |
| Python tests | pytest |
| Type check | pnpm typecheck |
| Lint | pnpm lint |
| Bundle-size gate | pnpm size |
Commit messages
Conventional Commits, enforced by commitlint. Examples:
feat(engine): add wildcard module handlerfix(widgets): restore chip hover state after re-renderchore: bump vite to 5.4
Pull requests
- Branch from
main. - One logical change per PR.
- All CI checks must pass (Python matrix + frontend + bundle-size gate).