ai-qakit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (875) hide show
  1. package/README.md +240 -0
  2. package/dist/cli.d.ts +2 -0
  3. package/dist/cli.js +208 -0
  4. package/dist/commands/clean.d.ts +10 -0
  5. package/dist/commands/clean.js +53 -0
  6. package/dist/commands/init.d.ts +20 -0
  7. package/dist/commands/init.js +195 -0
  8. package/dist/index.d.ts +3 -0
  9. package/dist/index.js +2 -0
  10. package/dist/utils/file-operations.d.ts +18 -0
  11. package/dist/utils/file-operations.js +79 -0
  12. package/dist/utils/git.d.ts +4 -0
  13. package/dist/utils/git.js +27 -0
  14. package/dist/utils/index.d.ts +5 -0
  15. package/dist/utils/index.js +5 -0
  16. package/dist/utils/logger.d.ts +22 -0
  17. package/dist/utils/logger.js +23 -0
  18. package/dist/utils/manifest.d.ts +37 -0
  19. package/dist/utils/manifest.js +120 -0
  20. package/dist/utils/package.d.ts +19 -0
  21. package/dist/utils/package.js +47 -0
  22. package/package.json +61 -0
  23. package/templates/.antigravity/agents/qa-agents.yaml +50 -0
  24. package/templates/.antigravity/prompts/qa-prompts.md +56 -0
  25. package/templates/.claude/.scoutignore +33 -0
  26. package/templates/.claude/CHANGELOG.md +587 -0
  27. package/templates/.claude/CLAUDE.md +335 -0
  28. package/templates/.claude/README.md +428 -0
  29. package/templates/.claude/TROUBLESHOOTING.md +789 -0
  30. package/templates/.claude/agents/accessibility-tester.md +29 -0
  31. package/templates/.claude/agents/api-tester.md +29 -0
  32. package/templates/.claude/agents/automation-engineer.md +30 -0
  33. package/templates/.claude/agents/brainstormer.md +123 -0
  34. package/templates/.claude/agents/bug-hunter.md +30 -0
  35. package/templates/.claude/agents/claude-optimizer.md +221 -0
  36. package/templates/.claude/agents/code-reviewer.md +176 -0
  37. package/templates/.claude/agents/code-simplifier.md +103 -0
  38. package/templates/.claude/agents/coder.md +163 -0
  39. package/templates/.claude/agents/context-manager.md +110 -0
  40. package/templates/.claude/agents/cunningham.md +134 -0
  41. package/templates/.claude/agents/database-admin.md +112 -0
  42. package/templates/.claude/agents/debugger.md +156 -0
  43. package/templates/.claude/agents/docs-manager.md +181 -0
  44. package/templates/.claude/agents/e2e-tester.md +30 -0
  45. package/templates/.claude/agents/performance-engineer.md +48 -0
  46. package/templates/.claude/agents/performance-tester.md +29 -0
  47. package/templates/.claude/agents/planner.md +72 -0
  48. package/templates/.claude/agents/project-manager.md +152 -0
  49. package/templates/.claude/agents/qa-scout.md +29 -0
  50. package/templates/.claude/agents/quality-engineer.md +48 -0
  51. package/templates/.claude/agents/readme-writer.md +67 -0
  52. package/templates/.claude/agents/researcher.md +57 -0
  53. package/templates/.claude/agents/scout.md +125 -0
  54. package/templates/.claude/agents/security-agent.md +564 -0
  55. package/templates/.claude/agents/security-tester.md +29 -0
  56. package/templates/.claude/agents/storage-path-convention.md +102 -0
  57. package/templates/.claude/agents/tattletale-reporter.md +77 -0
  58. package/templates/.claude/agents/test-architect.md +32 -0
  59. package/templates/.claude/agents/test-reviewer.md +29 -0
  60. package/templates/.claude/agents/tester.md +286 -0
  61. package/templates/.claude/agents/typescript-pro.md +280 -0
  62. package/templates/.claude/agents/ui-ux-designer.md +256 -0
  63. package/templates/.claude/commands/devkit/analyze.md +92 -0
  64. package/templates/.claude/commands/devkit/ask.md +269 -0
  65. package/templates/.claude/commands/devkit/backend/create-api.md +220 -0
  66. package/templates/.claude/commands/devkit/backend/create-migration.md +130 -0
  67. package/templates/.claude/commands/devkit/backend/create-schema.md +158 -0
  68. package/templates/.claude/commands/devkit/backend/design-graphql-api.md +302 -0
  69. package/templates/.claude/commands/devkit/backend/design-rest-api.md +192 -0
  70. package/templates/.claude/commands/devkit/config/bootstrap.md +137 -0
  71. package/templates/.claude/commands/devkit/config/init-backend.md +233 -0
  72. package/templates/.claude/commands/devkit/config/init-frontend.md +911 -0
  73. package/templates/.claude/commands/devkit/create-test.md +165 -0
  74. package/templates/.claude/commands/devkit/debug.md +481 -0
  75. package/templates/.claude/commands/devkit/docs/capture-knowledge.md +424 -0
  76. package/templates/.claude/commands/devkit/docs/init.md +203 -0
  77. package/templates/.claude/commands/devkit/docs/summarize.md +33 -0
  78. package/templates/.claude/commands/devkit/docs/update.md +207 -0
  79. package/templates/.claude/commands/devkit/fix/fast.md +22 -0
  80. package/templates/.claude/commands/devkit/fix/hard.md +44 -0
  81. package/templates/.claude/commands/devkit/fix.md +16 -0
  82. package/templates/.claude/commands/devkit/frontend/create-api-integration.md +507 -0
  83. package/templates/.claude/commands/devkit/frontend/create-component.md +461 -0
  84. package/templates/.claude/commands/devkit/frontend/create-form.md +804 -0
  85. package/templates/.claude/commands/devkit/frontend/create-page.md +484 -0
  86. package/templates/.claude/commands/devkit/frontend/create-storybook.md +899 -0
  87. package/templates/.claude/commands/devkit/frontend/create-table.md +1035 -0
  88. package/templates/.claude/commands/devkit/help.md +148 -0
  89. package/templates/.claude/commands/devkit/refactor.md +510 -0
  90. package/templates/.claude/commands/devkit/research.md +394 -0
  91. package/templates/.claude/commands/devkit/review/code.md +349 -0
  92. package/templates/.claude/commands/devkit/review/codebase.md +51 -0
  93. package/templates/.claude/commands/devkit/scout.md +312 -0
  94. package/templates/.claude/commands/devkit/skill/add.md +29 -0
  95. package/templates/.claude/commands/devkit/skill/create.md +22 -0
  96. package/templates/.claude/commands/devkit/skill/optimize.md +34 -0
  97. package/templates/.claude/commands/devkit/solve.md +364 -0
  98. package/templates/.claude/commands/devkit/spec/brainstorm.md +309 -0
  99. package/templates/.claude/commands/devkit/spec/capture-requirement.md +202 -0
  100. package/templates/.claude/commands/devkit/spec/cook.md +157 -0
  101. package/templates/.claude/commands/devkit/spec/deep-capture-requirement.md +393 -0
  102. package/templates/.claude/commands/devkit/spec/implement.md +350 -0
  103. package/templates/.claude/commands/devkit/spec/plan.md +269 -0
  104. package/templates/.claude/commands/devkit/spec/task.md +156 -0
  105. package/templates/.claude/commands/devkit/spec/test.md +259 -0
  106. package/templates/.claude/commands/devkit/spec/update-plan.md +263 -0
  107. package/templates/.claude/commands/devkit/spec/update-requirement.md +239 -0
  108. package/templates/.claude/commands/devkit/spec-lite/do.md +280 -0
  109. package/templates/.claude/commands/devkit/spec-lite/plan.md +236 -0
  110. package/templates/.claude/commands/devkit/spec-lite/task.md +141 -0
  111. package/templates/.claude/commands/devkit/spec-lite/test.md +171 -0
  112. package/templates/.claude/commands/devkit/spec-lite/update-plan.md +154 -0
  113. package/templates/.claude/commands/qakit/a11y/audit.md +38 -0
  114. package/templates/.claude/commands/qakit/a11y/fix.md +22 -0
  115. package/templates/.claude/commands/qakit/analyze/full.md +459 -0
  116. package/templates/.claude/commands/qakit/analyze/quick.md +84 -0
  117. package/templates/.claude/commands/qakit/api/analyze.md +34 -0
  118. package/templates/.claude/commands/qakit/api/contract.md +22 -0
  119. package/templates/.claude/commands/qakit/api/generate.md +20 -0
  120. package/templates/.claude/commands/qakit/api/run.md +16 -0
  121. package/templates/.claude/commands/qakit/ask.md +57 -0
  122. package/templates/.claude/commands/qakit/automation/fix-flaky.md +233 -0
  123. package/templates/.claude/commands/qakit/automation/health-check.md +192 -0
  124. package/templates/.claude/commands/qakit/automation/maintenance.md +311 -0
  125. package/templates/.claude/commands/qakit/automation/scaffold-playwright.md +689 -0
  126. package/templates/.claude/commands/qakit/automation/scaffold-webdriverio.md +802 -0
  127. package/templates/.claude/commands/qakit/automation/scaffold.md +447 -0
  128. package/templates/.claude/commands/qakit/automation/update-deps.md +219 -0
  129. package/templates/.claude/commands/qakit/bug/investigate.md +96 -0
  130. package/templates/.claude/commands/qakit/bug/report.md +147 -0
  131. package/templates/.claude/commands/qakit/bug/reproduce.md +101 -0
  132. package/templates/.claude/commands/qakit/bug/triage.md +101 -0
  133. package/templates/.claude/commands/qakit/bug/verify.md +106 -0
  134. package/templates/.claude/commands/qakit/config/init-qa.md +107 -0
  135. package/templates/.claude/commands/qakit/confluence/fetch.md +192 -0
  136. package/templates/.claude/commands/qakit/confluence/search.md +201 -0
  137. package/templates/.claude/commands/qakit/docs/capture-test-knowledge.md +451 -0
  138. package/templates/.claude/commands/qakit/docs/update-changelog.md +207 -0
  139. package/templates/.claude/commands/qakit/docs/update-readme.md +296 -0
  140. package/templates/.claude/commands/qakit/e2e/generate.md +18 -0
  141. package/templates/.claude/commands/qakit/e2e/page-object.md +37 -0
  142. package/templates/.claude/commands/qakit/e2e/run.md +17 -0
  143. package/templates/.claude/commands/qakit/e2e/scenario.md +20 -0
  144. package/templates/.claude/commands/qakit/feature/create.md +178 -0
  145. package/templates/.claude/commands/qakit/feature/enrich-api.md +352 -0
  146. package/templates/.claude/commands/qakit/feature/enrich-tests.md +243 -0
  147. package/templates/.claude/commands/qakit/feature/enrich-ui.md +217 -0
  148. package/templates/.claude/commands/qakit/feature/enrich.md +246 -0
  149. package/templates/.claude/commands/qakit/feature/from-jira.md +184 -0
  150. package/templates/.claude/commands/qakit/feature/update.md +136 -0
  151. package/templates/.claude/commands/qakit/help.md +98 -0
  152. package/templates/.claude/commands/qakit/jira/analyze.md +329 -0
  153. package/templates/.claude/commands/qakit/jira/create-tests.md +319 -0
  154. package/templates/.claude/commands/qakit/kb/add-design.md +258 -0
  155. package/templates/.claude/commands/qakit/kb/capture.md +325 -0
  156. package/templates/.claude/commands/qakit/kb/clean.md +157 -0
  157. package/templates/.claude/commands/qakit/kb/dedupe.md +281 -0
  158. package/templates/.claude/commands/qakit/kb/init.md +234 -0
  159. package/templates/.claude/commands/qakit/kb/link.md +124 -0
  160. package/templates/.claude/commands/qakit/kb/list.md +185 -0
  161. package/templates/.claude/commands/qakit/kb/resolve.md +234 -0
  162. package/templates/.claude/commands/qakit/kb/search.md +202 -0
  163. package/templates/.claude/commands/qakit/kb/sync-confluence.md +474 -0
  164. package/templates/.claude/commands/qakit/metrics/coverage.md +46 -0
  165. package/templates/.claude/commands/qakit/metrics/dashboard.md +62 -0
  166. package/templates/.claude/commands/qakit/metrics/trends.md +42 -0
  167. package/templates/.claude/commands/qakit/perf/analyze.md +31 -0
  168. package/templates/.claude/commands/qakit/perf/plan.md +18 -0
  169. package/templates/.claude/commands/qakit/perf/run.md +17 -0
  170. package/templates/.claude/commands/qakit/perf/script.md +38 -0
  171. package/templates/.claude/commands/qakit/rca/analyze.md +166 -0
  172. package/templates/.claude/commands/qakit/regression/analyze.md +36 -0
  173. package/templates/.claude/commands/qakit/regression/report.md +30 -0
  174. package/templates/.claude/commands/qakit/regression/run.md +17 -0
  175. package/templates/.claude/commands/qakit/regression/select.md +34 -0
  176. package/templates/.claude/commands/qakit/research/deep.md +328 -0
  177. package/templates/.claude/commands/qakit/review/coverage.md +116 -0
  178. package/templates/.claude/commands/qakit/review/quality-gate.md +126 -0
  179. package/templates/.claude/commands/qakit/review/test-code.md +320 -0
  180. package/templates/.claude/commands/qakit/review/test-review.md +109 -0
  181. package/templates/.claude/commands/qakit/scout.md +195 -0
  182. package/templates/.claude/commands/qakit/setup/confluence.md +140 -0
  183. package/templates/.claude/commands/qakit/setup/jira.md +154 -0
  184. package/templates/.claude/commands/qakit/spec/analyze.md +46 -0
  185. package/templates/.claude/commands/qakit/spec/cook.md +344 -0
  186. package/templates/.claude/commands/qakit/spec/execute.md +38 -0
  187. package/templates/.claude/commands/qakit/spec/plan.md +46 -0
  188. package/templates/.claude/commands/qakit/spec/report.md +40 -0
  189. package/templates/.claude/commands/qakit/spec/task.md +40 -0
  190. package/templates/.claude/commands/qakit/test/create-test-case.md +151 -0
  191. package/templates/.claude/commands/qakit/test/create-test-suite.md +84 -0
  192. package/templates/.claude/commands/qakit/test/generate-api-tests.md +82 -0
  193. package/templates/.claude/commands/qakit/test/generate-data.md +114 -0
  194. package/templates/.claude/commands/qakit/test/generate-e2e.md +99 -0
  195. package/templates/.claude/commands/qakit/test/generate-ui-tests.md +97 -0
  196. package/templates/.claude/commands/qakit/testmo/report.md +22 -0
  197. package/templates/.claude/commands/qakit/testmo/sync.md +31 -0
  198. package/templates/.claude/doc-templates/bug-report-template.md +247 -0
  199. package/templates/.claude/doc-templates/code-standards.md +486 -0
  200. package/templates/.claude/doc-templates/codebase-summary.md +426 -0
  201. package/templates/.claude/doc-templates/development-rules.md +553 -0
  202. package/templates/.claude/doc-templates/feature-spec-template.md +167 -0
  203. package/templates/.claude/doc-templates/performance-report-template.md +49 -0
  204. package/templates/.claude/doc-templates/project-overview-pdr.md +494 -0
  205. package/templates/.claude/doc-templates/quality-report-template.md +44 -0
  206. package/templates/.claude/doc-templates/regression-report-template.md +41 -0
  207. package/templates/.claude/doc-templates/system-architecture.md +615 -0
  208. package/templates/.claude/doc-templates/technical-documents.md +127 -0
  209. package/templates/.claude/doc-templates/test-case-template.md +198 -0
  210. package/templates/.claude/doc-templates/test-plan-template.md +366 -0
  211. package/templates/.claude/doc-templates/test-summary-report.md +401 -0
  212. package/templates/.claude/hooks/dev-rules-reminder.cjs +101 -0
  213. package/templates/.claude/hooks/dev-rules-reminder.js +96 -0
  214. package/templates/.claude/hooks/executable_force-agent-skills-eval.sh +38 -0
  215. package/templates/.claude/hooks/scout-block/scout-block.ps1 +92 -0
  216. package/templates/.claude/hooks/scout-block/scout-block.sh +119 -0
  217. package/templates/.claude/hooks/scout-block.cjs +100 -0
  218. package/templates/.claude/hooks/scout-block.js +104 -0
  219. package/templates/.claude/repomix.config.json +34 -0
  220. package/templates/.claude/rules/01-core-principles.md +81 -0
  221. package/templates/.claude/rules/02-naming-and-constants.md +115 -0
  222. package/templates/.claude/rules/03-function-design.md +167 -0
  223. package/templates/.claude/rules/04-error-handling.md +83 -0
  224. package/templates/.claude/rules/05-testing.md +86 -0
  225. package/templates/.claude/rules/06-code-quality.md +107 -0
  226. package/templates/.claude/rules/07-architecture.md +105 -0
  227. package/templates/.claude/rules/08-performance-security.md +93 -0
  228. package/templates/.claude/rules/index.md +77 -0
  229. package/templates/.claude/scripts/README.md +153 -0
  230. package/templates/.claude/scripts/commands_data.yaml +336 -0
  231. package/templates/.claude/scripts/generate_catalogs.py +163 -0
  232. package/templates/.claude/scripts/helper.py +723 -0
  233. package/templates/.claude/scripts/scan_commands.py +101 -0
  234. package/templates/.claude/scripts/scan_skills.py +187 -0
  235. package/templates/.claude/scripts/skills_data.yaml +348 -0
  236. package/templates/.claude/settings.json +54 -0
  237. package/templates/.claude/settings.local.README.md +650 -0
  238. package/templates/.claude/settings.local.json +41 -0
  239. package/templates/.claude/setup/dependencies/setup-claude-mem.ps1 +534 -0
  240. package/templates/.claude/setup/dependencies/setup-claude-mem.sh +477 -0
  241. package/templates/.claude/setup/dependencies/setup-mcp-servers.ps1 +562 -0
  242. package/templates/.claude/setup/dependencies/setup-mcp-servers.sh +511 -0
  243. package/templates/.claude/setup/jira-env.example.sh +22 -0
  244. package/templates/.claude/setup/setup.ps1 +240 -0
  245. package/templates/.claude/setup/setup.sh +222 -0
  246. package/templates/.claude/skills/accessibility-testing/SKILL.md +34 -0
  247. package/templates/.claude/skills/aesthetic/SKILL.md +121 -0
  248. package/templates/.claude/skills/aesthetic/assets/design-guideline-template.md +163 -0
  249. package/templates/.claude/skills/aesthetic/assets/design-story-template.md +135 -0
  250. package/templates/.claude/skills/aesthetic/references/design-principles.md +62 -0
  251. package/templates/.claude/skills/aesthetic/references/design-resources.md +75 -0
  252. package/templates/.claude/skills/aesthetic/references/micro-interactions.md +53 -0
  253. package/templates/.claude/skills/aesthetic/references/storytelling-design.md +50 -0
  254. package/templates/.claude/skills/aesthetic/skill-creator/LICENSE.txt +202 -0
  255. package/templates/.claude/skills/aesthetic/skill-creator/SKILL.md +266 -0
  256. package/templates/.claude/skills/aesthetic/skill-creator/scripts/init_skill.py +303 -0
  257. package/templates/.claude/skills/aesthetic/skill-creator/scripts/package_skill.py +110 -0
  258. package/templates/.claude/skills/aesthetic/skill-creator/scripts/quick_validate.py +65 -0
  259. package/templates/.claude/skills/agent_skills_spec.md +51 -0
  260. package/templates/.claude/skills/ai-multimodal/.env.example +185 -0
  261. package/templates/.claude/skills/ai-multimodal/SKILL.md +69 -0
  262. package/templates/.claude/skills/ai-multimodal/references/audio-processing.md +386 -0
  263. package/templates/.claude/skills/ai-multimodal/references/image-generation.md +722 -0
  264. package/templates/.claude/skills/ai-multimodal/references/video-analysis.md +515 -0
  265. package/templates/.claude/skills/ai-multimodal/references/video-generation.md +457 -0
  266. package/templates/.claude/skills/ai-multimodal/references/vision-understanding.md +492 -0
  267. package/templates/.claude/skills/ai-multimodal/scripts/check_setup.py +299 -0
  268. package/templates/.claude/skills/ai-multimodal/scripts/document_converter.py +395 -0
  269. package/templates/.claude/skills/ai-multimodal/scripts/gemini_batch_process.py +1067 -0
  270. package/templates/.claude/skills/ai-multimodal/scripts/media_optimizer.py +506 -0
  271. package/templates/.claude/skills/ai-multimodal/scripts/requirements.txt +26 -0
  272. package/templates/.claude/skills/ai-multimodal/scripts/tests/requirements.txt +20 -0
  273. package/templates/.claude/skills/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
  274. package/templates/.claude/skills/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
  275. package/templates/.claude/skills/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
  276. package/templates/.claude/skills/api-design-principles/SKILL.md +527 -0
  277. package/templates/.claude/skills/api-design-principles/assets/api-design-checklist.md +136 -0
  278. package/templates/.claude/skills/api-design-principles/assets/rest-api-template.py +165 -0
  279. package/templates/.claude/skills/api-design-principles/references/graphql-schema-design.md +566 -0
  280. package/templates/.claude/skills/api-design-principles/references/rest-best-practices.md +385 -0
  281. package/templates/.claude/skills/api-testing/SKILL.md +24 -0
  282. package/templates/.claude/skills/backend-development/SKILL.md +95 -0
  283. package/templates/.claude/skills/backend-development/references/backend-api-design.md +495 -0
  284. package/templates/.claude/skills/backend-development/references/backend-architecture.md +454 -0
  285. package/templates/.claude/skills/backend-development/references/backend-code-quality.md +659 -0
  286. package/templates/.claude/skills/backend-development/references/backend-debugging.md +904 -0
  287. package/templates/.claude/skills/backend-development/references/backend-devops.md +494 -0
  288. package/templates/.claude/skills/backend-development/references/backend-mindset.md +387 -0
  289. package/templates/.claude/skills/backend-development/references/backend-performance.md +397 -0
  290. package/templates/.claude/skills/backend-development/references/backend-security.md +290 -0
  291. package/templates/.claude/skills/backend-development/references/backend-technologies.md +256 -0
  292. package/templates/.claude/skills/backend-development/references/backend-testing.md +429 -0
  293. package/templates/.claude/skills/bug-investigation/SKILL.md +24 -0
  294. package/templates/.claude/skills/chrome-devtools/SKILL.md +472 -0
  295. package/templates/.claude/skills/chrome-devtools/references/cdp-domains.md +694 -0
  296. package/templates/.claude/skills/chrome-devtools/references/performance-guide.md +940 -0
  297. package/templates/.claude/skills/chrome-devtools/references/puppeteer-reference.md +953 -0
  298. package/templates/.claude/skills/chrome-devtools/scripts/README.md +228 -0
  299. package/templates/.claude/skills/chrome-devtools/scripts/__tests__/selector.test.js +210 -0
  300. package/templates/.claude/skills/chrome-devtools/scripts/aria-snapshot.js +362 -0
  301. package/templates/.claude/skills/chrome-devtools/scripts/click.js +83 -0
  302. package/templates/.claude/skills/chrome-devtools/scripts/console.js +79 -0
  303. package/templates/.claude/skills/chrome-devtools/scripts/evaluate.js +53 -0
  304. package/templates/.claude/skills/chrome-devtools/scripts/fill.js +76 -0
  305. package/templates/.claude/skills/chrome-devtools/scripts/install-deps.sh +181 -0
  306. package/templates/.claude/skills/chrome-devtools/scripts/install.sh +83 -0
  307. package/templates/.claude/skills/chrome-devtools/scripts/lib/browser.js +217 -0
  308. package/templates/.claude/skills/chrome-devtools/scripts/lib/selector.js +178 -0
  309. package/templates/.claude/skills/chrome-devtools/scripts/navigate.js +54 -0
  310. package/templates/.claude/skills/chrome-devtools/scripts/network.js +106 -0
  311. package/templates/.claude/skills/chrome-devtools/scripts/package.json +16 -0
  312. package/templates/.claude/skills/chrome-devtools/scripts/performance.js +149 -0
  313. package/templates/.claude/skills/chrome-devtools/scripts/screenshot.js +194 -0
  314. package/templates/.claude/skills/chrome-devtools/scripts/select-ref.js +131 -0
  315. package/templates/.claude/skills/chrome-devtools/scripts/snapshot.js +135 -0
  316. package/templates/.claude/skills/claude-code-analyzer/SKILL.md +299 -0
  317. package/templates/.claude/skills/claude-code-analyzer/references/best-practices.md +290 -0
  318. package/templates/.claude/skills/claude-code-analyzer/scripts/analyze-claude-md.sh +239 -0
  319. package/templates/.claude/skills/claude-code-analyzer/scripts/analyze.sh +274 -0
  320. package/templates/.claude/skills/claude-code-analyzer/scripts/fetch-features.sh +69 -0
  321. package/templates/.claude/skills/claude-code-analyzer/scripts/github-discovery.sh +178 -0
  322. package/templates/.claude/skills/code-review/SKILL.md +155 -0
  323. package/templates/.claude/skills/code-review/references/code-review-reception.md +209 -0
  324. package/templates/.claude/skills/code-review/references/human-code-review-practices.md +370 -0
  325. package/templates/.claude/skills/code-review/references/requesting-code-review.md +105 -0
  326. package/templates/.claude/skills/code-review/references/verification-before-completion.md +139 -0
  327. package/templates/.claude/skills/command-development/README.md +272 -0
  328. package/templates/.claude/skills/command-development/SKILL.md +834 -0
  329. package/templates/.claude/skills/command-development/examples/plugin-commands.md +557 -0
  330. package/templates/.claude/skills/command-development/examples/simple-commands.md +504 -0
  331. package/templates/.claude/skills/command-development/references/advanced-workflows.md +722 -0
  332. package/templates/.claude/skills/command-development/references/documentation-patterns.md +739 -0
  333. package/templates/.claude/skills/command-development/references/frontmatter-reference.md +463 -0
  334. package/templates/.claude/skills/command-development/references/interactive-commands.md +920 -0
  335. package/templates/.claude/skills/command-development/references/marketplace-considerations.md +904 -0
  336. package/templates/.claude/skills/command-development/references/plugin-features-reference.md +609 -0
  337. package/templates/.claude/skills/command-development/references/testing-strategies.md +702 -0
  338. package/templates/.claude/skills/confluence-integration/confluence-integration.md +260 -0
  339. package/templates/.claude/skills/databases/SKILL.md +232 -0
  340. package/templates/.claude/skills/databases/references/mongodb-aggregation.md +447 -0
  341. package/templates/.claude/skills/databases/references/mongodb-atlas.md +465 -0
  342. package/templates/.claude/skills/databases/references/mongodb-crud.md +408 -0
  343. package/templates/.claude/skills/databases/references/mongodb-indexing.md +442 -0
  344. package/templates/.claude/skills/databases/references/postgresql-administration.md +594 -0
  345. package/templates/.claude/skills/databases/references/postgresql-performance.md +527 -0
  346. package/templates/.claude/skills/databases/references/postgresql-psql-cli.md +467 -0
  347. package/templates/.claude/skills/databases/references/postgresql-queries.md +475 -0
  348. package/templates/.claude/skills/databases/scripts/db_backup.py +502 -0
  349. package/templates/.claude/skills/databases/scripts/db_migrate.py +414 -0
  350. package/templates/.claude/skills/databases/scripts/db_performance_check.py +444 -0
  351. package/templates/.claude/skills/databases/scripts/dot_coverage +0 -0
  352. package/templates/.claude/skills/databases/scripts/requirements.txt +20 -0
  353. package/templates/.claude/skills/databases/scripts/tests/coverage-db.json +1 -0
  354. package/templates/.claude/skills/databases/scripts/tests/requirements.txt +4 -0
  355. package/templates/.claude/skills/databases/scripts/tests/test_db_backup.py +340 -0
  356. package/templates/.claude/skills/databases/scripts/tests/test_db_migrate.py +277 -0
  357. package/templates/.claude/skills/databases/scripts/tests/test_db_performance_check.py +370 -0
  358. package/templates/.claude/skills/debugging/SKILL.md +84 -0
  359. package/templates/.claude/skills/debugging/references/defense-in-depth.md +124 -0
  360. package/templates/.claude/skills/debugging/references/root-cause-tracing.md +122 -0
  361. package/templates/.claude/skills/debugging/references/systematic-debugging.md +102 -0
  362. package/templates/.claude/skills/debugging/references/verification.md +123 -0
  363. package/templates/.claude/skills/debugging/scripts/find-polluter.sh +63 -0
  364. package/templates/.claude/skills/debugging/scripts/find-polluter.test.md +102 -0
  365. package/templates/.claude/skills/docs-discovery/COMPARISON.md +313 -0
  366. package/templates/.claude/skills/docs-discovery/README.md +53 -0
  367. package/templates/.claude/skills/docs-discovery/REFACTORING_SUMMARY.md +144 -0
  368. package/templates/.claude/skills/docs-discovery/SKILL.md +64 -0
  369. package/templates/.claude/skills/docs-discovery/archive/dot_env.example +15 -0
  370. package/templates/.claude/skills/docs-discovery/archive/package.json +24 -0
  371. package/templates/.claude/skills/docs-discovery/archive/references/advanced.md +79 -0
  372. package/templates/.claude/skills/docs-discovery/archive/references/context7-patterns.md +68 -0
  373. package/templates/.claude/skills/docs-discovery/archive/references/errors.md +68 -0
  374. package/templates/.claude/skills/docs-discovery/archive/scripts/analyze-llms-txt.js +211 -0
  375. package/templates/.claude/skills/docs-discovery/archive/scripts/detect-topic.js +172 -0
  376. package/templates/.claude/skills/docs-discovery/archive/scripts/fetch-docs.js +213 -0
  377. package/templates/.claude/skills/docs-discovery/archive/scripts/tests/run-tests.js +72 -0
  378. package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-analyze-llms.js +119 -0
  379. package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-detect-topic.js +112 -0
  380. package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-fetch-docs.js +84 -0
  381. package/templates/.claude/skills/docs-discovery/archive/scripts/utils/env-loader.js +94 -0
  382. package/templates/.claude/skills/docs-discovery/archive/workflows/library-search.md +87 -0
  383. package/templates/.claude/skills/docs-discovery/archive/workflows/repo-analysis.md +91 -0
  384. package/templates/.claude/skills/docs-discovery/archive/workflows/topic-search.md +77 -0
  385. package/templates/.claude/skills/docs-seeker/.env.example +15 -0
  386. package/templates/.claude/skills/docs-seeker/SKILL.md +97 -0
  387. package/templates/.claude/skills/docs-seeker/package.json +24 -0
  388. package/templates/.claude/skills/docs-seeker/references/advanced.md +79 -0
  389. package/templates/.claude/skills/docs-seeker/references/context7-patterns.md +68 -0
  390. package/templates/.claude/skills/docs-seeker/references/errors.md +68 -0
  391. package/templates/.claude/skills/docs-seeker/scripts/analyze-llms-txt.js +211 -0
  392. package/templates/.claude/skills/docs-seeker/scripts/detect-topic.js +172 -0
  393. package/templates/.claude/skills/docs-seeker/scripts/fetch-docs.js +213 -0
  394. package/templates/.claude/skills/docs-seeker/scripts/tests/run-tests.js +72 -0
  395. package/templates/.claude/skills/docs-seeker/scripts/tests/test-analyze-llms.js +119 -0
  396. package/templates/.claude/skills/docs-seeker/scripts/tests/test-detect-topic.js +112 -0
  397. package/templates/.claude/skills/docs-seeker/scripts/tests/test-fetch-docs.js +84 -0
  398. package/templates/.claude/skills/docs-seeker/scripts/utils/env-loader.js +94 -0
  399. package/templates/.claude/skills/docs-seeker/workflows/library-search.md +87 -0
  400. package/templates/.claude/skills/docs-seeker/workflows/repo-analysis.md +91 -0
  401. package/templates/.claude/skills/docs-seeker/workflows/topic-search.md +77 -0
  402. package/templates/.claude/skills/document-skills/docx/LICENSE.txt +30 -0
  403. package/templates/.claude/skills/document-skills/docx/SKILL.md +197 -0
  404. package/templates/.claude/skills/document-skills/docx/docx-js.md +350 -0
  405. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  406. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  407. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  408. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  409. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  410. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  411. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  412. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  413. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  414. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  415. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  416. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  417. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  418. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  419. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  420. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  421. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  422. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  423. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  424. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  425. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  426. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  427. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  428. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  429. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  430. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  431. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  432. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  433. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  434. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  435. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  436. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/mce/mc.xsd +75 -0
  437. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  438. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  439. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  440. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  441. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  442. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  443. package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  444. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/pack.py +159 -0
  445. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/unpack.py +29 -0
  446. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validate.py +69 -0
  447. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/__init__.py +15 -0
  448. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/base.py +951 -0
  449. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/docx.py +274 -0
  450. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/pptx.py +315 -0
  451. package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/redlining.py +279 -0
  452. package/templates/.claude/skills/document-skills/docx/ooxml.md +610 -0
  453. package/templates/.claude/skills/document-skills/docx/scripts/__init__.py +1 -0
  454. package/templates/.claude/skills/document-skills/docx/scripts/document.py +1276 -0
  455. package/templates/.claude/skills/document-skills/docx/scripts/templates/comments.xml +3 -0
  456. package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsExtended.xml +3 -0
  457. package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsExtensible.xml +3 -0
  458. package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsIds.xml +3 -0
  459. package/templates/.claude/skills/document-skills/docx/scripts/templates/people.xml +3 -0
  460. package/templates/.claude/skills/document-skills/docx/scripts/utilities.py +374 -0
  461. package/templates/.claude/skills/document-skills/pdf/LICENSE.txt +30 -0
  462. package/templates/.claude/skills/document-skills/pdf/SKILL.md +294 -0
  463. package/templates/.claude/skills/document-skills/pdf/forms.md +205 -0
  464. package/templates/.claude/skills/document-skills/pdf/reference.md +612 -0
  465. package/templates/.claude/skills/document-skills/pdf/scripts/check_bounding_boxes.py +70 -0
  466. package/templates/.claude/skills/document-skills/pdf/scripts/check_bounding_boxes_test.py +226 -0
  467. package/templates/.claude/skills/document-skills/pdf/scripts/check_fillable_fields.py +12 -0
  468. package/templates/.claude/skills/document-skills/pdf/scripts/convert_pdf_to_images.py +35 -0
  469. package/templates/.claude/skills/document-skills/pdf/scripts/create_validation_image.py +41 -0
  470. package/templates/.claude/skills/document-skills/pdf/scripts/extract_form_field_info.py +152 -0
  471. package/templates/.claude/skills/document-skills/pdf/scripts/fill_fillable_fields.py +114 -0
  472. package/templates/.claude/skills/document-skills/pdf/scripts/fill_pdf_form_with_annotations.py +108 -0
  473. package/templates/.claude/skills/document-skills/pptx/LICENSE.txt +30 -0
  474. package/templates/.claude/skills/document-skills/pptx/SKILL.md +484 -0
  475. package/templates/.claude/skills/document-skills/pptx/html2pptx.md +625 -0
  476. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  477. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  478. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  479. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  480. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  481. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  482. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  483. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  484. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  485. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  486. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  487. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  488. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  489. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  490. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  491. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  492. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  493. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  494. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  495. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  496. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  497. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  498. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  499. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  500. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  501. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  502. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  503. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  504. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  505. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  506. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  507. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/mce/mc.xsd +75 -0
  508. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
  509. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
  510. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
  511. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
  512. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
  513. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  514. package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
  515. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/pack.py +159 -0
  516. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/unpack.py +29 -0
  517. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validate.py +69 -0
  518. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/__init__.py +15 -0
  519. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/base.py +951 -0
  520. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/docx.py +274 -0
  521. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/pptx.py +315 -0
  522. package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/redlining.py +279 -0
  523. package/templates/.claude/skills/document-skills/pptx/ooxml.md +427 -0
  524. package/templates/.claude/skills/document-skills/pptx/scripts/html2pptx.js +979 -0
  525. package/templates/.claude/skills/document-skills/pptx/scripts/inventory.py +1020 -0
  526. package/templates/.claude/skills/document-skills/pptx/scripts/rearrange.py +231 -0
  527. package/templates/.claude/skills/document-skills/pptx/scripts/replace.py +385 -0
  528. package/templates/.claude/skills/document-skills/pptx/scripts/thumbnail.py +450 -0
  529. package/templates/.claude/skills/document-skills/xlsx/LICENSE.txt +30 -0
  530. package/templates/.claude/skills/document-skills/xlsx/SKILL.md +289 -0
  531. package/templates/.claude/skills/document-skills/xlsx/recalc.py +178 -0
  532. package/templates/.claude/skills/frontend-development/SKILL.md +208 -0
  533. package/templates/.claude/skills/frontend-development/references/accessibility.md +720 -0
  534. package/templates/.claude/skills/frontend-development/references/data-fetching.md +412 -0
  535. package/templates/.claude/skills/frontend-development/references/forms.md +809 -0
  536. package/templates/.claude/skills/frontend-development/references/fsd-architecture.md +442 -0
  537. package/templates/.claude/skills/frontend-development/references/graphql-apollo.md +731 -0
  538. package/templates/.claude/skills/frontend-development/references/performance.md +417 -0
  539. package/templates/.claude/skills/frontend-development/references/react-patterns.md +451 -0
  540. package/templates/.claude/skills/frontend-development/references/routing.md +436 -0
  541. package/templates/.claude/skills/frontend-development/references/state-management.md +510 -0
  542. package/templates/.claude/skills/frontend-development/references/tailwind-css.md +397 -0
  543. package/templates/.claude/skills/frontend-development/references/testing.md +630 -0
  544. package/templates/.claude/skills/frontend-development/references/typescript-standards.md +363 -0
  545. package/templates/.claude/skills/frontend-development/references/ui-libraries.md +586 -0
  546. package/templates/.claude/skills/infra-engineer/SKILL.md +642 -0
  547. package/templates/.claude/skills/infra-engineer/dot_env.example +76 -0
  548. package/templates/.claude/skills/infra-engineer/references/aws-overview.md +171 -0
  549. package/templates/.claude/skills/infra-engineer/references/browser-rendering.md +305 -0
  550. package/templates/.claude/skills/infra-engineer/references/cicd-github-actions.md +439 -0
  551. package/templates/.claude/skills/infra-engineer/references/cloudflare-d1-kv.md +123 -0
  552. package/templates/.claude/skills/infra-engineer/references/cloudflare-platform.md +271 -0
  553. package/templates/.claude/skills/infra-engineer/references/cloudflare-r2-storage.md +280 -0
  554. package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-advanced.md +312 -0
  555. package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-apis.md +309 -0
  556. package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-basics.md +418 -0
  557. package/templates/.claude/skills/infra-engineer/references/devsecops-basics.md +361 -0
  558. package/templates/.claude/skills/infra-engineer/references/docker-basics.md +297 -0
  559. package/templates/.claude/skills/infra-engineer/references/docker-compose.md +292 -0
  560. package/templates/.claude/skills/infra-engineer/references/finops-basics.md +278 -0
  561. package/templates/.claude/skills/infra-engineer/references/gcloud-platform.md +297 -0
  562. package/templates/.claude/skills/infra-engineer/references/gcloud-services.md +304 -0
  563. package/templates/.claude/skills/infra-engineer/references/kubernetes-basics.md +295 -0
  564. package/templates/.claude/skills/infra-engineer/scripts/cloudflare_deploy.py +269 -0
  565. package/templates/.claude/skills/infra-engineer/scripts/docker_optimize.py +320 -0
  566. package/templates/.claude/skills/infra-engineer/scripts/requirements.txt +20 -0
  567. package/templates/.claude/skills/infra-engineer/scripts/tests/requirements.txt +3 -0
  568. package/templates/.claude/skills/infra-engineer/scripts/tests/test_cloudflare_deploy.py +285 -0
  569. package/templates/.claude/skills/infra-engineer/scripts/tests/test_docker_optimize.py +436 -0
  570. package/templates/.claude/skills/javascript-pro/SKILL.md +96 -0
  571. package/templates/.claude/skills/javascript-pro/references/async-patterns.md +96 -0
  572. package/templates/.claude/skills/javascript-pro/references/best-practices.md +98 -0
  573. package/templates/.claude/skills/javascript-pro/references/design-patterns.md +100 -0
  574. package/templates/.claude/skills/javascript-pro/references/error-handling.md +100 -0
  575. package/templates/.claude/skills/javascript-pro/references/functional-patterns.md +93 -0
  576. package/templates/.claude/skills/javascript-pro/references/modern-syntax.md +100 -0
  577. package/templates/.claude/skills/javascript-pro/references/performance.md +98 -0
  578. package/templates/.claude/skills/jira-integration/adf-parser.md +338 -0
  579. package/templates/.claude/skills/jira-integration/jira-integration.md +353 -0
  580. package/templates/.claude/skills/knowledge-base/knowledge-base.md +212 -0
  581. package/templates/.claude/skills/mobile-development/SKILL.md +212 -0
  582. package/templates/.claude/skills/mobile-development/references/mobile-android.md +604 -0
  583. package/templates/.claude/skills/mobile-development/references/mobile-best-practices.md +545 -0
  584. package/templates/.claude/skills/mobile-development/references/mobile-debugging.md +1089 -0
  585. package/templates/.claude/skills/mobile-development/references/mobile-frameworks.md +465 -0
  586. package/templates/.claude/skills/mobile-development/references/mobile-ios.md +496 -0
  587. package/templates/.claude/skills/mobile-development/references/mobile-mindset.md +544 -0
  588. package/templates/.claude/skills/mobile-testing/SKILL.md +24 -0
  589. package/templates/.claude/skills/performance-testing/SKILL.md +30 -0
  590. package/templates/.claude/skills/planning/SKILL.md +143 -0
  591. package/templates/.claude/skills/planning/references/codebase-understanding.md +62 -0
  592. package/templates/.claude/skills/planning/references/output-standards.md +87 -0
  593. package/templates/.claude/skills/planning/references/plan-organization.md +137 -0
  594. package/templates/.claude/skills/planning/references/research-phase.md +47 -0
  595. package/templates/.claude/skills/planning/references/solution-design.md +63 -0
  596. package/templates/.claude/skills/playwright/SKILL.md +303 -0
  597. package/templates/.claude/skills/playwright/examples/auth.fixture.ts +172 -0
  598. package/templates/.claude/skills/playwright/examples/login.page.ts +232 -0
  599. package/templates/.claude/skills/playwright/references/config.md +391 -0
  600. package/templates/.claude/skills/problem-solving/SKILL.md +96 -0
  601. package/templates/.claude/skills/problem-solving/references/attribution.md +69 -0
  602. package/templates/.claude/skills/problem-solving/references/collision-zone-thinking.md +79 -0
  603. package/templates/.claude/skills/problem-solving/references/inversion-exercise.md +91 -0
  604. package/templates/.claude/skills/problem-solving/references/meta-pattern-recognition.md +87 -0
  605. package/templates/.claude/skills/problem-solving/references/scale-game.md +95 -0
  606. package/templates/.claude/skills/problem-solving/references/simplification-cascades.md +80 -0
  607. package/templates/.claude/skills/problem-solving/references/when-stuck.md +72 -0
  608. package/templates/.claude/skills/prompt-enhancer/SKILL.md +380 -0
  609. package/templates/.claude/skills/python-pro/SKILL.md +59 -0
  610. package/templates/.claude/skills/python-pro/references/async-patterns.md +96 -0
  611. package/templates/.claude/skills/python-pro/references/error-handling.md +84 -0
  612. package/templates/.claude/skills/python-pro/references/performance.md +71 -0
  613. package/templates/.claude/skills/python-pro/references/project-setup.md +78 -0
  614. package/templates/.claude/skills/python-pro/references/security.md +73 -0
  615. package/templates/.claude/skills/python-pro/references/testing.md +90 -0
  616. package/templates/.claude/skills/python-pro/references/type-system.md +88 -0
  617. package/templates/.claude/skills/qa-standards/SKILL.md +176 -0
  618. package/templates/.claude/skills/qa-standards/references/naming-conventions.md +262 -0
  619. package/templates/.claude/skills/quality-metrics/SKILL.md +27 -0
  620. package/templates/.claude/skills/repomix/SKILL.md +247 -0
  621. package/templates/.claude/skills/repomix/references/configuration.md +211 -0
  622. package/templates/.claude/skills/repomix/references/usage-patterns.md +232 -0
  623. package/templates/.claude/skills/repomix/scripts/README.md +179 -0
  624. package/templates/.claude/skills/repomix/scripts/repomix_batch.py +455 -0
  625. package/templates/.claude/skills/repomix/scripts/repos.example.json +15 -0
  626. package/templates/.claude/skills/repomix/scripts/requirements.txt +15 -0
  627. package/templates/.claude/skills/repomix/scripts/tests/test_repomix_batch.py +531 -0
  628. package/templates/.claude/skills/research/SKILL.md +168 -0
  629. package/templates/.claude/skills/sequential-thinking/.env.example +8 -0
  630. package/templates/.claude/skills/sequential-thinking/README.md +183 -0
  631. package/templates/.claude/skills/sequential-thinking/SKILL.md +94 -0
  632. package/templates/.claude/skills/sequential-thinking/package.json +31 -0
  633. package/templates/.claude/skills/sequential-thinking/references/advanced-strategies.md +79 -0
  634. package/templates/.claude/skills/sequential-thinking/references/advanced-techniques.md +76 -0
  635. package/templates/.claude/skills/sequential-thinking/references/core-patterns.md +95 -0
  636. package/templates/.claude/skills/sequential-thinking/references/examples-api.md +88 -0
  637. package/templates/.claude/skills/sequential-thinking/references/examples-architecture.md +94 -0
  638. package/templates/.claude/skills/sequential-thinking/references/examples-debug.md +90 -0
  639. package/templates/.claude/skills/sequential-thinking/scripts/format-thought.js +159 -0
  640. package/templates/.claude/skills/sequential-thinking/scripts/process-thought.js +236 -0
  641. package/templates/.claude/skills/sequential-thinking/tests/format-thought.test.js +133 -0
  642. package/templates/.claude/skills/sequential-thinking/tests/process-thought.test.js +215 -0
  643. package/templates/.claude/skills/test-automation/SKILL.md +93 -0
  644. package/templates/.claude/skills/test-automation/examples/page-object.ts +44 -0
  645. package/templates/.claude/skills/test-automation/references/frameworks.md +96 -0
  646. package/templates/.claude/skills/test-data-management/SKILL.md +24 -0
  647. package/templates/.claude/skills/test-design/SKILL.md +25 -0
  648. package/templates/.claude/skills/typescript-pro/SKILL.md +84 -0
  649. package/templates/.claude/skills/typescript-pro/references/advanced-patterns.md +100 -0
  650. package/templates/.claude/skills/typescript-pro/references/best-practices.md +96 -0
  651. package/templates/.claude/skills/typescript-pro/references/conditional-types.md +85 -0
  652. package/templates/.claude/skills/typescript-pro/references/generics.md +97 -0
  653. package/templates/.claude/skills/typescript-pro/references/mapped-types.md +99 -0
  654. package/templates/.claude/skills/typescript-pro/references/template-literals.md +85 -0
  655. package/templates/.claude/skills/typescript-pro/references/type-inference.md +94 -0
  656. package/templates/.claude/skills/typescript-pro/references/utility-types.md +96 -0
  657. package/templates/.claude/skills/ui-testing/SKILL.md +24 -0
  658. package/templates/.claude/skills/ui-ux-pro-max/SKILL.md +229 -0
  659. package/templates/.claude/skills/ui-ux-pro-max/data/charts.csv +26 -0
  660. package/templates/.claude/skills/ui-ux-pro-max/data/colors.csv +97 -0
  661. package/templates/.claude/skills/ui-ux-pro-max/data/landing.csv +31 -0
  662. package/templates/.claude/skills/ui-ux-pro-max/data/products.csv +97 -0
  663. package/templates/.claude/skills/ui-ux-pro-max/data/prompts.csv +24 -0
  664. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  665. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  666. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  667. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  668. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
  669. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  670. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  671. package/templates/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  672. package/templates/.claude/skills/ui-ux-pro-max/data/styles.csv +59 -0
  673. package/templates/.claude/skills/ui-ux-pro-max/data/typography.csv +58 -0
  674. package/templates/.claude/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  675. package/templates/.claude/skills/ui-ux-pro-max/scripts/core.py +236 -0
  676. package/templates/.claude/skills/ui-ux-pro-max/scripts/search.py +61 -0
  677. package/templates/.claude/skills/webdriverio/SKILL.md +433 -0
  678. package/templates/.claude/skills/webdriverio/examples/mobile.page.ts +369 -0
  679. package/templates/.claude/skills/webdriverio/references/capabilities.md +377 -0
  680. package/templates/.claude/statusline.cjs +105 -0
  681. package/templates/.claude/statusline.ps1 +187 -0
  682. package/templates/.claude/statusline.sh +161 -0
  683. package/templates/.claude/workflows/api-testing-workflow.md +36 -0
  684. package/templates/.claude/workflows/bug-investigation-workflow.md +42 -0
  685. package/templates/.claude/workflows/development-rules.md +366 -0
  686. package/templates/.claude/workflows/documentation-management.md +128 -0
  687. package/templates/.claude/workflows/e2e-testing-workflow.md +36 -0
  688. package/templates/.claude/workflows/orchestration-protocol.md +16 -0
  689. package/templates/.claude/workflows/performance-testing-workflow.md +42 -0
  690. package/templates/.claude/workflows/primary-workflow.md +45 -0
  691. package/templates/.claude/workflows/qa-primary-workflow.md +48 -0
  692. package/templates/.claude/workflows/qa-rules.md +42 -0
  693. package/templates/.claude/workflows/regression-testing-workflow.md +36 -0
  694. package/templates/.claude/workflows/test-driven-qa-workflow.md +37 -0
  695. package/templates/.codex/config.toml.template +29 -0
  696. package/templates/.codex/prompts/qa-commands.md +32 -0
  697. package/templates/.codex/prompts/test-generation.md +29 -0
  698. package/templates/.cursor/CHANGELOG.md +540 -0
  699. package/templates/.cursor/README.md +261 -0
  700. package/templates/.cursor/commands/devkit/ask.md +71 -0
  701. package/templates/.cursor/commands/devkit/backend/create-api.md +207 -0
  702. package/templates/.cursor/commands/devkit/backend/create-migration.md +169 -0
  703. package/templates/.cursor/commands/devkit/backend/create-schema.md +183 -0
  704. package/templates/.cursor/commands/devkit/backend/design-graphql-api.md +287 -0
  705. package/templates/.cursor/commands/devkit/backend/design-rest-api.md +219 -0
  706. package/templates/.cursor/commands/devkit/config/init-backend.md +219 -0
  707. package/templates/.cursor/commands/devkit/config/init-frontend.md +114 -0
  708. package/templates/.cursor/commands/devkit/create-api-integration.md +196 -0
  709. package/templates/.cursor/commands/devkit/create-component.md +104 -0
  710. package/templates/.cursor/commands/devkit/create-form.md +189 -0
  711. package/templates/.cursor/commands/devkit/create-page.md +111 -0
  712. package/templates/.cursor/commands/devkit/create-storybook.md +235 -0
  713. package/templates/.cursor/commands/devkit/create-table.md +251 -0
  714. package/templates/.cursor/commands/devkit/create-test.md +174 -0
  715. package/templates/.cursor/commands/devkit/debug.md +192 -0
  716. package/templates/.cursor/commands/devkit/docs/capture-knowledge.md +252 -0
  717. package/templates/.cursor/commands/devkit/docs/init.md +153 -0
  718. package/templates/.cursor/commands/devkit/docs/summarize.md +82 -0
  719. package/templates/.cursor/commands/devkit/docs/update.md +174 -0
  720. package/templates/.cursor/commands/devkit/fix.md +24 -0
  721. package/templates/.cursor/commands/devkit/help.md +148 -0
  722. package/templates/.cursor/commands/devkit/refactor.md +476 -0
  723. package/templates/.cursor/commands/devkit/research.md +135 -0
  724. package/templates/.cursor/commands/devkit/review/code.md +297 -0
  725. package/templates/.cursor/commands/devkit/review/codebase.md +37 -0
  726. package/templates/.cursor/commands/devkit/scout.md +103 -0
  727. package/templates/.cursor/commands/devkit/solve.md +355 -0
  728. package/templates/.cursor/commands/devkit/spec/brainstorm.md +184 -0
  729. package/templates/.cursor/commands/devkit/spec/capture-requirement.md +164 -0
  730. package/templates/.cursor/commands/devkit/spec/cook.md +101 -0
  731. package/templates/.cursor/commands/devkit/spec/deep-capture-requirement.md +149 -0
  732. package/templates/.cursor/commands/devkit/spec/implement.md +354 -0
  733. package/templates/.cursor/commands/devkit/spec/plan.md +317 -0
  734. package/templates/.cursor/commands/devkit/spec/task.md +150 -0
  735. package/templates/.cursor/commands/devkit/spec/test.md +203 -0
  736. package/templates/.cursor/commands/devkit/spec/update-plan.md +234 -0
  737. package/templates/.cursor/commands/devkit/spec/update-requirement.md +222 -0
  738. package/templates/.cursor/commands/devkit/spec-lite/do.md +154 -0
  739. package/templates/.cursor/commands/devkit/spec-lite/plan.md +197 -0
  740. package/templates/.cursor/commands/devkit/spec-lite/task.md +138 -0
  741. package/templates/.cursor/commands/devkit/spec-lite/test.md +129 -0
  742. package/templates/.cursor/commands/devkit/spec-lite/update-plan.md +133 -0
  743. package/templates/.cursor/commands/devkit/ui-ux-pro-max.md +226 -0
  744. package/templates/.cursor/doc-templates/code-standards.md +486 -0
  745. package/templates/.cursor/doc-templates/codebase-summary.md +426 -0
  746. package/templates/.cursor/doc-templates/development-rules.md +553 -0
  747. package/templates/.cursor/doc-templates/project-overview-pdr.md +494 -0
  748. package/templates/.cursor/doc-templates/system-architecture.md +615 -0
  749. package/templates/.cursor/doc-templates/technical-documents.md +127 -0
  750. package/templates/.cursor/repomix.config.json +34 -0
  751. package/templates/.cursor/rules/backend-development/backend-development.mdc +94 -0
  752. package/templates/.cursor/rules/backend-development/references/backend-api-design.md +495 -0
  753. package/templates/.cursor/rules/backend-development/references/backend-architecture.md +454 -0
  754. package/templates/.cursor/rules/backend-development/references/backend-code-quality.md +659 -0
  755. package/templates/.cursor/rules/backend-development/references/backend-debugging.md +904 -0
  756. package/templates/.cursor/rules/backend-development/references/backend-devops.md +494 -0
  757. package/templates/.cursor/rules/backend-development/references/backend-mindset.md +387 -0
  758. package/templates/.cursor/rules/backend-development/references/backend-performance.md +397 -0
  759. package/templates/.cursor/rules/backend-development/references/backend-security.md +290 -0
  760. package/templates/.cursor/rules/backend-development/references/backend-technologies.md +256 -0
  761. package/templates/.cursor/rules/backend-development/references/backend-testing.md +429 -0
  762. package/templates/.cursor/rules/brainstormer.mdc +147 -0
  763. package/templates/.cursor/rules/code-optimizer.mdc +132 -0
  764. package/templates/.cursor/rules/code-review/code-revew.mdc +144 -0
  765. package/templates/.cursor/rules/code-review/references/code-review-reception.md +209 -0
  766. package/templates/.cursor/rules/code-review/references/requesting-code-review.md +105 -0
  767. package/templates/.cursor/rules/code-review/references/verification-before-completion.md +139 -0
  768. package/templates/.cursor/rules/code-reviewer.mdc +85 -0
  769. package/templates/.cursor/rules/code-simplifier.mdc +121 -0
  770. package/templates/.cursor/rules/coder.mdc +86 -0
  771. package/templates/.cursor/rules/community-rules.mdc +38 -0
  772. package/templates/.cursor/rules/cunningham.mdc +114 -0
  773. package/templates/.cursor/rules/debugger.mdc +108 -0
  774. package/templates/.cursor/rules/development-rules.mdc +208 -0
  775. package/templates/.cursor/rules/docs-manager.mdc +121 -0
  776. package/templates/.cursor/rules/docs-seeker/docs-seeker.mdc +57 -0
  777. package/templates/.cursor/rules/docs-seeker/references/advanced.md +80 -0
  778. package/templates/.cursor/rules/docs-seeker/references/context7-patterns.md +69 -0
  779. package/templates/.cursor/rules/docs-seeker/references/errors.md +69 -0
  780. package/templates/.cursor/rules/docs-seeker/scripts/analyze-llms-txt.js +211 -0
  781. package/templates/.cursor/rules/docs-seeker/scripts/detect-topic.js +172 -0
  782. package/templates/.cursor/rules/docs-seeker/scripts/fetch-docs.js +213 -0
  783. package/templates/.cursor/rules/docs-seeker/scripts/tests/run-tests.js +72 -0
  784. package/templates/.cursor/rules/docs-seeker/scripts/tests/test-analyze-llms.js +119 -0
  785. package/templates/.cursor/rules/docs-seeker/scripts/tests/test-detect-topic.js +112 -0
  786. package/templates/.cursor/rules/docs-seeker/scripts/tests/test-fetch-docs.js +84 -0
  787. package/templates/.cursor/rules/docs-seeker/scripts/utils/env-loader.js +94 -0
  788. package/templates/.cursor/rules/docs-seeker/workflows/library-search.md +88 -0
  789. package/templates/.cursor/rules/docs-seeker/workflows/repo-analysis.md +92 -0
  790. package/templates/.cursor/rules/docs-seeker/workflows/topic-search.md +78 -0
  791. package/templates/.cursor/rules/frontend-development/frontend-development.mdc +131 -0
  792. package/templates/.cursor/rules/frontend-development/references/accessibility.md +719 -0
  793. package/templates/.cursor/rules/frontend-development/references/data-fetching.md +412 -0
  794. package/templates/.cursor/rules/frontend-development/references/forms.md +808 -0
  795. package/templates/.cursor/rules/frontend-development/references/fsd-architecture.md +442 -0
  796. package/templates/.cursor/rules/frontend-development/references/graphql-apollo.md +730 -0
  797. package/templates/.cursor/rules/frontend-development/references/performance.md +417 -0
  798. package/templates/.cursor/rules/frontend-development/references/react-patterns.md +451 -0
  799. package/templates/.cursor/rules/frontend-development/references/routing.md +436 -0
  800. package/templates/.cursor/rules/frontend-development/references/state-management.md +511 -0
  801. package/templates/.cursor/rules/frontend-development/references/tailwind-css.md +398 -0
  802. package/templates/.cursor/rules/frontend-development/references/testing.md +629 -0
  803. package/templates/.cursor/rules/frontend-development/references/typescript-standards.md +364 -0
  804. package/templates/.cursor/rules/frontend-development/references/ui-libraries.md +587 -0
  805. package/templates/.cursor/rules/javascript-pro/javascript-pro.mdc +98 -0
  806. package/templates/.cursor/rules/javascript-pro/references/async-patterns.md +96 -0
  807. package/templates/.cursor/rules/javascript-pro/references/best-practices.md +98 -0
  808. package/templates/.cursor/rules/javascript-pro/references/design-patterns.md +100 -0
  809. package/templates/.cursor/rules/javascript-pro/references/error-handling.md +100 -0
  810. package/templates/.cursor/rules/javascript-pro/references/functional-patterns.md +93 -0
  811. package/templates/.cursor/rules/javascript-pro/references/modern-syntax.md +100 -0
  812. package/templates/.cursor/rules/javascript-pro/references/performance.md +98 -0
  813. package/templates/.cursor/rules/planner.mdc +87 -0
  814. package/templates/.cursor/rules/problem-solving/problem-solving.mdc +96 -0
  815. package/templates/.cursor/rules/problem-solving/references/attribution.md +69 -0
  816. package/templates/.cursor/rules/problem-solving/references/collision-zone-thinking.md +79 -0
  817. package/templates/.cursor/rules/problem-solving/references/inversion-exercise.md +91 -0
  818. package/templates/.cursor/rules/problem-solving/references/meta-pattern-recognition.md +87 -0
  819. package/templates/.cursor/rules/problem-solving/references/scale-game.md +95 -0
  820. package/templates/.cursor/rules/problem-solving/references/simplification-cascades.md +80 -0
  821. package/templates/.cursor/rules/problem-solving/references/when-stuck.md +72 -0
  822. package/templates/.cursor/rules/project-manager.mdc +116 -0
  823. package/templates/.cursor/rules/project-profile.mdc +54 -0
  824. package/templates/.cursor/rules/python-pro/python-pro.mdc +83 -0
  825. package/templates/.cursor/rules/python-pro/references/async-patterns.md +96 -0
  826. package/templates/.cursor/rules/python-pro/references/error-handling.md +84 -0
  827. package/templates/.cursor/rules/python-pro/references/performance.md +71 -0
  828. package/templates/.cursor/rules/python-pro/references/project-setup.md +78 -0
  829. package/templates/.cursor/rules/python-pro/references/security.md +73 -0
  830. package/templates/.cursor/rules/python-pro/references/testing.md +90 -0
  831. package/templates/.cursor/rules/python-pro/references/type-system.md +88 -0
  832. package/templates/.cursor/rules/qa-api-testing.mdc +25 -0
  833. package/templates/.cursor/rules/qa-automation.mdc +28 -0
  834. package/templates/.cursor/rules/qa-testing.mdc +28 -0
  835. package/templates/.cursor/rules/repomix/references/configuration.md +211 -0
  836. package/templates/.cursor/rules/repomix/references/usage-patterns.md +232 -0
  837. package/templates/.cursor/rules/repomix/repomix.mdc +248 -0
  838. package/templates/.cursor/rules/repomix/scripts/README.md +179 -0
  839. package/templates/.cursor/rules/repomix/scripts/repomix_batch.py +455 -0
  840. package/templates/.cursor/rules/repomix/scripts/repos.example.json +15 -0
  841. package/templates/.cursor/rules/repomix/scripts/requirements.txt +15 -0
  842. package/templates/.cursor/rules/repomix/scripts/tests/test_repomix_batch.py +531 -0
  843. package/templates/.cursor/rules/research/research.mdc +111 -0
  844. package/templates/.cursor/rules/researcher.mdc +54 -0
  845. package/templates/.cursor/rules/scout.mdc +105 -0
  846. package/templates/.cursor/rules/security-agent.mdc +122 -0
  847. package/templates/.cursor/rules/security.mdc +90 -0
  848. package/templates/.cursor/rules/sequential-thinking/references/advanced-strategies.md +80 -0
  849. package/templates/.cursor/rules/sequential-thinking/references/advanced-techniques.md +77 -0
  850. package/templates/.cursor/rules/sequential-thinking/references/core-patterns.md +96 -0
  851. package/templates/.cursor/rules/sequential-thinking/references/examples-api.md +89 -0
  852. package/templates/.cursor/rules/sequential-thinking/references/examples-architecture.md +95 -0
  853. package/templates/.cursor/rules/sequential-thinking/references/examples-debug.md +91 -0
  854. package/templates/.cursor/rules/sequential-thinking/scripts/format-thought.js +159 -0
  855. package/templates/.cursor/rules/sequential-thinking/scripts/process-thought.js +236 -0
  856. package/templates/.cursor/rules/sequential-thinking/sequential-thinking.mdc +86 -0
  857. package/templates/.cursor/rules/tattletale-reporter.mdc +64 -0
  858. package/templates/.cursor/rules/tester.mdc +221 -0
  859. package/templates/.cursor/rules/testing.mdc +215 -0
  860. package/templates/.cursor/rules/typescript-pro/references/advanced-patterns.md +100 -0
  861. package/templates/.cursor/rules/typescript-pro/references/best-practices.md +96 -0
  862. package/templates/.cursor/rules/typescript-pro/references/conditional-types.md +85 -0
  863. package/templates/.cursor/rules/typescript-pro/references/generics.md +97 -0
  864. package/templates/.cursor/rules/typescript-pro/references/mapped-types.md +99 -0
  865. package/templates/.cursor/rules/typescript-pro/references/template-literals.md +85 -0
  866. package/templates/.cursor/rules/typescript-pro/references/type-inference.md +94 -0
  867. package/templates/.cursor/rules/typescript-pro/references/utility-types.md +96 -0
  868. package/templates/.cursor/rules/typescript-pro/typescript-pro.mdc +101 -0
  869. package/templates/.cursor/rules/typescript-pro.mdc +129 -0
  870. package/templates/.cursor/rules/ui-ux-designer.mdc +117 -0
  871. package/templates/.cursor/scripts/helper.py +723 -0
  872. package/templates/.cursor/settings.json +5 -0
  873. package/templates/.kiro/steering/qa-standards.md +84 -0
  874. package/templates/.kiro/steering/test-patterns.md +62 -0
  875. package/templates/.kiro/steering/tool-integration.md +73 -0
