Files
ragusaitweb/.jules/bolt.md

1.2 KiB

2024-05-22 - Missing Scripts and Environment

Learning: The project lacks lint script in package.json. Running pnpm lint might invoke system tools (like Android Lint?) instead of failing or doing nothing useful. Always check package.json scripts first. Action: Use specific commands like pnpm exec tsc --noEmit or npx vitest as discovered/documented, rather than assuming standard scripts exist.

2025-01-26 - Missing Node Modules

Learning: The environment might lack node_modules completely, preventing npx vitest or pnpm exec tsc from running even if dependencies are listed in package.json. Network restrictions may prevent pnpm install. Action: When node_modules is missing and cannot be installed, rely on static analysis, careful code review, and verifying file contents manually. Do not assume tests can run.

2024-05-22 - High-Frequency State Isolation

Learning: High-frequency state updates (like typing effects) in large parent components (Hero) trigger massive unnecessary re-renders of expensive sub-trees (GradientBlinds, Button). Action: Isolate high-frequency state into small, leaf-node components (e.g., TypedText) and wrap them in React.memo if necessary, keeping the heavy parent static.