ComfyUI_frontend/AGENTS.md

ComfyUI Frontend

Vue 3.5+ / TypeScript / Tailwind 4 frontend for ComfyUI. Uses Nx monorepo with pnpm.

Commands

pnpm dev              # Vite dev server
pnpm build            # Type-check + production build
pnpm typecheck        # Vue TSC
pnpm lint             # ESLint
pnpm format           # oxfmt
pnpm test:unit        # Vitest
pnpm test:browser     # Playwright E2E
pnpm knip             # Dead code detection

Key Conventions

See docs/guidance/*.md for file-specific rules. Quick reference:

• Vue: Composition API only, <script setup lang="ts">, reactive props destructuring
• Styling: Tailwind only (no <style> blocks), use cn() for conditional classes
• Types: No any, no as any, fix type issues at the source
• i18n: All strings via vue-i18n, entries in src/locales/en/main.json
• Tests: Colocated *.test.ts files, behavioral coverage

Quality Gates

Before committing: pnpm typecheck && pnpm lint && pnpm format

Agent Workspace

• Planning docs: /temp/plans/
• Scripts: /temp/scripts/
• Summaries: /temp/summaries/
• In-progress work: /temp/in_progress/