@@ -0,0 +1,24 @@
1
+ STT,Style Category,AI Prompt Keywords (Copy-Paste Ready),CSS/Technical Keywords,Implementation Checklist,Design System Variables
2
+ 1,Minimalism & Swiss Style,"Design a minimalist landing page. Use: white space, geometric layouts, sans-serif fonts, high contrast, grid-based structure, essential elements only. Avoid shadows and gradients. Focus on clarity and functionality.","display: grid, gap: 2rem, font-family: sans-serif, color: #000 or #FFF, max-width: 1200px, clean borders, no box-shadow unless necessary","☐ Grid-based layout 12-16 columns, ☐ Typography hierarchy clear, ☐ No unnecessary decorations, ☐ WCAG AAA contrast verified, ☐ Mobile responsive grid","--spacing: 2rem, --border-radius: 0px, --font-weight: 400-700, --shadow: none, --accent-color: single primary only"
3
+ 2,Neumorphism,"Create a neumorphic UI with soft 3D effects. Use light pastels, rounded corners (12-16px), subtle soft shadows (multiple layers), no hard lines, monochromatic color scheme with light/dark variations. Embossed/debossed effect on interactive elements.","border-radius: 12-16px, box-shadow: -5px -5px 15px rgba(0,0,0,0.1), 5px 5px 15px rgba(255,255,255,0.8), background: linear-gradient(145deg, color1, color2), transform: scale on press","☐ Rounded corners 12-16px consistent, ☐ Multiple shadow layers (2-3), ☐ Pastel color verified, ☐ Monochromatic palette checked, ☐ Press animation smooth 150ms","--border-radius: 14px, --shadow-soft-1: -5px -5px 15px, --shadow-soft-2: 5px 5px 15px, --color-light: #F5F5F5, --color-primary: single pastel"
4
+ 3,Glassmorphism,"Design a glassmorphic interface with frosted glass effect. Use backdrop blur (10-20px), translucent overlays (rgba 10-30% opacity), vibrant background colors, subtle borders, light source reflection, layered depth. Perfect for modern overlays and cards.","backdrop-filter: blur(15px), background: rgba(255, 255, 255, 0.15), border: 1px solid rgba(255,255,255,0.2), -webkit-backdrop-filter: blur(15px), z-index layering for depth","☐ Backdrop-filter blur 10-20px, ☐ Translucent white 15-30% opacity, ☐ Subtle border 1px light, ☐ Vibrant background verified, ☐ Text contrast 4.5:1 checked","--blur-amount: 15px, --glass-opacity: 0.15, --border-color: rgba(255,255,255,0.2), --background: vibrant color, --text-color: light/dark based on BG"
5
+ 4,Brutalism,"Create a brutalist design with raw, unpolished, stark aesthetic. Use pure primary colors (red, blue, yellow), black & white, no smooth transitions (instant), sharp corners, bold large typography, visible grid lines, default system fonts, intentional 'broken' design elements.","border-radius: 0px, transition: none or 0s, font-family: system-ui or monospace, font-weight: 700+, border: visible 2-4px, colors: #FF0000, #0000FF, #FFFF00, #000000, #FFFFFF","☐ No border-radius (0px), ☐ No transitions (instant), ☐ Bold typography (700+), ☐ Pure primary colors used, ☐ Visible grid/borders, ☐ Asymmetric layout intentional","--border-radius: 0px, --transition-duration: 0s, --font-weight: 700-900, --colors: primary only, --border-style: visible, --grid-visible: true"
6
+ 5,3D & Hyperrealism,"Build an immersive 3D interface using realistic textures, 3D models (Three.js/Babylon.js), complex shadows, realistic lighting, parallax scrolling (3-5 layers), physics-based motion. Include skeuomorphic elements with tactile detail.","transform: translate3d, perspective: 1000px, WebGL canvas, Three.js/Babylon.js library, box-shadow: complex multi-layer, background: complex gradients, filter: drop-shadow()","☐ WebGL/Three.js integrated, ☐ 3D models loaded, ☐ Parallax 3-5 layers, ☐ Realistic lighting verified, ☐ Complex shadows rendered, ☐ Physics animation smooth 300-400ms","--perspective: 1000px, --parallax-layers: 5, --lighting-intensity: realistic, --shadow-depth: 20-40%, --animation-duration: 300-400ms"
7
+ 6,Vibrant & Block-based,"Design an energetic, vibrant interface with bold block layouts, geometric shapes, high color contrast, large typography (32px+), animated background patterns, duotone effects. Perfect for startups and youth-focused apps. Use 4-6 contrasting colors from complementary/triadic schemes.","display: flex/grid with large gaps (48px+), font-size: 32px+, background: animated patterns (CSS), color: neon/vibrant colors, animation: continuous pattern movement","☐ Block layout with 48px+ gaps, ☐ Large typography 32px+, ☐ 4-6 vibrant colors max, ☐ Animated patterns active, ☐ Scroll-snap enabled, ☐ High contrast verified (7:1+)","--block-gap: 48px, --typography-size: 32px+, --color-palette: 4-6 vibrant colors, --animation: continuous pattern, --contrast-ratio: 7:1+"
8
+ 7,Dark Mode (OLED),"Create an OLED-optimized dark interface with deep black (#000000), dark grey (#121212), midnight blue accents. Use minimal glow effects, vibrant neon accents (green, blue, gold, purple), high contrast text. Optimize for eye comfort and OLED power saving.","background: #000000 or #121212, color: #FFFFFF or #E0E0E0, text-shadow: 0 0 10px neon-color (sparingly), filter: brightness(0.8) if needed, color-scheme: dark","☐ Deep black #000000 or #121212, ☐ Vibrant neon accents used, ☐ Text contrast 7:1+, ☐ Minimal glow effects, ☐ OLED power optimization, ☐ No white (#FFFFFF) background","--bg-black: #000000, --bg-dark-grey: #121212, --text-primary: #FFFFFF, --accent-neon: neon colors, --glow-effect: minimal, --oled-optimized: true"
9
+ 8,Accessible & Ethical,"Design with WCAG AAA compliance. Include: high contrast (7:1+), large text (16px+), keyboard navigation, screen reader compatibility, focus states visible (3-4px ring), semantic HTML, ARIA labels, skip links, reduced motion support (prefers-reduced-motion), 44x44px touch targets.","color-contrast: 7:1+, font-size: 16px+, outline: 3-4px on :focus-visible, aria-label, role attributes, @media (prefers-reduced-motion), touch-target: 44x44px, cursor: pointer","☐ WCAG AAA verified, ☐ 7:1+ contrast checked, ☐ Keyboard navigation tested, ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ Semantic HTML used, ☐ Touch targets 44x44px","--contrast-ratio: 7:1, --font-size-min: 16px, --focus-ring: 3-4px, --touch-target: 44x44px, --wcag-level: AAA, --keyboard-accessible: true, --sr-tested: true"
10
+ 9,Claymorphism,"Design a playful, toy-like interface with soft 3D, chunky elements, bubbly aesthetic, rounded edges (16-24px), thick borders (3-4px), double shadows (inner + outer), pastel colors, smooth animations. Perfect for children's apps and creative tools.","border-radius: 16-24px, border: 3-4px solid, box-shadow: inset -2px -2px 8px, 4px 4px 8px, background: pastel-gradient, animation: soft bounce (cubic-bezier 0.34, 1.56)","☐ Border-radius 16-24px, ☐ Thick borders 3-4px, ☐ Double shadows (inner+outer), ☐ Pastel colors used, ☐ Soft bounce animations, ☐ Playful interactions","--border-radius: 20px, --border-width: 3-4px, --shadow-inner: inset -2px -2px 8px, --shadow-outer: 4px 4px 8px, --color-palette: pastels, --animation: bounce"
11
+ 10,Aurora UI,"Create a vibrant gradient interface inspired by Northern Lights with mesh gradients, smooth color blends, flowing animations. Use complementary color pairs (blue-orange, purple-yellow), flowing background gradients, subtle continuous animations (8-12s loops), iridescent effects.","background: conic-gradient or radial-gradient with multiple stops, animation: @keyframes gradient (8-12s), background-size: 200% 200%, filter: saturate(1.2), blend-mode: screen or multiply","☐ Mesh/flowing gradients applied, ☐ 8-12s animation loop, ☐ Complementary colors used, ☐ Smooth color transitions, ☐ Iridescent effect subtle, ☐ Text contrast verified","--gradient-colors: complementary pairs, --animation-duration: 8-12s, --blend-mode: screen, --color-saturation: 1.2, --effect: iridescent, --loop-smooth: true"
12
+ 11,Retro-Futurism,"Build a retro-futuristic (cyberpunk/vaporwave) interface with neon colors (blue, pink, cyan), deep black background, 80s aesthetic, CRT scanlines, glitch effects, neon glow text/borders, monospace fonts, geometric patterns. Use neon text-shadow and animated glitch effects.","color: neon colors (#0080FF, #FF006E, #00FFFF), text-shadow: 0 0 10px neon, background: #000 or #1A1A2E, font-family: monospace, animation: glitch (skew+offset), filter: hue-rotate","☐ Neon colors used, ☐ CRT scanlines effect, ☐ Glitch animations active, ☐ Monospace font, ☐ Deep black background, ☐ Glow effects applied, ☐ 80s patterns present","--neon-colors: #0080FF #FF006E #00FFFF, --background: #000000, --font-family: monospace, --effect: glitch+glow, --scanline-opacity: 0.3, --crt-effect: true"
13
+ 12,Flat Design,"Create a flat, 2D interface with bold colors, no shadows/gradients, clean lines, simple geometric shapes, icon-heavy, typography-focused, minimal ornamentation. Use 4-6 solid, bright colors in a limited palette with high saturation.","box-shadow: none, background: solid color, border-radius: 0-4px, color: solid (no gradients), fill: solid, stroke: 1-2px, font: bold sans-serif, icons: simplified SVG","☐ No shadows/gradients, ☐ 4-6 solid colors max, ☐ Clean lines consistent, ☐ Simple shapes used, ☐ Icon-heavy layout, ☐ High saturation colors, ☐ Fast loading verified","--shadow: none, --color-palette: 4-6 solid, --border-radius: 2px, --gradient: none, --icons: simplified SVG, --animation: minimal 150-200ms"
14
+ 13,Skeuomorphism,"Design a realistic, textured interface with 3D depth, real-world metaphors (leather, wood, metal), complex gradients (8-12 stops), realistic shadows, grain/texture overlays, tactile press animations. Perfect for premium/luxury products.","background: complex gradient (8-12 stops), box-shadow: realistic multi-layer, background-image: texture overlay (noise, grain), filter: drop-shadow, transform: scale on press (300-500ms)","☐ Realistic textures applied, ☐ Complex gradients 8-12 stops, ☐ Multi-layer shadows, ☐ Texture overlays present, ☐ Tactile animations smooth, ☐ Depth effect pronounced","--gradient-stops: 8-12, --texture-overlay: noise+grain, --shadow-layers: 3+, --animation-duration: 300-500ms, --depth-effect: pronounced, --tactile: true"
15
+ 14,Liquid Glass,"Create a premium liquid glass effect with morphing shapes, flowing animations, chromatic aberration, iridescent gradients, smooth 400-600ms transitions. Use SVG morphing for shape changes, dynamic blur, smooth color transitions creating a fluid, premium feel.","animation: morphing SVG paths (400-600ms), backdrop-filter: blur + saturate, filter: hue-rotate + brightness, blend-mode: screen, background: iridescent gradient","☐ Morphing animations 400-600ms, ☐ Chromatic aberration applied, ☐ Dynamic blur active, ☐ Iridescent gradients, ☐ Smooth color transitions, ☐ Premium feel achieved","--morph-duration: 400-600ms, --blur-amount: 15px, --chromatic-aberration: true, --iridescent: true, --blend-mode: screen, --smooth-transitions: true"
16
+ 15,Motion-Driven,"Build an animation-heavy interface with scroll-triggered animations, microinteractions, parallax scrolling (3-5 layers), smooth transitions (300-400ms), entrance animations, page transitions. Use Intersection Observer for scroll effects, transform for performance, GPU acceleration.","animation: @keyframes scroll-reveal, transform: translateY/X, Intersection Observer API, will-change: transform, scroll-behavior: smooth, animation-duration: 300-400ms","☐ Scroll animations active, ☐ Parallax 3-5 layers, ☐ Entrance animations smooth, ☐ Page transitions fluid, ☐ GPU accelerated, ☐ Prefers-reduced-motion respected","--animation-duration: 300-400ms, --parallax-layers: 5, --scroll-behavior: smooth, --gpu-accelerated: true, --entrance-animation: true, --page-transition: smooth"
17
+ 16,Micro-interactions,"Design with delightful micro-interactions: small 50-100ms animations, gesture-based responses, tactile feedback, loading spinners, success/error states, subtle hover effects, haptic feedback triggers for mobile. Focus on responsive, contextual interactions.","animation: short 50-100ms, transition: hover states, @media (hover: hover) for desktop, :active for press, haptic-feedback CSS/API, loading animation smooth loop","☐ Micro-animations 50-100ms, ☐ Gesture-responsive, ☐ Tactile feedback visual/haptic, ☐ Loading spinners smooth, ☐ Success/error states clear, ☐ Hover effects subtle","--micro-animation-duration: 50-100ms, --gesture-responsive: true, --haptic-feedback: true, --loading-animation: smooth, --state-feedback: success+error"
18
+ 17,Inclusive Design,"Design for universal accessibility: high contrast (7:1+), large text (16px+), keyboard-only navigation, screen reader optimization, WCAG AAA compliance, symbol-based color indicators (not color-only), haptic feedback, voice interaction support, reduced motion options.","aria-* attributes complete, role attributes semantic, focus-visible: 3-4px ring, color-contrast: 7:1+, @media (prefers-reduced-motion), alt text on all images, form labels properly associated","☐ WCAG AAA verified, ☐ 7:1+ contrast all text, ☐ Keyboard accessible (Tab/Enter), ☐ Screen reader tested, ☐ Focus visible 3-4px, ☐ No color-only indicators, ☐ Haptic fallback","--contrast-ratio: 7:1, --font-size: 16px+, --keyboard-accessible: true, --sr-compatible: true, --wcag-level: AAA, --color-symbols: true, --haptic: enabled"
19
+ 18,Zero Interface,"Create a voice-first, gesture-based, AI-driven interface with minimal visible UI, progressive disclosure, voice recognition UI, gesture detection, AI predictions, smart suggestions, context-aware actions. Hide controls until needed.","voice-commands: Web Speech API, gesture-detection: touch events, AI-predictions: hidden by default (reveal on hover), progressive-disclosure: show on demand, minimal UI visible","☐ Voice commands responsive, ☐ Gesture detection active, ☐ AI predictions hidden/revealed, ☐ Progressive disclosure working, ☐ Minimal visible UI, ☐ Smart suggestions contextual","--voice-ui: enabled, --gesture-detection: active, --ai-predictions: smart, --progressive-disclosure: true, --visible-ui: minimal, --context-aware: true"
20
+ 19,Soft UI Evolution,"Design evolved neumorphism with improved contrast (WCAG AA+), modern aesthetics, subtle depth, accessibility focus. Use soft shadows (softer than flat but clearer than pure neumorphism), better color hierarchy, improved focus states, modern 200-300ms animations.","box-shadow: softer multi-layer (0 2px 4px), background: improved contrast pastels, border-radius: 8-12px, animation: 200-300ms smooth, outline: 2-3px on focus, contrast: 4.5:1+","☐ Improved contrast AA/AAA, ☐ Soft shadows modern, ☐ Border-radius 8-12px, ☐ Animations 200-300ms, ☐ Focus states visible, ☐ Color hierarchy clear","--shadow-soft: modern blend, --border-radius: 10px, --animation-duration: 200-300ms, --contrast-ratio: 4.5:1+, --color-hierarchy: improved, --wcag-level: AA+"
21
+ 20,Bento Grids,"Design a Bento Grid layout. Use: modular grid system, rounded corners (16-24px), different card sizes (1x1, 2x1, 2x2), card-based hierarchy, soft backgrounds (#F5F5F7), subtle borders, content-first, Apple-style aesthetic.","display: grid, grid-template-columns: repeat(auto-fit, minmax(...)), gap: 1rem, border-radius: 20px, background: #FFF, box-shadow: subtle","☐ Grid layout (CSS Grid), ☐ Rounded corners 16-24px, ☐ Varied card spans, ☐ Content fits card size, ☐ Responsive re-flow, ☐ Apple-like aesthetic","--grid-gap: 20px, --card-radius: 24px, --card-bg: #FFFFFF, --page-bg: #F5F5F7, --shadow: soft"
22
+ 21,Neubrutalism,"Design a neubrutalist interface. Use: high contrast, hard black borders (3px+), bright pop colors, no blur, sharp or slightly rounded corners, bold typography, hard shadows (offset 4px 4px), raw aesthetic but functional.","border: 3px solid black, box-shadow: 5px 5px 0px black, colors: #FFDB58 #FF6B6B #4ECDC4, font-weight: 700, no gradients","☐ Hard borders (2-4px), ☐ Hard offset shadows, ☐ High saturation colors, ☐ Bold typography, ☐ No blurs/gradients, ☐ Distinctive 'ugly-cute' look","--border-width: 3px, --shadow-offset: 4px, --shadow-color: #000, --colors: high saturation, --font: bold sans"
23
+ 22,HUD / Sci-Fi FUI,"Design a futuristic HUD (Heads Up Display) or FUI. Use: thin lines (1px), neon cyan/blue on black, technical markers, decorative brackets, data visualization, monospaced tech fonts, glowing elements, transparency.","border: 1px solid rgba(0,255,255,0.5), color: #00FFFF, background: transparent or rgba(0,0,0,0.8), font-family: monospace, text-shadow: 0 0 5px cyan","☐ Fine lines 1px, ☐ Neon glow text/borders, ☐ Monospaced font, ☐ Dark/Transparent BG, ☐ Decorative tech markers, ☐ Holographic feel","--hud-color: #00FFFF, --bg-color: rgba(0,10,20,0.9), --line-width: 1px, --glow: 0 0 5px, --font: monospace"
24
+ 23,Pixel Art,"Design a pixel art inspired interface. Use: pixelated fonts, 8-bit or 16-bit aesthetic, sharp edges (image-rendering: pixelated), limited color palette, blocky UI elements, retro gaming feel.","font-family: 'Press Start 2P', image-rendering: pixelated, box-shadow: 4px 0 0 #000 (pixel border), no anti-aliasing","☐ Pixelated fonts loaded, ☐ Images sharp (no blur), ☐ CSS box-shadow for pixel borders, ☐ Retro palette, ☐ Blocky layout","--pixel-size: 4px, --font: pixel font, --border-style: pixel-shadow, --anti-alias: none"
@@ -0,0 +1,53 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Widgets,Use StatelessWidget when possible,Immutable widgets are simpler,StatelessWidget for static UI,StatefulWidget for everything,class MyWidget extends StatelessWidget,class MyWidget extends StatefulWidget (static),Medium,https://api.flutter.dev/flutter/widgets/StatelessWidget-class.html
3
+ 2,Widgets,Keep widgets small,Single responsibility principle,Extract widgets into smaller pieces,Large build methods,Column(children: [Header() Content()]),500+ line build method,Medium,
4
+ 3,Widgets,Use const constructors,Compile-time constants for performance,const MyWidget() when possible,Non-const for static widgets,const Text('Hello'),Text('Hello') for literals,High,https://dart.dev/guides/language/language-tour#constant-constructors
5
+ 4,Widgets,Prefer composition over inheritance,Combine widgets using children,Compose widgets,Extend widget classes,Container(child: MyContent()),class MyContainer extends Container,Medium,
6
+ 5,State,Use setState correctly,Minimal state in StatefulWidget,setState for UI state changes,setState for business logic,setState(() { _counter++; }),Complex logic in setState,Medium,https://api.flutter.dev/flutter/widgets/State/setState.html
7
+ 6,State,Avoid setState in build,Never call setState during build,setState in callbacks only,setState in build method,onPressed: () => setState(() {}),build() { setState(); },High,
8
+ 7,State,Use state management for complex apps,Provider Riverpod BLoC,State management for shared state,setState for global state,Provider.of<MyState>(context),Global setState calls,Medium,
9
+ 8,State,Prefer Riverpod or Provider,Recommended state solutions,Riverpod for new projects,InheritedWidget manually,ref.watch(myProvider),Custom InheritedWidget,Medium,https://riverpod.dev/
10
+ 9,State,Dispose resources,Clean up controllers and subscriptions,dispose() for cleanup,Memory leaks from subscriptions,@override void dispose() { controller.dispose(); },No dispose implementation,High,
11
+ 10,Layout,Use Column and Row,Basic layout widgets,Column Row for linear layouts,Stack for simple layouts,"Column(children: [Text(), Button()])",Stack for vertical list,Medium,https://api.flutter.dev/flutter/widgets/Column-class.html
12
+ 11,Layout,Use Expanded and Flexible,Control flex behavior,Expanded to fill space,Fixed sizes in flex containers,Expanded(child: Container()),Container(width: 200) in Row,Medium,
13
+ 12,Layout,Use SizedBox for spacing,Consistent spacing,SizedBox for gaps,Container for spacing only,SizedBox(height: 16),Container(height: 16),Low,
14
+ 13,Layout,Use LayoutBuilder for responsive,Respond to constraints,LayoutBuilder for adaptive layouts,Fixed sizes for responsive,LayoutBuilder(builder: (context constraints) {}),Container(width: 375),Medium,https://api.flutter.dev/flutter/widgets/LayoutBuilder-class.html
15
+ 14,Layout,Avoid deep nesting,Keep widget tree shallow,Extract deeply nested widgets,10+ levels of nesting,Extract widget to method or class,Column(Row(Column(Row(...)))),Medium,
16
+ 15,Lists,Use ListView.builder,Lazy list building,ListView.builder for long lists,ListView with children for large lists,"ListView.builder(itemCount: 100, itemBuilder: ...)",ListView(children: items.map(...).toList()),High,https://api.flutter.dev/flutter/widgets/ListView-class.html
17
+ 16,Lists,Provide itemExtent when known,Skip measurement,itemExtent for fixed height items,No itemExtent for uniform lists,ListView.builder(itemExtent: 50),ListView.builder without itemExtent,Medium,
18
+ 17,Lists,Use keys for stateful items,Preserve widget state,Key for stateful list items,No key for dynamic lists,ListTile(key: ValueKey(item.id)),ListTile without key,High,
19
+ 18,Lists,Use SliverList for custom scroll,Custom scroll effects,CustomScrollView with Slivers,Nested ListViews,CustomScrollView(slivers: [SliverList()]),ListView inside ListView,Medium,https://api.flutter.dev/flutter/widgets/SliverList-class.html
20
+ 19,Navigation,Use Navigator 2.0 or GoRouter,Declarative routing,go_router for navigation,Navigator.push for complex apps,GoRouter(routes: [...]),Navigator.push everywhere,Medium,https://pub.dev/packages/go_router
21
+ 20,Navigation,Use named routes,Organized navigation,Named routes for clarity,Anonymous routes,Navigator.pushNamed(context '/home'),Navigator.push(context MaterialPageRoute()),Low,
22
+ 21,Navigation,Handle back button (PopScope),Android back behavior and predictive back (Android 14+),Use PopScope widget (WillPopScope is deprecated),Use WillPopScope,"PopScope(canPop: false, onPopInvoked: (didPop) => ...)",WillPopScope(onWillPop: ...),High,https://api.flutter.dev/flutter/widgets/PopScope-class.html
23
+ 22,Navigation,Pass typed arguments,Type-safe route arguments,Typed route arguments,Dynamic arguments,MyRoute(id: '123'),arguments: {'id': '123'},Medium,
24
+ 23,Async,Use FutureBuilder,Async UI building,FutureBuilder for async data,setState for async,FutureBuilder(future: fetchData()),fetchData().then((d) => setState()),Medium,https://api.flutter.dev/flutter/widgets/FutureBuilder-class.html
25
+ 24,Async,Use StreamBuilder,Stream UI building,StreamBuilder for streams,Manual stream subscription,StreamBuilder(stream: myStream),stream.listen in initState,Medium,https://api.flutter.dev/flutter/widgets/StreamBuilder-class.html
26
+ 25,Async,Handle loading and error states,Complete async UI states,ConnectionState checks,Only success state,if (snapshot.connectionState == ConnectionState.waiting),No loading indicator,High,
27
+ 26,Async,Cancel subscriptions,Clean up stream subscriptions,Cancel in dispose,Memory leaks,subscription.cancel() in dispose,No subscription cleanup,High,
28
+ 27,Theming,Use ThemeData,Consistent theming,ThemeData for app theme,Hardcoded colors,Theme.of(context).primaryColor,Color(0xFF123456) everywhere,Medium,https://api.flutter.dev/flutter/material/ThemeData-class.html
29
+ 28,Theming,Use ColorScheme,Material 3 color system,ColorScheme for colors,Individual color properties,colorScheme: ColorScheme.fromSeed(),primaryColor: Colors.blue,Medium,
30
+ 29,Theming,Access theme via context,Dynamic theme access,Theme.of(context),Static theme reference,Theme.of(context).textTheme.bodyLarge,TextStyle(fontSize: 16),Medium,
31
+ 30,Theming,Support dark mode,Respect system theme,darkTheme in MaterialApp,Light theme only,"MaterialApp(theme: light, darkTheme: dark)",MaterialApp(theme: light),Medium,
32
+ 31,Animation,Use implicit animations,Simple animations,AnimatedContainer AnimatedOpacity,Explicit for simple transitions,AnimatedContainer(duration: Duration()),AnimationController for fade,Low,https://api.flutter.dev/flutter/widgets/AnimatedContainer-class.html
33
+ 32,Animation,Use AnimationController for complex,Fine-grained control,AnimationController with Ticker,Implicit for complex sequences,AnimationController(vsync: this),AnimatedContainer for staggered,Medium,
34
+ 33,Animation,Dispose AnimationControllers,Clean up animation resources,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
35
+ 34,Animation,Use Hero for transitions,Shared element transitions,Hero for navigation animations,Manual shared element,Hero(tag: 'image' child: Image()),Custom shared element animation,Low,https://api.flutter.dev/flutter/widgets/Hero-class.html
36
+ 35,Forms,Use Form widget,Form validation,Form with GlobalKey,Individual validation,Form(key: _formKey child: ...),TextField without Form,Medium,https://api.flutter.dev/flutter/widgets/Form-class.html
37
+ 36,Forms,Use TextEditingController,Control text input,Controller for text fields,onChanged for all text,final controller = TextEditingController(),onChanged: (v) => setState(),Medium,
38
+ 37,Forms,Validate on submit,Form validation flow,_formKey.currentState!.validate(),Skip validation,if (_formKey.currentState!.validate()),Submit without validation,High,
39
+ 38,Forms,Dispose controllers,Clean up text controllers,dispose() for controllers,Memory leaks,controller.dispose() in dispose,No controller disposal,High,
40
+ 39,Performance,Use const widgets,Reduce rebuilds,const for static widgets,No const for literals,const Icon(Icons.add),Icon(Icons.add),High,
41
+ 40,Performance,Avoid rebuilding entire tree,Minimal rebuild scope,Isolate changing widgets,setState on parent,Consumer only around changing widget,setState on root widget,High,
42
+ 41,Performance,Use RepaintBoundary,Isolate repaints,RepaintBoundary for animations,Full screen repaints,RepaintBoundary(child: AnimatedWidget()),Animation without boundary,Medium,https://api.flutter.dev/flutter/widgets/RepaintBoundary-class.html
43
+ 42,Performance,Profile with DevTools,Measure before optimizing,Flutter DevTools profiling,Guess at performance,DevTools performance tab,Optimize without measuring,Medium,https://docs.flutter.dev/tools/devtools
44
+ 43,Accessibility,Use Semantics widget,Screen reader support,Semantics for accessibility,Missing accessibility info,Semantics(label: 'Submit button'),GestureDetector without semantics,High,https://api.flutter.dev/flutter/widgets/Semantics-class.html
45
+ 44,Accessibility,Support large fonts,MediaQuery text scaling,MediaQuery.textScaleFactor,Fixed font sizes,style: Theme.of(context).textTheme,TextStyle(fontSize: 14),High,
46
+ 45,Accessibility,Test with screen readers,TalkBack and VoiceOver,Test accessibility regularly,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
47
+ 46,Testing,Use widget tests,Test widget behavior,WidgetTester for UI tests,Unit tests only,testWidgets('...' (tester) async {}),Only test() for UI,Medium,https://docs.flutter.dev/testing
48
+ 47,Testing,Use integration tests,Full app testing,integration_test package,Manual testing only,IntegrationTestWidgetsFlutterBinding,Manual E2E testing,Medium,
49
+ 48,Testing,Mock dependencies,Isolate tests,Mockito or mocktail,Real dependencies in tests,when(mock.method()).thenReturn(),Real API calls in tests,Medium,
50
+ 49,Platform,Use Platform checks,Platform-specific code,Platform.isIOS Platform.isAndroid,Same code for all platforms,if (Platform.isIOS) {},Hardcoded iOS behavior,Medium,
51
+ 50,Platform,Use kIsWeb for web,Web platform detection,kIsWeb for web checks,Platform for web,if (kIsWeb) {},Platform.isWeb (doesn't exist),Medium,
52
+ 51,Packages,Use pub.dev packages,Community packages,Popular maintained packages,Custom implementations,cached_network_image,Custom image cache,Medium,https://pub.dev/
53
+ 52,Packages,Check package quality,Quality before adding,Pub points and popularity,Any package without review,100+ pub points,Unmaintained packages,Medium,
@@ -0,0 +1,56 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Animation,Use Tailwind animate utilities,Built-in animations are optimized and respect reduced-motion,Use animate-pulse animate-spin animate-ping,Custom @keyframes for simple effects,animate-pulse,@keyframes pulse {...},Medium,https://tailwindcss.com/docs/animation
3
+ 2,Animation,Limit bounce animations,Continuous bounce is distracting and causes motion sickness,Use animate-bounce sparingly on CTAs only,Multiple bounce animations on page,Single CTA with animate-bounce,5+ elements with animate-bounce,High,
4
+ 3,Animation,Transition duration,Use appropriate transition speeds for UI feedback,duration-150 to duration-300 for UI,duration-1000 or longer for UI elements,transition-all duration-200,transition-all duration-1000,Medium,https://tailwindcss.com/docs/transition-duration
5
+ 4,Animation,Hover transitions,Add smooth transitions on hover state changes,Add transition class with hover states,Instant hover changes without transition,hover:bg-gray-100 transition-colors,hover:bg-gray-100 (no transition),Low,
6
+ 5,Z-Index,Use Tailwind z-* scale,Consistent stacking context with predefined scale,z-0 z-10 z-20 z-30 z-40 z-50,Arbitrary z-index values,z-50 for modals,z-[9999],Medium,https://tailwindcss.com/docs/z-index
7
+ 6,Z-Index,Fixed elements z-index,Fixed navigation and modals need explicit z-index,z-50 for nav z-40 for dropdowns,Relying on DOM order for stacking,fixed top-0 z-50,fixed top-0 (no z-index),High,
8
+ 7,Z-Index,Negative z-index for backgrounds,Use negative z-index for decorative backgrounds,z-[-1] for background elements,Positive z-index for backgrounds,-z-10 for decorative,z-10 for background,Low,
9
+ 8,Layout,Container max-width,Limit content width for readability,max-w-7xl mx-auto for main content,Full-width content on large screens,max-w-7xl mx-auto px-4,w-full (no max-width),Medium,https://tailwindcss.com/docs/container
10
+ 9,Layout,Responsive padding,Adjust padding for different screen sizes,px-4 md:px-6 lg:px-8,Same padding all sizes,px-4 sm:px-6 lg:px-8,px-8 (same all sizes),Medium,
11
+ 10,Layout,Grid gaps,Use consistent gap utilities for spacing,gap-4 gap-6 gap-8,Margins on individual items,grid gap-6,grid with mb-4 on each item,Medium,https://tailwindcss.com/docs/gap
12
+ 11,Layout,Flexbox alignment,Use flex utilities for alignment,items-center justify-between,Multiple nested wrappers,flex items-center justify-between,Nested divs for alignment,Low,
13
+ 12,Images,Aspect ratio,Maintain consistent image aspect ratios,aspect-video aspect-square,No aspect ratio on containers,aspect-video rounded-lg,No aspect control,Medium,https://tailwindcss.com/docs/aspect-ratio
14
+ 13,Images,Object fit,Control image scaling within containers,object-cover object-contain,Stretched distorted images,object-cover w-full h-full,No object-fit,Medium,https://tailwindcss.com/docs/object-fit
15
+ 14,Images,Lazy loading,Defer loading of off-screen images,loading='lazy' on images,All images eager load,<img loading='lazy'>,<img> without lazy,High,
16
+ 15,Images,Responsive images,Serve appropriate image sizes,srcset and sizes attributes,Same large image all devices,srcset with multiple sizes,4000px image everywhere,High,
17
+ 16,Typography,Prose plugin,Use @tailwindcss/typography for rich text,prose prose-lg for article content,Custom styles for markdown,prose prose-lg max-w-none,Custom text styling,Medium,https://tailwindcss.com/docs/typography-plugin
18
+ 17,Typography,Line height,Use appropriate line height for readability,leading-relaxed for body text,Default tight line height,leading-relaxed (1.625),leading-none or leading-tight,Medium,https://tailwindcss.com/docs/line-height
19
+ 18,Typography,Font size scale,Use consistent text size scale,text-sm text-base text-lg text-xl,Arbitrary font sizes,text-lg,text-[17px],Low,https://tailwindcss.com/docs/font-size
20
+ 19,Typography,Text truncation,Handle long text gracefully,truncate or line-clamp-*,Overflow breaking layout,line-clamp-2,No overflow handling,Medium,https://tailwindcss.com/docs/text-overflow
21
+ 20,Colors,Opacity utilities,Use color opacity utilities,bg-black/50 text-white/80,Separate opacity class,bg-black/50,bg-black opacity-50,Low,https://tailwindcss.com/docs/background-color
22
+ 21,Colors,Dark mode,Support dark mode with dark: prefix,dark:bg-gray-900 dark:text-white,No dark mode support,dark:bg-gray-900,Only light theme,Medium,https://tailwindcss.com/docs/dark-mode
23
+ 22,Colors,Semantic colors,Use semantic color naming in config,primary secondary danger success,Generic color names in components,bg-primary,bg-blue-500 everywhere,Medium,
24
+ 23,Spacing,Consistent spacing scale,Use Tailwind spacing scale consistently,p-4 m-6 gap-8,Arbitrary pixel values,p-4 (1rem),p-[15px],Low,https://tailwindcss.com/docs/customizing-spacing
25
+ 24,Spacing,Negative margins,Use sparingly for overlapping effects,-mt-4 for overlapping elements,Negative margins for layout fixing,-mt-8 for card overlap,-m-2 to fix spacing issues,Medium,
26
+ 25,Spacing,Space between,Use space-y-* for vertical lists,space-y-4 on flex/grid column,Margin on each child,space-y-4,Each child has mb-4,Low,https://tailwindcss.com/docs/space
27
+ 26,Forms,Focus states,Always show focus indicators,focus:ring-2 focus:ring-blue-500,Remove focus outline,focus:ring-2 focus:ring-offset-2,focus:outline-none (no replacement),High,
28
+ 27,Forms,Input sizing,Consistent input dimensions,h-10 px-3 for inputs,Inconsistent input heights,h-10 w-full px-3,Various heights per input,Medium,
29
+ 28,Forms,Disabled states,Clear disabled styling,disabled:opacity-50 disabled:cursor-not-allowed,No disabled indication,disabled:opacity-50,Same style as enabled,Medium,
30
+ 29,Forms,Placeholder styling,Style placeholder text appropriately,placeholder:text-gray-400,Dark placeholder text,placeholder:text-gray-400,Default dark placeholder,Low,
31
+ 30,Responsive,Mobile-first approach,Start with mobile styles and add breakpoints,Default mobile + md: lg: xl:,Desktop-first approach,text-sm md:text-base,text-base max-md:text-sm,Medium,https://tailwindcss.com/docs/responsive-design
32
+ 31,Responsive,Breakpoint testing,Test at standard breakpoints,320 375 768 1024 1280 1536,Only test on development device,Test all breakpoints,Single device testing,High,
33
+ 32,Responsive,Hidden/shown utilities,Control visibility per breakpoint,hidden md:block,Different content per breakpoint,hidden md:flex,Separate mobile/desktop components,Low,https://tailwindcss.com/docs/display
34
+ 33,Buttons,Button sizing,Consistent button dimensions,px-4 py-2 or px-6 py-3,Inconsistent button sizes,px-4 py-2 text-sm,Various padding per button,Medium,
35
+ 34,Buttons,Touch targets,Minimum 44px touch target on mobile,min-h-[44px] on mobile,Small buttons on mobile,min-h-[44px] min-w-[44px],h-8 w-8 on mobile,High,
36
+ 35,Buttons,Loading states,Show loading feedback,disabled + spinner icon,Clickable during loading,<Button disabled><Spinner/></Button>,Button without loading state,High,
37
+ 36,Buttons,Icon buttons,Accessible icon-only buttons,aria-label on icon buttons,Icon button without label,<button aria-label='Close'><XIcon/></button>,<button><XIcon/></button>,High,
38
+ 37,Cards,Card structure,Consistent card styling,rounded-lg shadow-md p-6,Inconsistent card styles,rounded-2xl shadow-lg p-6,Mixed card styling,Low,
39
+ 38,Cards,Card hover states,Interactive cards should have hover feedback,hover:shadow-lg transition-shadow,No hover on clickable cards,hover:shadow-xl transition-shadow,Static cards that are clickable,Medium,
40
+ 39,Cards,Card spacing,Consistent internal card spacing,space-y-4 for card content,Inconsistent internal spacing,space-y-4 or p-6,Mixed mb-2 mb-4 mb-6,Low,
41
+ 40,Accessibility,Screen reader text,Provide context for screen readers,sr-only for hidden labels,Missing context for icons,<span class='sr-only'>Close menu</span>,No label for icon button,High,https://tailwindcss.com/docs/screen-readers
42
+ 41,Accessibility,Focus visible,Show focus only for keyboard users,focus-visible:ring-2,Focus on all interactions,focus-visible:ring-2,focus:ring-2 (shows on click too),Medium,
43
+ 42,Accessibility,Reduced motion,Respect user motion preferences,motion-reduce:animate-none,Ignore motion preferences,motion-reduce:transition-none,No reduced motion support,High,https://tailwindcss.com/docs/hover-focus-and-other-states#prefers-reduced-motion
44
+ 43,Performance,Configure content paths,Tailwind needs to know where classes are used,Use 'content' array in config,Use deprecated 'purge' option (v2),"content: ['./src/**/*.{js,ts,jsx,tsx}']",purge: [...],High,https://tailwindcss.com/docs/content-configuration
45
+ 44,Performance,JIT mode,Use JIT for faster builds and smaller bundles,JIT enabled (default in v3),Full CSS in development,Tailwind v3 defaults,Tailwind v2 without JIT,Medium,
46
+ 45,Performance,Avoid @apply bloat,Use @apply sparingly,Direct utilities in HTML,Heavy @apply usage,class='px-4 py-2 rounded',@apply px-4 py-2 rounded;,Low,https://tailwindcss.com/docs/reusing-styles
47
+ 46,Plugins,Official plugins,Use official Tailwind plugins,@tailwindcss/forms typography aspect-ratio,Custom implementations,@tailwindcss/forms,Custom form reset CSS,Medium,https://tailwindcss.com/docs/plugins
48
+ 47,Plugins,Custom utilities,Create utilities for repeated patterns,Custom utility in config,Repeated arbitrary values,Custom shadow utility,"shadow-[0_4px_20px_rgba(0,0,0,0.1)] everywhere",Medium,
49
+ 48,Layout,Container Queries,Use @container for component-based responsiveness,Use @container and @lg: etc.,Media queries for component internals,@container @lg:grid-cols-2,@media (min-width: ...) inside component,Medium,https://github.com/tailwindlabs/tailwindcss-container-queries
50
+ 49,Interactivity,Group and Peer,Style based on parent/sibling state,group-hover peer-checked,JS for simple state interactions,group-hover:text-blue-500,onMouseEnter={() => setHover(true)},Low,https://tailwindcss.com/docs/hover-focus-and-other-states#styling-based-on-parent-state
51
+ 50,Customization,Arbitrary Values,Use [] for one-off values,w-[350px] for specific needs,Creating config for single use,top-[117px] (if strictly needed),style={{ top: '117px' }},Low,https://tailwindcss.com/docs/adding-custom-styles#using-arbitrary-values
52
+ 51,Colors,Theme color variables,Define colors in Tailwind theme and use directly,bg-primary text-success border-cta,bg-[var(--color-primary)] text-[var(--color-success)],bg-primary,bg-[var(--color-primary)],Medium,https://tailwindcss.com/docs/customizing-colors
53
+ 52,Colors,Use bg-linear-to-* for gradients,Tailwind v4 uses bg-linear-to-* syntax for gradients,bg-linear-to-r bg-linear-to-b,bg-gradient-to-* (deprecated in v4),bg-linear-to-r from-blue-500 to-purple-500,bg-gradient-to-r from-blue-500 to-purple-500,Medium,https://tailwindcss.com/docs/background-image
54
+ 53,Layout,Use shrink-0 shorthand,Shorter class name for flex-shrink-0,shrink-0 shrink,flex-shrink-0 flex-shrink,shrink-0,flex-shrink-0,Low,https://tailwindcss.com/docs/flex-shrink
55
+ 54,Layout,Use size-* for square dimensions,Single utility for equal width and height,size-4 size-8 size-12,Separate h-* w-* for squares,size-6,h-6 w-6,Low,https://tailwindcss.com/docs/size
56
+ 55,Images,SVG explicit dimensions,Add width/height attributes to SVGs to prevent layout shift before CSS loads,<svg class='size-6' width='24' height='24'>,SVG without explicit dimensions,<svg class='size-6' width='24' height='24'>,<svg class='size-6'>,High,
@@ -0,0 +1,53 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Routing,Use App Router for new projects,App Router is the recommended approach in Next.js 14+,app/ directory with page.tsx,pages/ for new projects,app/dashboard/page.tsx,pages/dashboard.tsx,Medium,https://nextjs.org/docs/app
3
+ 2,Routing,Use file-based routing,Create routes by adding files in app directory,page.tsx for routes layout.tsx for layouts,Manual route configuration,app/blog/[slug]/page.tsx,Custom router setup,Medium,https://nextjs.org/docs/app/building-your-application/routing
4
+ 3,Routing,Colocate related files,Keep components styles tests with their routes,Component files alongside page.tsx,Separate components folder,app/dashboard/_components/,components/dashboard/,Low,
5
+ 4,Routing,Use route groups for organization,Group routes without affecting URL,Parentheses for route groups,Nested folders affecting URL,(marketing)/about/page.tsx,marketing/about/page.tsx,Low,https://nextjs.org/docs/app/building-your-application/routing/route-groups
6
+ 5,Routing,Handle loading states,Use loading.tsx for route loading UI,loading.tsx alongside page.tsx,Manual loading state management,app/dashboard/loading.tsx,useState for loading in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
7
+ 6,Routing,Handle errors with error.tsx,Catch errors at route level,error.tsx with reset function,try/catch in every component,app/dashboard/error.tsx,try/catch in page component,High,https://nextjs.org/docs/app/building-your-application/routing/error-handling
8
+ 7,Rendering,Use Server Components by default,Server Components reduce client JS bundle,Keep components server by default,Add 'use client' unnecessarily,export default function Page(),('use client') for static content,High,https://nextjs.org/docs/app/building-your-application/rendering/server-components
9
+ 8,Rendering,Mark Client Components explicitly,'use client' for interactive components,Add 'use client' only when needed,Server Component with hooks/events,('use client') for onClick useState,No directive with useState,High,https://nextjs.org/docs/app/building-your-application/rendering/client-components
10
+ 9,Rendering,Push Client Components down,Keep Client Components as leaf nodes,Client wrapper for interactive parts only,Mark page as Client Component,<InteractiveButton/> in Server Page,('use client') on page.tsx,High,
11
+ 10,Rendering,Use streaming for better UX,Stream content with Suspense boundaries,Suspense for slow data fetches,Wait for all data before render,<Suspense><SlowComponent/></Suspense>,await allData then render,Medium,https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming
12
+ 11,Rendering,Choose correct rendering strategy,SSG for static SSR for dynamic ISR for semi-static,generateStaticParams for known paths,SSR for static content,export const revalidate = 3600,fetch without cache config,Medium,
13
+ 12,DataFetching,Fetch data in Server Components,Fetch directly in async Server Components,async function Page() { const data = await fetch() },useEffect for initial data,const data = await fetch(url),useEffect(() => fetch(url)),High,https://nextjs.org/docs/app/building-your-application/data-fetching
14
+ 13,DataFetching,Configure caching explicitly (Next.js 15+),Next.js 15 changed defaults to uncached for fetch,Explicitly set cache: 'force-cache' for static data,Assume default is cached (it's not in Next.js 15),fetch(url { cache: 'force-cache' }),fetch(url) // Uncached in v15,High,https://nextjs.org/docs/app/building-your-application/upgrading/version-15
15
+ 14,DataFetching,Deduplicate fetch requests,React and Next.js dedupe same requests,Same fetch call in multiple components,Manual request deduplication,Multiple components fetch same URL,Custom cache layer,Low,
16
+ 15,DataFetching,Use Server Actions for mutations,Server Actions for form submissions,action={serverAction} in forms,API route for every mutation,<form action={createPost}>,<form onSubmit={callApiRoute}>,Medium,https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations
17
+ 16,DataFetching,Revalidate data appropriately,Use revalidatePath/revalidateTag after mutations,Revalidate after Server Action,'use client' with manual refetch,revalidatePath('/posts'),router.refresh() everywhere,Medium,https://nextjs.org/docs/app/building-your-application/caching#revalidating
18
+ 17,Images,Use next/image for optimization,Automatic image optimization and lazy loading,<Image> component for all images,<img> tags directly,<Image src={} alt={} width={} height={}>,<img src={}/>,High,https://nextjs.org/docs/app/building-your-application/optimizing/images
19
+ 18,Images,Provide width and height,Prevent layout shift with dimensions,width and height props or fill,Missing dimensions,<Image width={400} height={300}/>,<Image src={url}/>,High,
20
+ 19,Images,Use fill for responsive images,Fill container with object-fit,fill prop with relative parent,Fixed dimensions for responsive,"<Image fill className=""object-cover""/>",<Image width={window.width}/>,Medium,
21
+ 20,Images,Configure remote image domains,Whitelist external image sources,remotePatterns in next.config.js,Allow all domains,remotePatterns: [{ hostname: 'cdn.example.com' }],domains: ['*'],High,https://nextjs.org/docs/app/api-reference/components/image#remotepatterns
22
+ 21,Images,Use priority for LCP images,Mark above-fold images as priority,priority prop on hero images,All images with priority,<Image priority src={hero}/>,<Image priority/> on every image,Medium,
23
+ 22,Fonts,Use next/font for fonts,Self-hosted fonts with zero layout shift,next/font/google or next/font/local,External font links,import { Inter } from 'next/font/google',"<link href=""fonts.googleapis.com""/>",Medium,https://nextjs.org/docs/app/building-your-application/optimizing/fonts
24
+ 23,Fonts,Apply font to layout,Set font in root layout for consistency,className on body in layout.tsx,Font in individual pages,<body className={inter.className}>,Each page imports font,Low,
25
+ 24,Fonts,Use variable fonts,Variable fonts reduce bundle size,Single variable font file,Multiple font weights as files,Inter({ subsets: ['latin'] }),Inter_400 Inter_500 Inter_700,Low,
26
+ 25,Metadata,Use generateMetadata for dynamic,Generate metadata based on params,export async function generateMetadata(),Hardcoded metadata everywhere,generateMetadata({ params }),export const metadata = {},Medium,https://nextjs.org/docs/app/building-your-application/optimizing/metadata
27
+ 26,Metadata,Include OpenGraph images,Add OG images for social sharing,opengraph-image.tsx or og property,Missing social preview images,opengraph: { images: ['/og.png'] },No OG configuration,Medium,
28
+ 27,Metadata,Use metadata API,Export metadata object for static metadata,export const metadata = {},Manual head tags,export const metadata = { title: 'Page' },<head><title>Page</title></head>,Medium,
29
+ 28,API,Use Route Handlers for APIs,app/api routes for API endpoints,app/api/users/route.ts,pages/api for new projects,export async function GET(request),export default function handler,Medium,https://nextjs.org/docs/app/building-your-application/routing/route-handlers
30
+ 29,API,Return proper Response objects,Use NextResponse for API responses,NextResponse.json() for JSON,Plain objects or res.json(),return NextResponse.json({ data }),return { data },Medium,
31
+ 30,API,Handle HTTP methods explicitly,Export named functions for methods,Export GET POST PUT DELETE,Single handler for all methods,export async function POST(),switch(req.method),Low,
32
+ 31,API,Validate request body,Validate input before processing,Zod or similar for validation,Trust client input,const body = schema.parse(await req.json()),const body = await req.json(),High,
33
+ 32,Middleware,Use middleware for auth,Protect routes with middleware.ts,middleware.ts at root,Auth check in every page,export function middleware(request),if (!session) redirect in page,Medium,https://nextjs.org/docs/app/building-your-application/routing/middleware
34
+ 33,Middleware,Match specific paths,Configure middleware matcher,config.matcher for specific routes,Run middleware on all routes,matcher: ['/dashboard/:path*'],No matcher config,Medium,
35
+ 34,Middleware,Keep middleware edge-compatible,Middleware runs on Edge runtime,Edge-compatible code only,Node.js APIs in middleware,Edge-compatible auth check,fs.readFile in middleware,High,
36
+ 35,Environment,Use NEXT_PUBLIC prefix,Client-accessible env vars need prefix,NEXT_PUBLIC_ for client vars,Server vars exposed to client,NEXT_PUBLIC_API_URL,API_SECRET in client code,High,https://nextjs.org/docs/app/building-your-application/configuring/environment-variables
37
+ 36,Environment,Validate env vars,Check required env vars exist,Validate on startup,Undefined env at runtime,if (!process.env.DATABASE_URL) throw,process.env.DATABASE_URL (might be undefined),High,
38
+ 37,Environment,Use .env.local for secrets,Local env file for development secrets,.env.local gitignored,Secrets in .env committed,.env.local with secrets,.env with DATABASE_PASSWORD,High,
39
+ 38,Performance,Analyze bundle size,Use @next/bundle-analyzer,Bundle analyzer in dev,Ship large bundles blindly,ANALYZE=true npm run build,No bundle analysis,Medium,https://nextjs.org/docs/app/building-your-application/optimizing/bundle-analyzer
40
+ 39,Performance,Use dynamic imports,Code split with next/dynamic,dynamic() for heavy components,Import everything statically,const Chart = dynamic(() => import('./Chart')),import Chart from './Chart',Medium,https://nextjs.org/docs/app/building-your-application/optimizing/lazy-loading
41
+ 40,Performance,Avoid layout shifts,Reserve space for dynamic content,Skeleton loaders aspect ratios,Content popping in,"<Skeleton className=""h-48""/>",No placeholder for async content,High,
42
+ 41,Performance,Use Partial Prerendering,Combine static and dynamic in one route,Static shell with Suspense holes,Full dynamic or static pages,Static header + dynamic content,Entire page SSR,Low,https://nextjs.org/docs/app/building-your-application/rendering/partial-prerendering
43
+ 42,Link,Use next/link for navigation,Client-side navigation with prefetching,"<Link href=""""> for internal links",<a> for internal navigation,"<Link href=""/about"">About</Link>","<a href=""/about"">About</a>",High,https://nextjs.org/docs/app/api-reference/components/link
44
+ 43,Link,Prefetch strategically,Control prefetching behavior,prefetch={false} for low-priority,Prefetch all links,<Link prefetch={false}>,Default prefetch on every link,Low,
45
+ 44,Link,Use scroll option appropriately,Control scroll behavior on navigation,scroll={false} for tabs pagination,Always scroll to top,<Link scroll={false}>,Manual scroll management,Low,
46
+ 45,Config,Use next.config.js correctly,Configure Next.js behavior,Proper config options,Deprecated or wrong options,images: { remotePatterns: [] },images: { domains: [] },Medium,https://nextjs.org/docs/app/api-reference/next-config-js
47
+ 46,Config,Enable strict mode,Catch potential issues early,reactStrictMode: true,Strict mode disabled,reactStrictMode: true,reactStrictMode: false,Medium,
48
+ 47,Config,Configure redirects and rewrites,Use config for URL management,redirects() rewrites() in config,Manual redirect handling,redirects: async () => [...],res.redirect in pages,Medium,https://nextjs.org/docs/app/api-reference/next-config-js/redirects
49
+ 48,Deployment,Use Vercel for easiest deploy,Vercel optimized for Next.js,Deploy to Vercel,Self-host without knowledge,vercel deploy,Complex Docker setup for simple app,Low,https://nextjs.org/docs/app/building-your-application/deploying
50
+ 49,Deployment,Configure output for self-hosting,Set output option for deployment target,output: 'standalone' for Docker,Default output for containers,output: 'standalone',No output config for Docker,Medium,https://nextjs.org/docs/app/building-your-application/deploying#self-hosting
51
+ 50,Security,Sanitize user input,Never trust user input,Escape sanitize validate all input,Direct interpolation of user data,DOMPurify.sanitize(userInput),dangerouslySetInnerHTML={{ __html: userInput }},High,
52
+ 51,Security,Use CSP headers,Content Security Policy for XSS protection,Configure CSP in next.config.js,No security headers,headers() with CSP,No CSP configuration,High,https://nextjs.org/docs/app/building-your-application/configuring/content-security-policy
53
+ 52,Security,Validate Server Action input,Server Actions are public endpoints,Validate and authorize in Server Action,Trust Server Action input,Auth check + validation in action,Direct database call without check,High,
@@ -0,0 +1,52 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Components,Use functional components,Hooks-based components are standard,Functional components with hooks,Class components,const App = () => { },class App extends Component,Medium,https://reactnative.dev/docs/intro-react
3
+ 2,Components,Keep components small,Single responsibility principle,Split into smaller components,Large monolithic components,<Header /><Content /><Footer />,500+ line component,Medium,
4
+ 3,Components,Use TypeScript,Type safety for props and state,TypeScript for new projects,JavaScript without types,const Button: FC<Props> = () => { },const Button = (props) => { },Medium,
5
+ 4,Components,Colocate component files,Keep related files together,Component folder with styles,Flat structure,components/Button/index.tsx styles.ts,components/Button.tsx styles/button.ts,Low,
6
+ 5,Styling,Use StyleSheet.create,Optimized style objects,StyleSheet for all styles,Inline style objects,StyleSheet.create({ container: {} }),style={{ margin: 10 }},High,https://reactnative.dev/docs/stylesheet
7
+ 6,Styling,Avoid inline styles,Prevent object recreation,Styles in StyleSheet,Inline style objects in render,style={styles.container},"style={{ margin: 10, padding: 5 }}",Medium,
8
+ 7,Styling,Use flexbox for layout,React Native uses flexbox,flexDirection alignItems justifyContent,Absolute positioning everywhere,flexDirection: 'row',position: 'absolute' everywhere,Medium,https://reactnative.dev/docs/flexbox
9
+ 8,Styling,Handle platform differences,Platform-specific styles,Platform.select or .ios/.android files,Same styles for both platforms,"Platform.select({ ios: {}, android: {} })",Hardcoded iOS values,Medium,https://reactnative.dev/docs/platform-specific-code
10
+ 9,Styling,Use responsive dimensions,Scale for different screens,Dimensions or useWindowDimensions,Fixed pixel values,useWindowDimensions(),width: 375,Medium,
11
+ 10,Navigation,Use React Navigation,Standard navigation library,React Navigation for routing,Manual navigation management,createStackNavigator(),Custom navigation state,Medium,https://reactnavigation.org/
12
+ 11,Navigation,Type navigation params,Type-safe navigation,Typed navigation props,Untyped navigation,"navigation.navigate<RootStackParamList>('Home', { id })","navigation.navigate('Home', { id })",Medium,
13
+ 12,Navigation,Use deep linking,Support URL-based navigation,Configure linking prop,No deep link support,linking: { prefixes: [] },No linking configuration,Medium,https://reactnavigation.org/docs/deep-linking/
14
+ 13,Navigation,Handle back button,Android back button handling,useFocusEffect with BackHandler,Ignore back button,BackHandler.addEventListener,No back handler,High,
15
+ 14,State,Use useState for local state,Simple component state,useState for UI state,Class component state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,
16
+ 15,State,Use useReducer for complex state,Complex state logic,useReducer for related state,Multiple useState for related values,useReducer(reducer initialState),5+ useState calls,Medium,
17
+ 16,State,Use context sparingly,Context for global state,Context for theme auth locale,Context for frequently changing data,ThemeContext for app theme,Context for list item data,Medium,
18
+ 17,State,Consider Zustand or Redux,External state management,Zustand for simple Redux for complex,useState for global state,create((set) => ({ })),Prop drilling global state,Medium,
19
+ 18,Lists,Use FlatList for long lists,Virtualized list rendering,FlatList for 50+ items,ScrollView with map,<FlatList data={items} />,<ScrollView>{items.map()}</ScrollView>,High,https://reactnative.dev/docs/flatlist
20
+ 19,Lists,Provide keyExtractor,Unique keys for list items,keyExtractor with stable ID,Index as key,keyExtractor={(item) => item.id},"keyExtractor={(_, index) => index}",High,
21
+ 20,Lists,Optimize renderItem,Memoize list item components,React.memo for list items,Inline render function,renderItem={({ item }) => <MemoizedItem item={item} />},renderItem={({ item }) => <View>...</View>},High,
22
+ 21,Lists,Use getItemLayout for fixed height,Skip measurement for performance,getItemLayout when height known,Dynamic measurement for fixed items,"getItemLayout={(_, index) => ({ length: 50, offset: 50 * index, index })}",No getItemLayout for fixed height,Medium,
23
+ 22,Lists,Implement windowSize,Control render window,Smaller windowSize for memory,Default windowSize for large lists,windowSize={5},windowSize={21} for huge lists,Medium,
24
+ 23,Performance,Use React.memo,Prevent unnecessary re-renders,memo for pure components,No memoization,export default memo(MyComponent),export default MyComponent,Medium,
25
+ 24,Performance,Use useCallback for handlers,Stable function references,useCallback for props,New function on every render,"useCallback(() => {}, [deps])",() => handlePress(),Medium,
26
+ 25,Performance,Use useMemo for expensive ops,Cache expensive calculations,useMemo for heavy computations,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensive(),Medium,
27
+ 26,Performance,Avoid anonymous functions in JSX,Prevent re-renders,Named handlers or useCallback,Inline arrow functions,onPress={handlePress},onPress={() => doSomething()},Medium,
28
+ 27,Performance,Use Hermes engine,Improved startup and memory,Enable Hermes in build,JavaScriptCore for new projects,hermes_enabled: true,hermes_enabled: false,Medium,https://reactnative.dev/docs/hermes
29
+ 28,Images,Use expo-image,Modern performant image component for React Native,"Use expo-image for caching, blurring, and performance",Use default Image for heavy lists or unmaintained libraries,<Image source={url} cachePolicy='memory-disk' /> (expo-image),<FastImage source={url} />,Medium,https://docs.expo.dev/versions/latest/sdk/image/
30
+ 29,Images,Specify image dimensions,Prevent layout shifts,width and height for remote images,No dimensions for network images,<Image style={{ width: 100 height: 100 }} />,<Image source={{ uri }} /> no size,High,
31
+ 30,Images,Use resizeMode,Control image scaling,resizeMode cover contain,Stretch images,"resizeMode=""cover""",No resizeMode,Low,
32
+ 31,Forms,Use controlled inputs,State-controlled form fields,value + onChangeText,Uncontrolled inputs,<TextInput value={text} onChangeText={setText} />,<TextInput defaultValue={text} />,Medium,
33
+ 32,Forms,Handle keyboard,Manage keyboard visibility,KeyboardAvoidingView,Content hidden by keyboard,"<KeyboardAvoidingView behavior=""padding"">",No keyboard handling,High,https://reactnative.dev/docs/keyboardavoidingview
34
+ 33,Forms,Use proper keyboard types,Appropriate keyboard for input,keyboardType for input type,Default keyboard for all,"keyboardType=""email-address""","keyboardType=""default"" for email",Low,
35
+ 34,Touch,Use Pressable,Modern touch handling,Pressable for touch interactions,TouchableOpacity for new code,<Pressable onPress={} />,<TouchableOpacity onPress={} />,Low,https://reactnative.dev/docs/pressable
36
+ 35,Touch,Provide touch feedback,Visual feedback on press,Ripple or opacity change,No feedback on press,android_ripple={{ color: 'gray' }},No press feedback,Medium,
37
+ 36,Touch,Set hitSlop for small targets,Increase touch area,hitSlop for icons and small buttons,Tiny touch targets,hitSlop={{ top: 10 bottom: 10 }},44x44 with no hitSlop,Medium,
38
+ 37,Animation,Use Reanimated,High-performance animations,react-native-reanimated,Animated API for complex,useSharedValue useAnimatedStyle,Animated.timing for gesture,Medium,https://docs.swmansion.com/react-native-reanimated/
39
+ 38,Animation,Run on UI thread,worklets for smooth animation,Run animations on UI thread,JS thread animations,runOnUI(() => {}),Animated on JS thread,High,
40
+ 39,Animation,Use gesture handler,Native gesture recognition,react-native-gesture-handler,JS-based gesture handling,<GestureDetector>,<View onTouchMove={} />,Medium,https://docs.swmansion.com/react-native-gesture-handler/
41
+ 40,Async,Handle loading states,Show loading indicators,ActivityIndicator during load,Empty screen during load,{isLoading ? <ActivityIndicator /> : <Content />},No loading state,Medium,
42
+ 41,Async,Handle errors gracefully,Error boundaries and fallbacks,Error UI for failed requests,Crash on error,{error ? <ErrorView /> : <Content />},No error handling,High,
43
+ 42,Async,Cancel async operations,Cleanup on unmount,AbortController or cleanup,Memory leaks from async,useEffect cleanup,No cleanup for subscriptions,High,
44
+ 43,Accessibility,Add accessibility labels,Describe UI elements,accessibilityLabel for all interactive,Missing labels,"accessibilityLabel=""Submit form""",<Pressable> without label,High,https://reactnative.dev/docs/accessibility
45
+ 44,Accessibility,Use accessibility roles,Semantic meaning,accessibilityRole for elements,Wrong roles,"accessibilityRole=""button""",No role for button,Medium,
46
+ 45,Accessibility,Support screen readers,Test with TalkBack/VoiceOver,Test with screen readers,Skip accessibility testing,Regular TalkBack testing,No screen reader testing,High,
47
+ 46,Testing,Use React Native Testing Library,Component testing,render and fireEvent,Enzyme or manual testing,render(<Component />),shallow(<Component />),Medium,https://callstack.github.io/react-native-testing-library/
48
+ 47,Testing,Test on real devices,Real device behavior,Test on iOS and Android devices,Simulator only,Device testing in CI,Simulator only testing,High,
49
+ 48,Testing,Use Detox for E2E,End-to-end testing,Detox for critical flows,Manual E2E testing,detox test,Manual testing only,Medium,https://wix.github.io/Detox/
50
+ 49,Native,Use native modules carefully,Bridge has overhead,Batch native calls,Frequent bridge crossing,Batch updates,Call native on every keystroke,High,
51
+ 50,Native,Use Expo when possible,Simplified development,Expo for standard features,Bare RN for simple apps,expo install package,react-native link package,Low,https://docs.expo.dev/
52
+ 51,Native,Handle permissions,Request permissions properly,Check and request permissions,Assume permissions granted,PermissionsAndroid.request(),Access without permission check,High,https://reactnative.dev/docs/permissionsandroid
@@ -0,0 +1,54 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,State,Use useState for local state,Simple component state should use useState hook,useState for form inputs toggles counters,Class components this.state,"const [count, setCount] = useState(0)",this.state = { count: 0 },Medium,https://react.dev/reference/react/useState
3
+ 2,State,Lift state up when needed,Share state between siblings by lifting to parent,Lift shared state to common ancestor,Prop drilling through many levels,Parent holds state passes down,Deep prop chains,Medium,https://react.dev/learn/sharing-state-between-components
4
+ 3,State,Use useReducer for complex state,Complex state logic benefits from reducer pattern,useReducer for state with multiple sub-values,Multiple useState for related values,useReducer with action types,5+ useState calls that update together,Medium,https://react.dev/reference/react/useReducer
5
+ 4,State,Avoid unnecessary state,Derive values from existing state when possible,Compute derived values in render,Store derivable values in state,const total = items.reduce(...),"const [total, setTotal] = useState(0)",High,https://react.dev/learn/choosing-the-state-structure
6
+ 5,State,Initialize state lazily,Use function form for expensive initial state,useState(() => computeExpensive()),useState(computeExpensive()),useState(() => JSON.parse(data)),useState(JSON.parse(data)),Medium,https://react.dev/reference/react/useState#avoiding-recreating-the-initial-state
7
+ 6,Effects,Clean up effects,Return cleanup function for subscriptions timers,Return cleanup function in useEffect,No cleanup for subscriptions,useEffect(() => { sub(); return unsub; }),useEffect(() => { subscribe(); }),High,https://react.dev/reference/react/useEffect#connecting-to-an-external-system
8
+ 7,Effects,Specify dependencies correctly,Include all values used inside effect in deps array,All referenced values in dependency array,Empty deps with external references,[value] when using value in effect,[] when using props/state in effect,High,https://react.dev/reference/react/useEffect#specifying-reactive-dependencies
9
+ 8,Effects,Avoid unnecessary effects,Don't use effects for transforming data or events,Transform data during render handle events directly,useEffect for derived state or event handling,const filtered = items.filter(...),useEffect(() => setFiltered(items.filter(...))),High,https://react.dev/learn/you-might-not-need-an-effect
10
+ 9,Effects,Use refs for non-reactive values,Store values that don't trigger re-renders in refs,useRef for interval IDs DOM elements,useState for values that don't need render,const intervalRef = useRef(null),"const [intervalId, setIntervalId] = useState()",Medium,https://react.dev/reference/react/useRef
11
+ 10,Rendering,Use keys properly,Stable unique keys for list items,Use stable IDs as keys,Array index as key for dynamic lists,key={item.id},key={index},High,https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key
12
+ 11,Rendering,Memoize expensive calculations,Use useMemo for costly computations,useMemo for expensive filtering/sorting,Recalculate every render,"useMemo(() => expensive(), [deps])",const result = expensiveCalc(),Medium,https://react.dev/reference/react/useMemo
13
+ 12,Rendering,Memoize callbacks passed to children,Use useCallback for functions passed as props,useCallback for handlers passed to memoized children,New function reference every render,"useCallback(() => {}, [deps])",const handler = () => {},Medium,https://react.dev/reference/react/useCallback
14
+ 13,Rendering,Use React.memo wisely,Wrap components that render often with same props,memo for pure components with stable props,memo everything or nothing,memo(ExpensiveList),memo(SimpleButton),Low,https://react.dev/reference/react/memo
15
+ 14,Rendering,Avoid inline object/array creation in JSX,Create objects outside render or memoize,Define style objects outside component,Inline objects in props,<div style={styles.container}>,<div style={{ margin: 10 }}>,Medium,
16
+ 15,Components,Keep components small and focused,Single responsibility for each component,One concern per component,Large multi-purpose components,<UserAvatar /><UserName />,<UserCard /> with 500 lines,Medium,
17
+ 16,Components,Use composition over inheritance,Compose components using children and props,Use children prop for flexibility,Inheritance hierarchies,<Card>{content}</Card>,class SpecialCard extends Card,Medium,https://react.dev/learn/thinking-in-react
18
+ 17,Components,Colocate related code,Keep related components and hooks together,Related files in same directory,Flat structure with many files,components/User/UserCard.tsx,components/UserCard.tsx + hooks/useUser.ts,Low,
19
+ 18,Components,Use fragments to avoid extra DOM,Fragment or <> for multiple elements without wrapper,<> for grouping without DOM node,Extra div wrappers,<>{items.map(...)}</>,<div>{items.map(...)}</div>,Low,https://react.dev/reference/react/Fragment
20
+ 19,Props,Destructure props,Destructure props for cleaner component code,Destructure in function signature,props.name props.value throughout,"function User({ name, age })",function User(props),Low,
21
+ 20,Props,Provide default props values,Use default parameters or defaultProps,Default values in destructuring,Undefined checks throughout,function Button({ size = 'md' }),if (size === undefined) size = 'md',Low,
22
+ 21,Props,Avoid prop drilling,Use context or composition for deeply nested data,Context for global data composition for UI,Passing props through 5+ levels,<UserContext.Provider>,<A user={u}><B user={u}><C user={u}>,Medium,https://react.dev/learn/passing-data-deeply-with-context
23
+ 22,Props,Validate props with TypeScript,Use TypeScript interfaces for prop types,interface Props { name: string },PropTypes or no validation,interface ButtonProps { onClick: () => void },Button.propTypes = {},Medium,
24
+ 23,Events,Use synthetic events correctly,React normalizes events across browsers,e.preventDefault() e.stopPropagation(),Access native event unnecessarily,onClick={(e) => e.preventDefault()},onClick={(e) => e.nativeEvent.preventDefault()},Low,https://react.dev/reference/react-dom/components/common#react-event-object
25
+ 24,Events,Avoid binding in render,Use arrow functions in class or hooks,Arrow functions in functional components,bind in render or constructor,const handleClick = () => {},this.handleClick.bind(this),Medium,
26
+ 25,Events,Pass event handlers not call results,Pass function reference not invocation,onClick={handleClick},onClick={handleClick()} causing immediate call,onClick={handleClick},onClick={handleClick()},High,
27
+ 26,Forms,Controlled components for forms,Use state to control form inputs,value + onChange for inputs,Uncontrolled inputs with refs,<input value={val} onChange={setVal}>,<input ref={inputRef}>,Medium,https://react.dev/reference/react-dom/components/input#controlling-an-input-with-a-state-variable
28
+ 27,Forms,Handle form submission properly,Prevent default and handle in submit handler,onSubmit with preventDefault,onClick on submit button only,<form onSubmit={handleSubmit}>,<button onClick={handleSubmit}>,Medium,
29
+ 28,Forms,Debounce rapid input changes,Debounce search/filter inputs,useDeferredValue or debounce for search,Filter on every keystroke,useDeferredValue(searchTerm),useEffect filtering on every change,Medium,https://react.dev/reference/react/useDeferredValue
30
+ 29,Hooks,Follow rules of hooks,Only call hooks at top level and in React functions,Hooks at component top level,Hooks in conditions loops or callbacks,"const [x, setX] = useState()","if (cond) { const [x, setX] = useState() }",High,https://react.dev/reference/rules/rules-of-hooks
31
+ 30,Hooks,Custom hooks for reusable logic,Extract shared stateful logic to custom hooks,useCustomHook for reusable patterns,Duplicate hook logic across components,const { data } = useFetch(url),Duplicate useEffect/useState in components,Medium,https://react.dev/learn/reusing-logic-with-custom-hooks
32
+ 31,Hooks,Name custom hooks with use prefix,Custom hooks must start with use,useFetch useForm useAuth,fetchData or getData for hook,function useFetch(url),function fetchData(url),High,
33
+ 32,Context,Use context for global data,Context for theme auth locale,Context for app-wide state,Context for frequently changing data,<ThemeContext.Provider>,Context for form field values,Medium,https://react.dev/learn/passing-data-deeply-with-context
34
+ 33,Context,Split contexts by concern,Separate contexts for different domains,ThemeContext + AuthContext,One giant AppContext,<ThemeProvider><AuthProvider>,<AppProvider value={{theme user...}}>,Medium,
35
+ 34,Context,Memoize context values,Prevent unnecessary re-renders with useMemo,useMemo for context value object,New object reference every render,"value={useMemo(() => ({...}), [])}","value={{ user, theme }}",High,
36
+ 35,Performance,Use React DevTools Profiler,Profile to identify performance bottlenecks,Profile before optimizing,Optimize without measuring,React DevTools Profiler,Guessing at bottlenecks,Medium,https://react.dev/learn/react-developer-tools
37
+ 36,Performance,Lazy load components,Use React.lazy for code splitting,lazy() for routes and heavy components,Import everything upfront,const Page = lazy(() => import('./Page')),import Page from './Page',Medium,https://react.dev/reference/react/lazy
38
+ 37,Performance,Virtualize long lists,Use windowing for lists over 100 items,react-window or react-virtual,Render thousands of DOM nodes,<VirtualizedList items={items}/>,{items.map(i => <Item />)},High,
39
+ 38,Performance,Batch state updates,React 18 auto-batches but be aware,Let React batch related updates,Manual batching with flushSync,setA(1); setB(2); // batched,flushSync(() => setA(1)),Low,https://react.dev/learn/queueing-a-series-of-state-updates
40
+ 39,ErrorHandling,Use error boundaries,Catch JavaScript errors in component tree,ErrorBoundary wrapping sections,Let errors crash entire app,<ErrorBoundary><App/></ErrorBoundary>,No error handling,High,https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary
41
+ 40,ErrorHandling,Handle async errors,Catch errors in async operations,try/catch in async handlers,Unhandled promise rejections,try { await fetch() } catch(e) {},await fetch() // no catch,High,
42
+ 41,Testing,Test behavior not implementation,Test what user sees and does,Test renders and interactions,Test internal state or methods,expect(screen.getByText('Hello')),expect(component.state.name),Medium,https://testing-library.com/docs/react-testing-library/intro/
43
+ 42,Testing,Use testing-library queries,Use accessible queries,getByRole getByLabelText,getByTestId for everything,getByRole('button'),getByTestId('submit-btn'),Medium,https://testing-library.com/docs/queries/about#priority
44
+ 43,Accessibility,Use semantic HTML,Proper HTML elements for their purpose,button for clicks nav for navigation,div with onClick for buttons,<button onClick={...}>,<div onClick={...}>,High,https://react.dev/reference/react-dom/components#all-html-components
45
+ 44,Accessibility,Manage focus properly,Handle focus for modals dialogs,Focus trap in modals return focus on close,No focus management,useEffect to focus input,Modal without focus trap,High,
46
+ 45,Accessibility,Announce dynamic content,Use ARIA live regions for updates,aria-live for dynamic updates,Silent updates to screen readers,"<div aria-live=""polite"">{msg}</div>",<div>{msg}</div>,Medium,
47
+ 46,Accessibility,Label form controls,Associate labels with inputs,htmlFor matching input id,Placeholder as only label,"<label htmlFor=""email"">Email</label>","<input placeholder=""Email""/>",High,
48
+ 47,TypeScript,Type component props,Define interfaces for all props,interface Props with all prop types,any or missing types,interface Props { name: string },function Component(props: any),High,
49
+ 48,TypeScript,Type state properly,Provide types for useState,useState<Type>() for complex state,Inferred any types,useState<User | null>(null),useState(null),Medium,
50
+ 49,TypeScript,Type event handlers,Use React event types,React.ChangeEvent<HTMLInputElement>,Generic Event type,onChange: React.ChangeEvent<HTMLInputElement>,onChange: Event,Medium,
51
+ 50,TypeScript,Use generics for reusable components,Generic components for flexible typing,Generic props for list components,Union types for flexibility,<List<T> items={T[]}>,<List items={any[]}>,Medium,
52
+ 51,Patterns,Container/Presentational split,Separate data logic from UI,Container fetches presentational renders,Mixed data and UI in one,<UserContainer><UserView/></UserContainer>,<User /> with fetch and render,Low,
53
+ 52,Patterns,Render props for flexibility,Share code via render prop pattern,Render prop for customizable rendering,Duplicate logic across components,<DataFetcher render={data => ...}/>,Copy paste fetch logic,Low,https://react.dev/reference/react/cloneElement#passing-data-with-a-render-prop
54
+ 53,Patterns,Compound components,Related components sharing state,Tab + TabPanel sharing context,Prop drilling between related,<Tabs><Tab/><TabPanel/></Tabs>,<Tabs tabs={[]} panels={[...]}/>,Low,
@@ -0,0 +1,54 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Reactivity,Use $: for reactive statements,Automatic dependency tracking,$: for derived values,Manual recalculation,$: doubled = count * 2,let doubled; count && (doubled = count * 2),Medium,https://svelte.dev/docs/svelte-components#script-3-$-marks-a-statement-as-reactive
3
+ 2,Reactivity,Trigger reactivity with assignment,Svelte tracks assignments not mutations,Reassign arrays/objects to trigger update,Mutate without reassignment,"items = [...items, newItem]",items.push(newItem),High,https://svelte.dev/docs/svelte-components#script-2-assignments-are-reactive
4
+ 3,Reactivity,Use $state in Svelte 5,Runes for explicit reactivity,let count = $state(0),Implicit reactivity in Svelte 5,let count = $state(0),let count = 0 (Svelte 5),Medium,https://svelte.dev/blog/runes
5
+ 4,Reactivity,Use $derived for computed values,$derived replaces $: in Svelte 5,let doubled = $derived(count * 2),$: in Svelte 5,let doubled = $derived(count * 2),$: doubled = count * 2 (Svelte 5),Medium,
6
+ 5,Reactivity,Use $effect for side effects,$effect replaces $: side effects,Use $effect for subscriptions,$: for side effects in Svelte 5,$effect(() => console.log(count)),$: console.log(count) (Svelte 5),Medium,
7
+ 6,Props,Export let for props,Declare props with export let,export let propName,Props without export,export let count = 0,let count = 0,High,https://svelte.dev/docs/svelte-components#script-1-export-creates-a-component-prop
8
+ 7,Props,Use $props in Svelte 5,$props rune for prop access,let { name } = $props(),export let in Svelte 5,"let { name, age = 0 } = $props()",export let name; export let age = 0,Medium,
9
+ 8,Props,Provide default values,Default props with assignment,export let count = 0,Required props without defaults,export let count = 0,export let count,Low,
10
+ 9,Props,Use spread props,Pass through unknown props,{...$$restProps} on elements,Manual prop forwarding,<button {...$$restProps}>,<button class={$$props.class}>,Low,https://svelte.dev/docs/basic-markup#attributes-and-props
11
+ 10,Bindings,Use bind: for two-way binding,Simplified input handling,bind:value for inputs,on:input with manual update,<input bind:value={name}>,<input value={name} on:input={e => name = e.target.value}>,Low,https://svelte.dev/docs/element-directives#bind-property
12
+ 11,Bindings,Bind to DOM elements,Reference DOM nodes,bind:this for element reference,querySelector in onMount,<div bind:this={el}>,onMount(() => el = document.querySelector()),Medium,
13
+ 12,Bindings,Use bind:group for radios/checkboxes,Simplified group handling,bind:group for radio/checkbox groups,Manual checked handling,"<input type=""radio"" bind:group={selected}>","<input type=""radio"" checked={selected === value}>",Low,
14
+ 13,Events,Use on: for event handlers,Event directive syntax,on:click={handler},addEventListener in onMount,<button on:click={handleClick}>,onMount(() => btn.addEventListener()),Medium,https://svelte.dev/docs/element-directives#on-eventname
15
+ 14,Events,Forward events with on:event,Pass events to parent,on:click without handler,createEventDispatcher for DOM events,<button on:click>,"dispatch('click', event)",Low,
16
+ 15,Events,Use createEventDispatcher,Custom component events,dispatch for custom events,on:event for custom events,"dispatch('save', { data })",on:save without dispatch,Medium,https://svelte.dev/docs/svelte#createeventdispatcher
17
+ 16,Lifecycle,Use onMount for initialization,Run code after component mounts,onMount for setup and data fetching,Code in script body for side effects,onMount(() => fetchData()),fetchData() in script body,High,https://svelte.dev/docs/svelte#onmount
18
+ 17,Lifecycle,Return cleanup from onMount,Automatic cleanup on destroy,Return function from onMount,Separate onDestroy for paired cleanup,onMount(() => { sub(); return unsub }),onMount(sub); onDestroy(unsub),Medium,
19
+ 18,Lifecycle,Use onDestroy sparingly,Only when onMount cleanup not possible,onDestroy for non-mount cleanup,onDestroy for mount-related cleanup,onDestroy for store unsubscribe,onDestroy(() => clearInterval(id)),Low,
20
+ 19,Lifecycle,Avoid beforeUpdate/afterUpdate,Usually not needed,Reactive statements instead,beforeUpdate for derived state,$: if (x) doSomething(),beforeUpdate(() => doSomething()),Low,
21
+ 20,Stores,Use writable for mutable state,Basic reactive store,writable for shared mutable state,Local variables for shared state,const count = writable(0),let count = 0 in module,Medium,https://svelte.dev/docs/svelte-store#writable
22
+ 21,Stores,Use readable for read-only state,External data sources,readable for derived/external data,writable for read-only data,"readable(0, set => interval(set))",writable(0) for timer,Low,https://svelte.dev/docs/svelte-store#readable
23
+ 22,Stores,Use derived for computed stores,Combine or transform stores,derived for computed values,Manual subscription for derived,"derived(count, $c => $c * 2)",count.subscribe(c => doubled = c * 2),Medium,https://svelte.dev/docs/svelte-store#derived
24
+ 23,Stores,Use $ prefix for auto-subscription,Automatic subscribe/unsubscribe,$storeName in components,Manual subscription,{$count},count.subscribe(c => value = c),High,
25
+ 24,Stores,Clean up custom subscriptions,Unsubscribe when component destroys,Return unsubscribe from onMount,Leave subscriptions open,onMount(() => store.subscribe(fn)),store.subscribe(fn) in script,High,
26
+ 25,Slots,Use slots for composition,Content projection,<slot> for flexible content,Props for all content,<slot>Default</slot>,"<Component content=""text""/>",Medium,https://svelte.dev/docs/special-elements#slot
27
+ 26,Slots,Name slots for multiple areas,Multiple content areas,"<slot name=""header"">",Single slot for complex layouts,"<slot name=""header""><slot name=""footer"">",<slot> with complex conditionals,Low,
28
+ 27,Slots,Check slot content with $$slots,Conditional slot rendering,$$slots.name for conditional rendering,Always render slot wrapper,"{#if $$slots.footer}<slot name=""footer""/>{/if}","<div><slot name=""footer""/></div>",Low,
29
+ 28,Styling,Use scoped styles by default,Styles scoped to component,<style> for component styles,Global styles for component,:global() only when needed,<style> all global,Medium,https://svelte.dev/docs/svelte-components#style
30
+ 29,Styling,Use :global() sparingly,Escape scoping when needed,:global for third-party styling,Global for all styles,:global(.external-lib),<style> without scoping,Medium,
31
+ 30,Styling,Use CSS variables for theming,Dynamic styling,CSS custom properties,Inline styles for themes,"style=""--color: {color}""","style=""color: {color}""",Low,
32
+ 31,Transitions,Use built-in transitions,Svelte transition directives,transition:fade for simple effects,Manual CSS transitions,<div transition:fade>,<div class:fade={visible}>,Low,https://svelte.dev/docs/element-directives#transition-fn
33
+ 32,Transitions,Use in: and out: separately,Different enter/exit animations,in:fly out:fade for asymmetric,Same transition for both,<div in:fly out:fade>,<div transition:fly>,Low,
34
+ 33,Transitions,Add local modifier,Prevent ancestor trigger,transition:fade|local,Global transitions for lists,<div transition:slide|local>,<div transition:slide>,Medium,
35
+ 34,Actions,Use actions for DOM behavior,Reusable DOM logic,use:action for DOM enhancements,onMount for each usage,<div use:clickOutside>,onMount(() => setupClickOutside(el)),Medium,https://svelte.dev/docs/element-directives#use-action
36
+ 35,Actions,Return update and destroy,Lifecycle methods for actions,"Return { update, destroy }",Only initial setup,"return { update(params) {}, destroy() {} }",return destroy only,Medium,
37
+ 36,Actions,Pass parameters to actions,Configure action behavior,use:action={params},Hardcoded action behavior,<div use:tooltip={options}>,<div use:tooltip>,Low,
38
+ 37,Logic,Use {#if} for conditionals,Template conditionals,{#if} {:else if} {:else},Ternary in expressions,{#if cond}...{:else}...{/if},{cond ? a : b} for complex,Low,https://svelte.dev/docs/logic-blocks#if
39
+ 38,Logic,Use {#each} for lists,List rendering,{#each} with key,Map in expression,{#each items as item (item.id)},{items.map(i => `<div>${i}</div>`)},Medium,
40
+ 39,Logic,Always use keys in {#each},Proper list reconciliation,(item.id) for unique key,Index as key or no key,{#each items as item (item.id)},"{#each items as item, i (i)}",High,
41
+ 40,Logic,Use {#await} for promises,Handle async states,{#await} for loading/error states,Manual promise handling,{#await promise}...{:then}...{:catch},{#if loading}...{#if error},Medium,https://svelte.dev/docs/logic-blocks#await
42
+ 41,SvelteKit,Use +page.svelte for routes,File-based routing,+page.svelte for route components,Custom routing setup,routes/about/+page.svelte,routes/About.svelte,Medium,https://kit.svelte.dev/docs/routing
43
+ 42,SvelteKit,Use +page.js for data loading,Load data before render,load function in +page.js,onMount for data fetching,export function load() {},onMount(() => fetchData()),High,https://kit.svelte.dev/docs/load
44
+ 43,SvelteKit,Use +page.server.js for server-only,Server-side data loading,+page.server.js for sensitive data,+page.js for API keys,+page.server.js with DB access,+page.js with DB access,High,
45
+ 44,SvelteKit,Use form actions,Server-side form handling,+page.server.js actions,API routes for forms,export const actions = { default },fetch('/api/submit'),Medium,https://kit.svelte.dev/docs/form-actions
46
+ 45,SvelteKit,Use $app/stores for app state,$page $navigating $updated,$page for current page data,Manual URL parsing,import { page } from '$app/stores',window.location.pathname,Medium,https://kit.svelte.dev/docs/modules#$app-stores
47
+ 46,Performance,Use {#key} for forced re-render,Reset component state,{#key id} for fresh instance,Manual destroy/create,{#key item.id}<Component/>{/key},on:change={() => component = null},Low,https://svelte.dev/docs/logic-blocks#key
48
+ 47,Performance,Avoid unnecessary reactivity,Not everything needs $:,$: only for side effects,$: for simple assignments,$: if (x) console.log(x),$: y = x (when y = x works),Low,
49
+ 48,Performance,Use immutable compiler option,Skip equality checks,immutable: true for large lists,Default for all components,<svelte:options immutable/>,Default without immutable,Low,
50
+ 49,TypeScript,"Use lang=""ts"" in script",TypeScript support,"<script lang=""ts"">",JavaScript for typed projects,"<script lang=""ts"">",<script> with JSDoc,Medium,https://svelte.dev/docs/typescript
51
+ 50,TypeScript,Type props with interface,Explicit prop types,interface $$Props for types,Untyped props,interface $$Props { name: string },export let name,Medium,
52
+ 51,TypeScript,Type events with createEventDispatcher,Type-safe events,createEventDispatcher<Events>(),Untyped dispatch,createEventDispatcher<{ save: Data }>(),createEventDispatcher(),Medium,
53
+ 52,Accessibility,Use semantic elements,Proper HTML in templates,button nav main appropriately,div for everything,<button on:click>,<div on:click>,High,
54
+ 53,Accessibility,Add aria to dynamic content,Accessible state changes,aria-live for updates,Silent dynamic updates,"<div aria-live=""polite"">{message}</div>",<div>{message}</div>,Medium,
@@ -0,0 +1,51 @@
1
+ No,Category,Guideline,Description,Do,Don't,Code Good,Code Bad,Severity,Docs URL
2
+ 1,Views,Use struct for views,SwiftUI views are value types,struct MyView: View,class MyView: View,struct ContentView: View { var body: some View },class ContentView: View,High,https://developer.apple.com/documentation/swiftui/view
3
+ 2,Views,Keep views small and focused,Single responsibility for each view,Extract subviews for complex layouts,Large monolithic views,Extract HeaderView FooterView,500+ line View struct,Medium,
4
+ 3,Views,Use body computed property,body returns the view hierarchy,var body: some View { },func body() -> some View,"var body: some View { Text(""Hello"") }",func body() -> Text,High,
5
+ 4,Views,Prefer composition over inheritance,Compose views using ViewBuilder,Combine smaller views,Inheritance hierarchies,VStack { Header() Content() },class SpecialView extends BaseView,Medium,
6
+ 5,State,Use @State for local state,Simple value types owned by view,@State for view-local primitives,@State for shared data,@State private var count = 0,@State var sharedData: Model,High,https://developer.apple.com/documentation/swiftui/state
7
+ 6,State,Use @Binding for two-way data,Pass mutable state to child views,@Binding for child input,@State in child for parent data,@Binding var isOn: Bool,$isOn to pass binding,Medium,https://developer.apple.com/documentation/swiftui/binding
8
+ 7,State,Use @StateObject for reference types,ObservableObject owned by view,@StateObject for view-created objects,@ObservedObject for owned objects,@StateObject private var vm = ViewModel(),@ObservedObject var vm = ViewModel(),High,https://developer.apple.com/documentation/swiftui/stateobject
9
+ 8,State,Use @ObservedObject for injected objects,Reference types passed from parent,@ObservedObject for injected dependencies,@StateObject for injected objects,@ObservedObject var vm: ViewModel,@StateObject var vm: ViewModel (injected),High,https://developer.apple.com/documentation/swiftui/observedobject
10
+ 9,State,Use @EnvironmentObject for shared state,App-wide state injection,@EnvironmentObject for global state,Prop drilling through views,@EnvironmentObject var settings: Settings,Pass settings through 5 views,Medium,https://developer.apple.com/documentation/swiftui/environmentobject
11
+ 10,State,Use @Published in ObservableObject,Automatically publish property changes,@Published for observed properties,Manual objectWillChange calls,@Published var items: [Item] = [],var items: [Item] { didSet { objectWillChange.send() } },Medium,
12
+ 11,Observable,Use @Observable macro (iOS 17+),Modern observation without Combine,@Observable class for view models,ObservableObject for new projects,@Observable class ViewModel { },class ViewModel: ObservableObject,Medium,https://developer.apple.com/documentation/observation
13
+ 12,Observable,Use @Bindable for @Observable,Create bindings from @Observable,@Bindable var vm for bindings,@Binding with @Observable,@Bindable var viewModel,$viewModel.name with @Observable,Medium,
14
+ 13,Layout,Use VStack HStack ZStack,Standard stack-based layouts,Stacks for linear arrangements,GeometryReader for simple layouts,VStack { Text() Image() },GeometryReader for vertical list,Medium,https://developer.apple.com/documentation/swiftui/vstack
15
+ 14,Layout,Use LazyVStack LazyHStack for lists,Lazy loading for performance,Lazy stacks for long lists,Regular stacks for 100+ items,LazyVStack { ForEach(items) },VStack { ForEach(largeArray) },High,https://developer.apple.com/documentation/swiftui/lazyvstack
16
+ 15,Layout,Use GeometryReader sparingly,Only when needed for sizing,GeometryReader for responsive layouts,GeometryReader everywhere,GeometryReader for aspect ratio,GeometryReader wrapping everything,Medium,
17
+ 16,Layout,Use spacing and padding consistently,Consistent spacing throughout app,Design system spacing values,Magic numbers for spacing,.padding(16) or .padding(),".padding(13), .padding(17)",Low,
18
+ 17,Layout,Use frame modifiers correctly,Set explicit sizes when needed,.frame(maxWidth: .infinity),Fixed sizes for responsive content,.frame(maxWidth: .infinity),.frame(width: 375),Medium,
19
+ 18,Modifiers,Order modifiers correctly,Modifier order affects rendering,Background before padding for full coverage,Wrong modifier order,.padding().background(Color.red),.background(Color.red).padding(),High,
20
+ 19,Modifiers,Create custom ViewModifiers,Reusable modifier combinations,ViewModifier for repeated styling,Duplicate modifier chains,struct CardStyle: ViewModifier,.shadow().cornerRadius() everywhere,Medium,https://developer.apple.com/documentation/swiftui/viewmodifier
21
+ 20,Modifiers,Use conditional modifiers carefully,Avoid changing view identity,if-else with same view type,Conditional that changes view identity,Text(title).foregroundColor(isActive ? .blue : .gray),if isActive { Text().bold() } else { Text() },Medium,
22
+ 21,Navigation,Use NavigationStack (iOS 16+),Modern navigation with type-safe paths,NavigationStack with navigationDestination,NavigationView for new projects,NavigationStack { },NavigationView { } (deprecated),Medium,https://developer.apple.com/documentation/swiftui/navigationstack
23
+ 22,Navigation,Use navigationDestination,Type-safe navigation destinations,.navigationDestination(for:),NavigationLink(destination:),.navigationDestination(for: Item.self),NavigationLink(destination: DetailView()),Medium,
24
+ 23,Navigation,Use @Environment for dismiss,Programmatic navigation dismissal,@Environment(\.dismiss) var dismiss,presentationMode (deprecated),@Environment(\.dismiss) var dismiss,@Environment(\.presentationMode),Low,
25
+ 24,Lists,Use List for scrollable content,Built-in scrolling and styling,List for standard scrollable content,ScrollView + VStack for simple lists,List { ForEach(items) { } },ScrollView { VStack { ForEach } },Low,https://developer.apple.com/documentation/swiftui/list
26
+ 25,Lists,Provide stable identifiers,Use Identifiable or explicit id,Identifiable protocol or id parameter,Index as identifier,ForEach(items) where Item: Identifiable,"ForEach(items.indices, id: \.self)",High,
27
+ 26,Lists,Use onDelete and onMove,Standard list editing,onDelete for swipe to delete,Custom delete implementation,.onDelete(perform: delete),.onTapGesture for delete,Low,
28
+ 27,Forms,Use Form for settings,Grouped input controls,Form for settings screens,Manual grouping for forms,Form { Section { Toggle() } },VStack { Toggle() },Low,https://developer.apple.com/documentation/swiftui/form
29
+ 28,Forms,Use @FocusState for keyboard,Manage keyboard focus,@FocusState for text field focus,Manual first responder handling,@FocusState private var isFocused: Bool,UIKit first responder,Medium,https://developer.apple.com/documentation/swiftui/focusstate
30
+ 29,Forms,Validate input properly,Show validation feedback,Real-time validation feedback,Submit without validation,TextField with validation state,TextField without error handling,Medium,
31
+ 30,Async,Use .task for async work,Automatic cancellation on view disappear,.task for view lifecycle async,onAppear with Task,.task { await loadData() },onAppear { Task { await loadData() } },Medium,https://developer.apple.com/documentation/swiftui/view/task(priority:_:)
32
+ 31,Async,Handle loading states,Show progress during async operations,ProgressView during loading,Empty view during load,if isLoading { ProgressView() },No loading indicator,Medium,
33
+ 32,Async,Use @MainActor for UI updates,Ensure UI updates on main thread,@MainActor on view models,Manual DispatchQueue.main,@MainActor class ViewModel,DispatchQueue.main.async,Medium,
34
+ 33,Animation,Use withAnimation,Animate state changes,withAnimation for state transitions,No animation for state changes,withAnimation { isExpanded.toggle() },isExpanded.toggle(),Low,https://developer.apple.com/documentation/swiftui/withanimation(_:_:)
35
+ 34,Animation,Use .animation modifier,Apply animations to views,.animation(.spring()) on view,Manual animation timing,.animation(.easeInOut),CABasicAnimation equivalent,Low,
36
+ 35,Animation,Respect reduced motion,Check accessibility settings,Check accessibilityReduceMotion,Ignore motion preferences,@Environment(\.accessibilityReduceMotion),Always animate regardless,High,
37
+ 36,Preview,Use #Preview macro (Xcode 15+),Modern preview syntax,#Preview for view previews,PreviewProvider protocol,#Preview { ContentView() },struct ContentView_Previews: PreviewProvider,Low,
38
+ 37,Preview,Create multiple previews,Test different states and devices,Multiple previews for states,Single preview only,"#Preview(""Light"") { } #Preview(""Dark"") { }",Single preview configuration,Low,
39
+ 38,Preview,Use preview data,Dedicated preview mock data,Static preview data,Production data in previews,Item.preview for preview,Fetch real data in preview,Low,
40
+ 39,Performance,Avoid expensive body computations,Body should be fast to compute,Precompute in view model,Heavy computation in body,vm.computedValue in body,Complex calculation in body,High,
41
+ 40,Performance,Use Equatable views,Skip unnecessary view updates,Equatable for complex views,Default equality for all views,struct MyView: View Equatable,No Equatable conformance,Medium,
42
+ 41,Performance,Profile with Instruments,Measure before optimizing,Use SwiftUI Instruments,Guess at performance issues,Profile with Instruments,Optimize without measuring,Medium,
43
+ 42,Accessibility,Add accessibility labels,Describe UI elements,.accessibilityLabel for context,Missing labels,".accessibilityLabel(""Close button"")",Button without label,High,https://developer.apple.com/documentation/swiftui/view/accessibilitylabel(_:)-1d7jv
44
+ 43,Accessibility,Support Dynamic Type,Respect text size preferences,Scalable fonts and layouts,Fixed font sizes,.font(.body) with Dynamic Type,.font(.system(size: 16)),High,
45
+ 44,Accessibility,Use semantic views,Proper accessibility traits,Correct accessibilityTraits,Wrong semantic meaning,Button for actions Image for display,Image that acts like button,Medium,
46
+ 45,Testing,Use ViewInspector for testing,Third-party view testing,ViewInspector for unit tests,UI tests only,ViewInspector assertions,Only XCUITest,Medium,
47
+ 46,Testing,Test view models,Unit test business logic,XCTest for view model,Skip view model testing,Test ViewModel methods,No unit tests,Medium,
48
+ 47,Testing,Use preview as visual test,Previews catch visual regressions,Multiple preview configurations,No visual verification,Preview different states,Single preview only,Low,
49
+ 48,Architecture,Use MVVM pattern,Separate view and logic,ViewModel for business logic,Logic in View,ObservableObject ViewModel,@State for complex logic,Medium,
50
+ 49,Architecture,Keep views dumb,Views display view model state,View reads from ViewModel,Business logic in View,view.items from vm.items,Complex filtering in View,Medium,
51
+ 50,Architecture,Use dependency injection,Inject dependencies for testing,Initialize with dependencies,Hard-coded dependencies,init(service: ServiceProtocol),let service = RealService(),Medium,