mirror of
https://github.com/Comfy-Org/ComfyUI_frontend.git
synced 2026-02-03 06:47:33 +00:00
## Summary Tested these changes and confirmed that: 1. Feedback button shows. 2. You can run workflows and switch out models. 3. You can use the mask editor. (thank you @ric-yu for helping me verify). ## Changes A lot, please see commits. Gets us up to date with `main` as of 10-11-2025. --------- Co-authored-by: Simula_r <18093452+simula-r@users.noreply.github.com> Co-authored-by: github-actions <github-actions@github.com> Co-authored-by: snomiao <snomiao@gmail.com> Co-authored-by: Christian Byrne <cbyrne@comfy.org> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: DrJKL <DrJKL@users.noreply.github.com> Co-authored-by: Alexander Brown <drjkl@comfy.org> Co-authored-by: Marwan Ahmed <155799754+marawan206@users.noreply.github.com> Co-authored-by: DrJKL <DrJKL0424@gmail.com> Co-authored-by: Rizumu Ayaka <rizumu@ayaka.moe> Co-authored-by: Comfy Org PR Bot <snomiao+comfy-pr@gmail.com> Co-authored-by: AustinMroz <4284322+AustinMroz@users.noreply.github.com> Co-authored-by: Austin Mroz <austin@comfy.org> Co-authored-by: Johnpaul Chiwetelu <49923152+Myestery@users.noreply.github.com> Co-authored-by: GitHub Action <action@github.com> Co-authored-by: filtered <176114999+webfiltered@users.noreply.github.com> Co-authored-by: Benjamin Lu <benceruleanlu@proton.me> Co-authored-by: Jin Yi <jin12cc@gmail.com> Co-authored-by: Robin Huang <robin.j.huang@gmail.com>
2.3 KiB
2.3 KiB
Repository Guidelines
Project Structure & Module Organization
- Source:
src/(Vue 3 + TypeScript). Key areas:components/,views/,stores/(Pinia),composables/,services/,utils/,assets/,locales/. - Routing/i18n/entry:
src/router.ts,src/i18n.ts,src/main.ts. - Tests: unit/component in
tests-ui/andsrc/components/**/*.{test,spec}.ts; E2E inbrowser_tests/. - Public assets:
public/. Build output:dist/. - Config:
vite.config.mts,vitest.config.ts,playwright.config.ts,eslint.config.ts,.prettierrc.
Build, Test, and Development Commands
pnpm dev: Start Vite dev server.pnpm dev:electron: Dev server with Electron API mocks.pnpm build: Type-check then production build todist/.pnpm preview: Preview the production build locally.pnpm test:unit: Run Vitest unit tests.pnpm test:browser: Run Playwright E2E tests (browser_tests/).pnpm lint/pnpm lint:fix: Lint (ESLint).pnpm format/format:check: Prettier.pnpm typecheck: Vue TSC type checking.
Coding Style & Naming Conventions
- Language: TypeScript, Vue SFCs (
.vue). Indent 2 spaces; single quotes; no semicolons; width 80 (see.prettierrc). - Imports: sorted/grouped by plugin; run
pnpm formatbefore committing. - ESLint: Vue + TS rules; no floating promises; unused imports disallowed; i18n raw text restrictions in templates.
- Naming: Vue components in PascalCase (e.g.,
MenuHamburger.vue); composablesuseXyz.ts; Pinia stores*Store.ts.
Testing Guidelines
- Frameworks: Vitest (unit/component, happy-dom) and Playwright (E2E).
- Test files:
**/*.{test,spec}.{ts,tsx,js}undertests-ui/,src/components/, andsrc/lib/litegraph/test/. - Coverage: text/json/html reporters enabled; aim to cover critical logic and new features.
- Playwright: place tests in
browser_tests/; optional tags like@mobile,@2xare respected by config.
Commit & Pull Request Guidelines
- Commits: Use
[skip ci]for locale-only updates when appropriate. - PRs: Include clear description, linked issues (
- Fixes #123), and screenshots/GIFs for UI changes. - Quality gates:
pnpm lint,pnpm typecheck, and relevant tests must pass. Keep PRs focused and small.
Security & Configuration Tips
- Secrets: Use
.env(see.env_example); do not commit secrets.