# ComfyUI Easy Media ## Tech Stack - **Backend**: Python, using comfyui-nodes-** skills to develop. - **Frontend**: React v19, shadcn/ui + Tailwind CSS v4 for components, Lucide for icons, Bun for package manager and build, Vitest for testing. --- ## Build, Test, and Development Commands ### Adding shadcn/ui components ```bash # From repo root bunx shadcn add ``` ## Build ```bash # Dev build (unminified, outputs to dist/dev) — use during normal development bun run dev # watch mode with hot reload → dist/dev bun run build # one-shot dev build → dist/dev # Release build (minified, outputs to dist/release) — REQUIRED before git commit bun run build:release # production build → dist/release ``` ## Skill Synchronization - **Keep Codex skills in sync** — When changing any skill in this project, overwrite the corresponding Codex skill with the updated project version so both copies remain identical ## Code Style ### Backend - **Reuse utils first** — Before writing new code, check `utils/` for existing utility functions; if none exists, add it there instead of duplicating code - **File naming** — `kebab_case.py` for nodes、utils、modules; `PascalCase.py` for classes - **Type hints** — Use type hints for all public methods and function parameters - **Error handling** — Use `try/except` to explicitly catch exceptions; never swallow exceptions silently ### Frontend - **TypeScript first** — strict mode, no `any` without reason - **File naming** — `PascalCase.tsx` for components, `camelCase` for dir, `kebab-case.ts` for modules - **Import aliases** — use `@/*` for `src/` paths - **React components** — functional only, hooks-based - **Reusable hooks** — When component logic has reusable state/effect behavior, write it directly in `src/hooks` and call it from components instead of duplicating the logic inline - **Test location** — Write test cases separately under `src/tests`; do not colocate test files with components or other source modules - **Never use raw HTML elements** for interactive controls — use shadcn/ui equivalents (`