vybekiit 0.4.0 → 0.6.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 (665) hide show
  1. package/dist/bin.js +840 -296
  2. package/dist/global-skills/add-ai/SKILL.md +53 -0
  3. package/dist/global-skills/add-analytics/SKILL.md +65 -0
  4. package/dist/global-skills/add-app-clip/SKILL.md +280 -0
  5. package/dist/global-skills/add-app-clip/agents/openai.yaml +4 -0
  6. package/dist/global-skills/add-app-clip/references/native-module.md +96 -0
  7. package/dist/global-skills/add-blog/SKILL.md +49 -0
  8. package/dist/global-skills/add-crud/SKILL.md +28 -0
  9. package/dist/global-skills/add-files/SKILL.md +65 -0
  10. package/dist/global-skills/add-images/SKILL.md +64 -0
  11. package/dist/global-skills/add-language/SKILL.md +44 -0
  12. package/dist/global-skills/add-notifications/SKILL.md +61 -0
  13. package/dist/global-skills/add-realtime/SKILL.md +49 -0
  14. package/dist/global-skills/add-route/SKILL.md +28 -0
  15. package/dist/global-skills/add-search/SKILL.md +43 -0
  16. package/dist/global-skills/add-signin/SKILL.md +78 -0
  17. package/dist/global-skills/add-teams/SKILL.md +64 -0
  18. package/dist/global-skills/add-upload/SKILL.md +27 -0
  19. package/dist/global-skills/aws-cdk/SKILL.md +72 -0
  20. package/dist/global-skills/aws-cdk/references/bootstrap-and-project-setup.md +257 -0
  21. package/dist/global-skills/aws-cdk/references/compliance-and-drift.md +193 -0
  22. package/dist/global-skills/aws-cdk/references/construct-patterns.md +315 -0
  23. package/dist/global-skills/aws-cdk/references/import-and-migrate.md +184 -0
  24. package/dist/global-skills/aws-cdk/references/refactor-and-prevent-replacement.md +198 -0
  25. package/dist/global-skills/aws-cdk/references/troubleshooting-credentials.md +183 -0
  26. package/dist/global-skills/aws-cdk/references/troubleshooting-deployment.md +293 -0
  27. package/dist/global-skills/aws-cdk/references/troubleshooting-synth.md +274 -0
  28. package/dist/global-skills/aws-cdk/references/v1-to-v2-migration.md +119 -0
  29. package/dist/global-skills/aws-cloudformation/SKILL.md +88 -0
  30. package/dist/global-skills/aws-cloudformation/references/author-cloudformation-best-practices.script.md +179 -0
  31. package/dist/global-skills/aws-cloudformation/references/check-cloudformation-template-compliance.script.md +159 -0
  32. package/dist/global-skills/aws-cloudformation/references/cloudformation-pre-deploy-validation.script.md +217 -0
  33. package/dist/global-skills/aws-cloudformation/references/deploy-with-express-mode.script.md +271 -0
  34. package/dist/global-skills/aws-cloudformation/references/lookup-resource-properties.script.md +130 -0
  35. package/dist/global-skills/aws-cloudformation/references/troubleshoot-deployment.script.md +200 -0
  36. package/dist/global-skills/aws-cloudformation/references/validate-cloudformation-template.script.md +135 -0
  37. package/dist/global-skills/aws-serverless/SKILL.md +51 -0
  38. package/dist/global-skills/aws-serverless/assets/powertools-handler.py +49 -0
  39. package/dist/global-skills/aws-serverless/references/api-gateway.md +553 -0
  40. package/dist/global-skills/aws-serverless/references/architecture.md +262 -0
  41. package/dist/global-skills/aws-serverless/references/concurrency.md +200 -0
  42. package/dist/global-skills/aws-serverless/references/deployment.md +94 -0
  43. package/dist/global-skills/aws-serverless/references/event-sources.md +484 -0
  44. package/dist/global-skills/aws-serverless/references/lambda.md +548 -0
  45. package/dist/global-skills/aws-serverless/references/orchestration.md +449 -0
  46. package/dist/global-skills/aws-serverless/references/production.md +493 -0
  47. package/dist/global-skills/aws-serverless/references/troubleshooting.md +711 -0
  48. package/dist/global-skills/back-up-my-code/SKILL.md +48 -0
  49. package/dist/global-skills/better-auth-best-practices/SKILL.md +182 -0
  50. package/dist/global-skills/better-auth-security-best-practices/SKILL.md +432 -0
  51. package/dist/global-skills/building-native-ui/SKILL.md +377 -0
  52. package/dist/global-skills/building-native-ui/agents/openai.yaml +4 -0
  53. package/dist/global-skills/building-native-ui/references/animations.md +220 -0
  54. package/dist/global-skills/building-native-ui/references/controls.md +270 -0
  55. package/dist/global-skills/building-native-ui/references/form-sheet.md +253 -0
  56. package/dist/global-skills/building-native-ui/references/gradients.md +106 -0
  57. package/dist/global-skills/building-native-ui/references/icons.md +213 -0
  58. package/dist/global-skills/building-native-ui/references/media.md +198 -0
  59. package/dist/global-skills/building-native-ui/references/route-structure.md +229 -0
  60. package/dist/global-skills/building-native-ui/references/search.md +248 -0
  61. package/dist/global-skills/building-native-ui/references/storage.md +121 -0
  62. package/dist/global-skills/building-native-ui/references/tabs.md +433 -0
  63. package/dist/global-skills/building-native-ui/references/toolbar-and-headers.md +284 -0
  64. package/dist/global-skills/building-native-ui/references/visual-effects.md +197 -0
  65. package/dist/global-skills/building-native-ui/references/webgpu-three.md +605 -0
  66. package/dist/global-skills/building-native-ui/references/zoom-transitions.md +158 -0
  67. package/dist/global-skills/buy-domain/SKILL.md +64 -0
  68. package/dist/global-skills/check-safety/SKILL.md +94 -0
  69. package/dist/global-skills/claimable-postgres/SKILL.md +249 -0
  70. package/dist/global-skills/configure-capabilities/SKILL.md +38 -0
  71. package/dist/global-skills/connect-account/SKILL.md +64 -0
  72. package/dist/global-skills/connect-account-backend/SKILL.md +41 -0
  73. package/dist/global-skills/create-auth-skill/SKILL.md +321 -0
  74. package/dist/global-skills/design-my-data/SKILL.md +48 -0
  75. package/dist/global-skills/doctor/SKILL.md +84 -0
  76. package/dist/global-skills/eas-app-stores/SKILL.md +152 -0
  77. package/dist/global-skills/eas-app-stores/agents/openai.yaml +4 -0
  78. package/dist/global-skills/eas-app-stores/references/app-store-metadata.md +497 -0
  79. package/dist/global-skills/eas-app-stores/references/ios-app-store.md +371 -0
  80. package/dist/global-skills/eas-app-stores/references/play-store.md +246 -0
  81. package/dist/global-skills/eas-app-stores/references/testflight.md +58 -0
  82. package/dist/global-skills/eas-app-stores/references/workflows.md +120 -0
  83. package/dist/global-skills/eas-hosting/SKILL.md +423 -0
  84. package/dist/global-skills/eas-hosting/agents/openai.yaml +4 -0
  85. package/dist/global-skills/eas-observe/SKILL.md +32 -0
  86. package/dist/global-skills/eas-observe/agents/openai.yaml +4 -0
  87. package/dist/global-skills/eas-observe/references/metrics.md +47 -0
  88. package/dist/global-skills/eas-observe/references/queries.md +342 -0
  89. package/dist/global-skills/eas-observe/references/setup.md +317 -0
  90. package/dist/global-skills/eas-simulator/SKILL.md +156 -0
  91. package/dist/global-skills/eas-simulator/agents/openai.yaml +4 -0
  92. package/dist/global-skills/eas-simulator/references/controllers.md +67 -0
  93. package/dist/global-skills/eas-simulator/references/run-your-app.md +185 -0
  94. package/dist/global-skills/eas-simulator/references/troubleshooting.md +38 -0
  95. package/dist/global-skills/eas-update-insights/SKILL.md +230 -0
  96. package/dist/global-skills/eas-update-insights/agents/openai.yaml +4 -0
  97. package/dist/global-skills/eas-update-insights/references/channel-insights-schema.md +47 -0
  98. package/dist/global-skills/eas-update-insights/references/update-insights-schema.md +69 -0
  99. package/dist/global-skills/eas-workflows/SKILL.md +94 -0
  100. package/dist/global-skills/eas-workflows/agents/openai.yaml +4 -0
  101. package/dist/global-skills/eas-workflows/scripts/fetch.js +109 -0
  102. package/dist/global-skills/eas-workflows/scripts/package.json +11 -0
  103. package/dist/global-skills/eas-workflows/scripts/validate.js +84 -0
  104. package/dist/global-skills/email-best-practices/SKILL.md +73 -0
  105. package/dist/global-skills/expo-api-routes/SKILL.md +368 -0
  106. package/dist/global-skills/expo-api-routes/agents/openai.yaml +4 -0
  107. package/dist/global-skills/expo-app-clip/SKILL.md +282 -0
  108. package/dist/global-skills/expo-app-clip/agents/openai.yaml +4 -0
  109. package/dist/global-skills/expo-app-clip/references/native-module.md +96 -0
  110. package/dist/global-skills/expo-brownfield/SKILL.md +54 -0
  111. package/dist/global-skills/expo-brownfield/agents/openai.yaml +4 -0
  112. package/dist/global-skills/expo-brownfield/references/brownfield-integrated.md +526 -0
  113. package/dist/global-skills/expo-brownfield/references/brownfield-isolated.md +402 -0
  114. package/dist/global-skills/expo-brownfield/references/comparison.md +63 -0
  115. package/dist/global-skills/expo-brownfield/references/troubleshooting.md +88 -0
  116. package/dist/global-skills/expo-cicd-workflows/SKILL.md +92 -0
  117. package/dist/global-skills/expo-cicd-workflows/agents/openai.yaml +4 -0
  118. package/dist/global-skills/expo-cicd-workflows/scripts/fetch.js +109 -0
  119. package/dist/global-skills/expo-cicd-workflows/scripts/package.json +11 -0
  120. package/dist/global-skills/expo-cicd-workflows/scripts/validate.js +84 -0
  121. package/dist/global-skills/expo-data-fetching/SKILL.md +449 -0
  122. package/dist/global-skills/expo-data-fetching/agents/openai.yaml +4 -0
  123. package/dist/global-skills/expo-data-fetching/references/expo-router-loaders.md +341 -0
  124. package/dist/global-skills/expo-data-fetching/references/offline-and-cancellation.md +68 -0
  125. package/dist/global-skills/expo-deployment/SKILL.md +167 -0
  126. package/dist/global-skills/expo-deployment/agents/openai.yaml +4 -0
  127. package/dist/global-skills/expo-deployment/references/app-store-metadata.md +497 -0
  128. package/dist/global-skills/expo-deployment/references/ios-app-store.md +371 -0
  129. package/dist/global-skills/expo-deployment/references/play-store.md +246 -0
  130. package/dist/global-skills/expo-deployment/references/testflight.md +58 -0
  131. package/dist/global-skills/expo-deployment/references/workflows.md +160 -0
  132. package/dist/global-skills/expo-dev-client/SKILL.md +174 -0
  133. package/dist/global-skills/expo-dev-client/agents/openai.yaml +4 -0
  134. package/dist/global-skills/expo-dom/SKILL.md +417 -0
  135. package/dist/global-skills/expo-dom/agents/openai.yaml +4 -0
  136. package/dist/global-skills/expo-examples/SKILL.md +99 -0
  137. package/dist/global-skills/expo-examples/agents/openai.yaml +4 -0
  138. package/dist/global-skills/expo-examples/references/catalog.md +105 -0
  139. package/dist/global-skills/expo-module/SKILL.md +141 -0
  140. package/dist/global-skills/expo-module/agents/openai.yaml +4 -0
  141. package/dist/global-skills/expo-module/references/config-plugin.md +90 -0
  142. package/dist/global-skills/expo-module/references/create-expo-module.md +206 -0
  143. package/dist/global-skills/expo-module/references/lifecycle.md +127 -0
  144. package/dist/global-skills/expo-module/references/module-config.md +48 -0
  145. package/dist/global-skills/expo-module/references/native-module.md +286 -0
  146. package/dist/global-skills/expo-module/references/native-view.md +171 -0
  147. package/dist/global-skills/expo-native-ui/SKILL.md +181 -0
  148. package/dist/global-skills/expo-native-ui/agents/openai.yaml +4 -0
  149. package/dist/global-skills/expo-native-ui/references/animations.md +220 -0
  150. package/dist/global-skills/expo-native-ui/references/controls.md +270 -0
  151. package/dist/global-skills/expo-native-ui/references/gradients.md +106 -0
  152. package/dist/global-skills/expo-native-ui/references/icons.md +213 -0
  153. package/dist/global-skills/expo-native-ui/references/media.md +198 -0
  154. package/dist/global-skills/expo-native-ui/references/storage.md +121 -0
  155. package/dist/global-skills/expo-native-ui/references/visual-effects.md +197 -0
  156. package/dist/global-skills/expo-native-ui/references/webgpu-three.md +605 -0
  157. package/dist/global-skills/expo-observe/SKILL.md +30 -0
  158. package/dist/global-skills/expo-observe/references/metrics.md +47 -0
  159. package/dist/global-skills/expo-observe/references/queries.md +342 -0
  160. package/dist/global-skills/expo-observe/references/setup.md +317 -0
  161. package/dist/global-skills/expo-router/SKILL.md +230 -0
  162. package/dist/global-skills/expo-router/agents/openai.yaml +4 -0
  163. package/dist/global-skills/expo-router/references/form-sheet.md +253 -0
  164. package/dist/global-skills/expo-router/references/route-structure.md +229 -0
  165. package/dist/global-skills/expo-router/references/search.md +248 -0
  166. package/dist/global-skills/expo-router/references/tabs.md +433 -0
  167. package/dist/global-skills/expo-router/references/toolbar-and-headers.md +284 -0
  168. package/dist/global-skills/expo-router/references/zoom-transitions.md +158 -0
  169. package/dist/global-skills/expo-skill-eval/SKILL.md +314 -0
  170. package/dist/global-skills/expo-skill-eval/agents/visual-grader.md +52 -0
  171. package/dist/global-skills/expo-skill-eval/references/design-rubric.md +45 -0
  172. package/dist/global-skills/expo-skill-eval/references/runtime-matrix.md +34 -0
  173. package/dist/global-skills/expo-skill-eval/scripts/check-static.sh +64 -0
  174. package/dist/global-skills/expo-skill-eval/scripts/clean-fixture.sh +56 -0
  175. package/dist/global-skills/expo-skill-eval/scripts/generate_viewer.py +450 -0
  176. package/dist/global-skills/expo-skill-eval/scripts/latest-sdk.sh +46 -0
  177. package/dist/global-skills/expo-skill-eval/scripts/make-fixture.sh +95 -0
  178. package/dist/global-skills/expo-skill-eval/scripts/make-workspace.sh +31 -0
  179. package/dist/global-skills/expo-skill-eval/scripts/snapshot-android.sh +284 -0
  180. package/dist/global-skills/expo-skill-eval/scripts/snapshot-ios.sh +132 -0
  181. package/dist/global-skills/expo-skill-eval/scripts/snapshot-web.sh +61 -0
  182. package/dist/global-skills/expo-skill-feedback/SKILL.md +54 -0
  183. package/dist/global-skills/expo-skill-feedback/agents/openai.yaml +4 -0
  184. package/dist/global-skills/expo-skill-feedback/scripts/skill-event.cjs +180 -0
  185. package/dist/global-skills/expo-skill-feedback/scripts/skill-feedback.cjs +118 -0
  186. package/dist/global-skills/expo-skill-feedback/scripts/telemetry.cjs +65 -0
  187. package/dist/global-skills/expo-skill-feedback/scripts/telemetry_common.cjs +171 -0
  188. package/dist/global-skills/expo-tailwind-setup/SKILL.md +480 -0
  189. package/dist/global-skills/expo-tailwind-setup/agents/openai.yaml +4 -0
  190. package/dist/global-skills/expo-ui/SKILL.md +47 -0
  191. package/dist/global-skills/expo-ui/agents/openai.yaml +4 -0
  192. package/dist/global-skills/expo-ui/references/drop-in-replacements.md +27 -0
  193. package/dist/global-skills/expo-ui/references/jetpack-compose.md +73 -0
  194. package/dist/global-skills/expo-ui/references/swift-ui.md +73 -0
  195. package/dist/global-skills/expo-ui/references/universal.md +73 -0
  196. package/dist/global-skills/expo-ui/scripts/list-components.js +193 -0
  197. package/dist/global-skills/expo-upgrade/SKILL.md +134 -0
  198. package/dist/global-skills/expo-upgrade/agents/openai.yaml +4 -0
  199. package/dist/global-skills/expo-upgrade/references/expo-av-to-audio.md +132 -0
  200. package/dist/global-skills/expo-upgrade/references/expo-av-to-video.md +160 -0
  201. package/dist/global-skills/expo-upgrade/references/native-tabs.md +124 -0
  202. package/dist/global-skills/expo-upgrade/references/new-architecture.md +79 -0
  203. package/dist/global-skills/expo-upgrade/references/react-19.md +79 -0
  204. package/dist/global-skills/expo-upgrade/references/react-compiler.md +59 -0
  205. package/dist/global-skills/expo-upgrade/references/react-navigation-to-expo-router.md +61 -0
  206. package/dist/global-skills/expo-web-to-native/SKILL.md +83 -0
  207. package/dist/global-skills/expo-web-to-native/agents/openai.yaml +4 -0
  208. package/dist/global-skills/expo-web-to-native/references/false-friends.md +119 -0
  209. package/dist/global-skills/expo-web-to-native/references/native-patterns.md +39 -0
  210. package/dist/global-skills/expo-web-to-native/references/run-as-goal.md +48 -0
  211. package/dist/global-skills/expo-web-to-native/references/verify-on-device.md +45 -0
  212. package/dist/global-skills/firebase-ai-logic-basics/SKILL.md +165 -0
  213. package/dist/global-skills/firebase-ai-logic-basics/references/flutter_setup.md +95 -0
  214. package/dist/global-skills/firebase-ai-logic-basics/references/ios_setup.md +156 -0
  215. package/dist/global-skills/firebase-ai-logic-basics/references/usage_patterns_android.md +157 -0
  216. package/dist/global-skills/firebase-ai-logic-basics/references/usage_patterns_web.md +186 -0
  217. package/dist/global-skills/firebase-app-hosting-basics/SKILL.md +73 -0
  218. package/dist/global-skills/firebase-app-hosting-basics/references/cli_commands.md +85 -0
  219. package/dist/global-skills/firebase-app-hosting-basics/references/configuration.md +59 -0
  220. package/dist/global-skills/firebase-app-hosting-basics/references/emulation.md +59 -0
  221. package/dist/global-skills/firebase-auth-basics/SKILL.md +118 -0
  222. package/dist/global-skills/firebase-auth-basics/references/client_sdk_android.md +160 -0
  223. package/dist/global-skills/firebase-auth-basics/references/client_sdk_web.md +301 -0
  224. package/dist/global-skills/firebase-auth-basics/references/flutter_setup.md +149 -0
  225. package/dist/global-skills/firebase-auth-basics/references/ios_setup.md +87 -0
  226. package/dist/global-skills/firebase-auth-basics/references/security_rules.md +49 -0
  227. package/dist/global-skills/firebase-basics/SKILL.md +148 -0
  228. package/dist/global-skills/firebase-basics/references/android_setup.md +41 -0
  229. package/dist/global-skills/firebase-basics/references/firebase-cli-guide.md +18 -0
  230. package/dist/global-skills/firebase-basics/references/firebase-service-init.md +20 -0
  231. package/dist/global-skills/firebase-basics/references/flutter_setup.md +143 -0
  232. package/dist/global-skills/firebase-basics/references/ios_setup.md +113 -0
  233. package/dist/global-skills/firebase-basics/references/local-env-setup.md +80 -0
  234. package/dist/global-skills/firebase-basics/references/refresh/android_studio.md +41 -0
  235. package/dist/global-skills/firebase-basics/references/refresh/antigravity.md +64 -0
  236. package/dist/global-skills/firebase-basics/references/refresh/claude.md +12 -0
  237. package/dist/global-skills/firebase-basics/references/refresh/gemini-cli.md +13 -0
  238. package/dist/global-skills/firebase-basics/references/refresh/other-agents.md +67 -0
  239. package/dist/global-skills/firebase-basics/references/setup/android_studio.md +23 -0
  240. package/dist/global-skills/firebase-basics/references/setup/antigravity.md +98 -0
  241. package/dist/global-skills/firebase-basics/references/setup/claude_code.md +45 -0
  242. package/dist/global-skills/firebase-basics/references/setup/cursor.md +93 -0
  243. package/dist/global-skills/firebase-basics/references/setup/gemini_cli.md +53 -0
  244. package/dist/global-skills/firebase-basics/references/setup/github_copilot.md +104 -0
  245. package/dist/global-skills/firebase-basics/references/setup/other_agents.md +99 -0
  246. package/dist/global-skills/firebase-basics/references/web_setup.md +77 -0
  247. package/dist/global-skills/firebase-crashlytics/SKILL.md +42 -0
  248. package/dist/global-skills/firebase-crashlytics/references/android_setup.md +152 -0
  249. package/dist/global-skills/firebase-crashlytics/references/ios_setup.md +115 -0
  250. package/dist/global-skills/firebase-data-connect/SKILL.md +191 -0
  251. package/dist/global-skills/firebase-data-connect/examples.md +638 -0
  252. package/dist/global-skills/firebase-data-connect/reference/cloud_functions.md +184 -0
  253. package/dist/global-skills/firebase-data-connect/reference/config.md +271 -0
  254. package/dist/global-skills/firebase-data-connect/reference/data_seeding.md +185 -0
  255. package/dist/global-skills/firebase-data-connect/reference/native_sql.md +170 -0
  256. package/dist/global-skills/firebase-data-connect/reference/operations.md +385 -0
  257. package/dist/global-skills/firebase-data-connect/reference/realtime.md +210 -0
  258. package/dist/global-skills/firebase-data-connect/reference/schema.md +290 -0
  259. package/dist/global-skills/firebase-data-connect/reference/sdk_admin_node.md +141 -0
  260. package/dist/global-skills/firebase-data-connect/reference/sdk_android.md +126 -0
  261. package/dist/global-skills/firebase-data-connect/reference/sdk_flutter.md +134 -0
  262. package/dist/global-skills/firebase-data-connect/reference/sdk_ios.md +157 -0
  263. package/dist/global-skills/firebase-data-connect/reference/sdk_web.md +146 -0
  264. package/dist/global-skills/firebase-data-connect/reference/search.md +264 -0
  265. package/dist/global-skills/firebase-data-connect/reference/security.md +295 -0
  266. package/dist/global-skills/firebase-data-connect/templates.md +318 -0
  267. package/dist/global-skills/firebase-firestore/SKILL.md +89 -0
  268. package/dist/global-skills/firebase-firestore/references/enterprise/android_sdk_usage.md +230 -0
  269. package/dist/global-skills/firebase-firestore/references/enterprise/data_model.md +66 -0
  270. package/dist/global-skills/firebase-firestore/references/enterprise/flutter_setup.md +180 -0
  271. package/dist/global-skills/firebase-firestore/references/enterprise/indexes.md +135 -0
  272. package/dist/global-skills/firebase-firestore/references/enterprise/ios_setup.md +189 -0
  273. package/dist/global-skills/firebase-firestore/references/enterprise/provisioning.md +118 -0
  274. package/dist/global-skills/firebase-firestore/references/enterprise/python_sdk_usage.md +138 -0
  275. package/dist/global-skills/firebase-firestore/references/enterprise/security_rules.md +577 -0
  276. package/dist/global-skills/firebase-firestore/references/enterprise/web_sdk_usage.md +127 -0
  277. package/dist/global-skills/firebase-firestore/references/standard/android_sdk_usage.md +193 -0
  278. package/dist/global-skills/firebase-firestore/references/standard/flutter_setup.md +176 -0
  279. package/dist/global-skills/firebase-firestore/references/standard/indexes.md +113 -0
  280. package/dist/global-skills/firebase-firestore/references/standard/ios_setup.md +174 -0
  281. package/dist/global-skills/firebase-firestore/references/standard/provisioning.md +110 -0
  282. package/dist/global-skills/firebase-firestore/references/standard/security_rules.md +577 -0
  283. package/dist/global-skills/firebase-firestore/references/standard/web_sdk_usage.md +192 -0
  284. package/dist/global-skills/firebase-hosting-basics/SKILL.md +64 -0
  285. package/dist/global-skills/firebase-hosting-basics/references/configuration.md +115 -0
  286. package/dist/global-skills/firebase-hosting-basics/references/deploying.md +48 -0
  287. package/dist/global-skills/firebase-remote-config-basics/SKILL.md +124 -0
  288. package/dist/global-skills/firebase-remote-config-basics/references/android_setup.md +91 -0
  289. package/dist/global-skills/firebase-remote-config-basics/references/ios_setup.md +89 -0
  290. package/dist/global-skills/firebase-security-rules-auditor/SKILL.md +70 -0
  291. package/dist/global-skills/go-live/SKILL.md +90 -0
  292. package/dist/global-skills/harden/SKILL.md +101 -0
  293. package/dist/global-skills/instrument-feature-flags/SKILL.md +88 -0
  294. package/dist/global-skills/instrument-feature-flags/references/adding-feature-flag-code.md +3578 -0
  295. package/dist/global-skills/instrument-feature-flags/references/android.md +146 -0
  296. package/dist/global-skills/instrument-feature-flags/references/api.md +194 -0
  297. package/dist/global-skills/instrument-feature-flags/references/best-practices.md +231 -0
  298. package/dist/global-skills/instrument-feature-flags/references/django.md +263 -0
  299. package/dist/global-skills/instrument-feature-flags/references/dotnet.md +763 -0
  300. package/dist/global-skills/instrument-feature-flags/references/elixir.md +47 -0
  301. package/dist/global-skills/instrument-feature-flags/references/flask.md +131 -0
  302. package/dist/global-skills/instrument-feature-flags/references/flutter.md +212 -0
  303. package/dist/global-skills/instrument-feature-flags/references/go.md +208 -0
  304. package/dist/global-skills/instrument-feature-flags/references/ios.md +146 -0
  305. package/dist/global-skills/instrument-feature-flags/references/java.md +94 -0
  306. package/dist/global-skills/instrument-feature-flags/references/laravel.md +170 -0
  307. package/dist/global-skills/instrument-feature-flags/references/next-js.md +383 -0
  308. package/dist/global-skills/instrument-feature-flags/references/nodejs.md +216 -0
  309. package/dist/global-skills/instrument-feature-flags/references/php.md +187 -0
  310. package/dist/global-skills/instrument-feature-flags/references/python.md +191 -0
  311. package/dist/global-skills/instrument-feature-flags/references/react-native.md +166 -0
  312. package/dist/global-skills/instrument-feature-flags/references/react.md +302 -0
  313. package/dist/global-skills/instrument-feature-flags/references/ruby-on-rails.md +604 -0
  314. package/dist/global-skills/instrument-feature-flags/references/ruby.md +200 -0
  315. package/dist/global-skills/instrument-feature-flags/references/rust.md +222 -0
  316. package/dist/global-skills/instrument-feature-flags/references/usage.md +600 -0
  317. package/dist/global-skills/instrument-feature-flags/references/web.md +193 -0
  318. package/dist/global-skills/instrument-product-analytics/SKILL.md +139 -0
  319. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-android.md +1639 -0
  320. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-angular.md +944 -0
  321. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-astro-hybrid.md +1001 -0
  322. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-astro-ssr.md +1004 -0
  323. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-astro-static.md +720 -0
  324. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-astro-view-transitions.md +810 -0
  325. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-django.md +1167 -0
  326. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-expo.md +1412 -0
  327. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-fastapi.md +1585 -0
  328. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-flask.md +1208 -0
  329. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-laravel.md +2267 -0
  330. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-next-app-router.md +712 -0
  331. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-next-pages-router.md +767 -0
  332. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-nuxt-3-6.md +939 -0
  333. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-nuxt-4.md +1078 -0
  334. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-php.md +527 -0
  335. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-python.md +481 -0
  336. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-native.md +1823 -0
  337. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-react-router-6.md +582 -0
  338. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-react-router-7-data.md +892 -0
  339. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-react-router-7-declarative.md +649 -0
  340. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-react-router-7-framework.md +1218 -0
  341. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-tanstack-router-code-based.md +793 -0
  342. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-react-tanstack-router-file-based.md +780 -0
  343. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-ruby-on-rails.md +1320 -0
  344. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-ruby.md +452 -0
  345. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-sveltekit.md +854 -0
  346. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-swift.md +665 -0
  347. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-tanstack-start.md +1199 -0
  348. package/dist/global-skills/instrument-product-analytics/references/EXAMPLE-vue-3.md +910 -0
  349. package/dist/global-skills/instrument-product-analytics/references/android.md +811 -0
  350. package/dist/global-skills/instrument-product-analytics/references/angular.md +376 -0
  351. package/dist/global-skills/instrument-product-analytics/references/astro.md +165 -0
  352. package/dist/global-skills/instrument-product-analytics/references/configuration.md +299 -0
  353. package/dist/global-skills/instrument-product-analytics/references/django.md +263 -0
  354. package/dist/global-skills/instrument-product-analytics/references/dotnet.md +763 -0
  355. package/dist/global-skills/instrument-product-analytics/references/elixir.md +414 -0
  356. package/dist/global-skills/instrument-product-analytics/references/flask.md +131 -0
  357. package/dist/global-skills/instrument-product-analytics/references/flutter.md +845 -0
  358. package/dist/global-skills/instrument-product-analytics/references/go.md +567 -0
  359. package/dist/global-skills/instrument-product-analytics/references/identify-users.md +272 -0
  360. package/dist/global-skills/instrument-product-analytics/references/ios.md +154 -0
  361. package/dist/global-skills/instrument-product-analytics/references/laravel.md +170 -0
  362. package/dist/global-skills/instrument-product-analytics/references/next-js.md +383 -0
  363. package/dist/global-skills/instrument-product-analytics/references/nuxt-js-3-6.md +244 -0
  364. package/dist/global-skills/instrument-product-analytics/references/nuxt-js.md +253 -0
  365. package/dist/global-skills/instrument-product-analytics/references/php.md +646 -0
  366. package/dist/global-skills/instrument-product-analytics/references/posthog-python.md +1675 -0
  367. package/dist/global-skills/instrument-product-analytics/references/python.md +898 -0
  368. package/dist/global-skills/instrument-product-analytics/references/react-native.md +1338 -0
  369. package/dist/global-skills/instrument-product-analytics/references/react-router-v6.md +376 -0
  370. package/dist/global-skills/instrument-product-analytics/references/react-router-v7-data-mode.md +364 -0
  371. package/dist/global-skills/instrument-product-analytics/references/react-router-v7-declarative-mode.md +376 -0
  372. package/dist/global-skills/instrument-product-analytics/references/react-router-v7-framework-mode.md +479 -0
  373. package/dist/global-skills/instrument-product-analytics/references/ruby-on-rails.md +604 -0
  374. package/dist/global-skills/instrument-product-analytics/references/ruby.md +759 -0
  375. package/dist/global-skills/instrument-product-analytics/references/svelte.md +234 -0
  376. package/dist/global-skills/instrument-product-analytics/references/tanstack-start.md +193 -0
  377. package/dist/global-skills/instrument-product-analytics/references/usage.md +600 -0
  378. package/dist/global-skills/instrument-product-analytics/references/vue-js.md +306 -0
  379. package/dist/global-skills/manifest.json +125 -0
  380. package/dist/global-skills/mongodb-atlas-stream-processing/SKILL.md +284 -0
  381. package/dist/global-skills/mongodb-atlas-stream-processing/references/connection-configs.md +298 -0
  382. package/dist/global-skills/mongodb-atlas-stream-processing/references/development-workflow.md +304 -0
  383. package/dist/global-skills/mongodb-atlas-stream-processing/references/mcp-troubleshooting.md +55 -0
  384. package/dist/global-skills/mongodb-atlas-stream-processing/references/output-diagnostics.md +150 -0
  385. package/dist/global-skills/mongodb-atlas-stream-processing/references/pipeline-patterns.md +457 -0
  386. package/dist/global-skills/mongodb-atlas-stream-processing/references/sizing-and-parallelism.md +178 -0
  387. package/dist/global-skills/mongodb-connection/SKILL.md +201 -0
  388. package/dist/global-skills/mongodb-connection/references/monitoring-guide.md +191 -0
  389. package/dist/global-skills/mongodb-mcp-setup/SKILL.md +324 -0
  390. package/dist/global-skills/mongodb-natural-language-querying/SKILL.md +195 -0
  391. package/dist/global-skills/mongodb-query-optimizer/SKILL.md +150 -0
  392. package/dist/global-skills/mongodb-query-optimizer/references/aggregation-optimization.md +210 -0
  393. package/dist/global-skills/mongodb-query-optimizer/references/antipattern-examples.md +74 -0
  394. package/dist/global-skills/mongodb-query-optimizer/references/core-indexing-principles.md +134 -0
  395. package/dist/global-skills/mongodb-query-optimizer/references/update-query-examples.md +39 -0
  396. package/dist/global-skills/mongodb-schema-design/SKILL.md +181 -0
  397. package/dist/global-skills/mongodb-schema-design/references/antipattern-excessive-lookups.md +84 -0
  398. package/dist/global-skills/mongodb-schema-design/references/antipattern-unnecessary-collections.md +91 -0
  399. package/dist/global-skills/mongodb-schema-design/references/antipattern-unnecessary-indexes.md +95 -0
  400. package/dist/global-skills/mongodb-schema-design/references/fundamental-document-model.md +91 -0
  401. package/dist/global-skills/mongodb-schema-design/references/fundamental-document-size.md +226 -0
  402. package/dist/global-skills/mongodb-schema-design/references/fundamental-embed-vs-reference.md +418 -0
  403. package/dist/global-skills/mongodb-schema-design/references/fundamental-schema-validation.md +131 -0
  404. package/dist/global-skills/mongodb-schema-design/references/pattern-approximation.md +80 -0
  405. package/dist/global-skills/mongodb-schema-design/references/pattern-archive.md +143 -0
  406. package/dist/global-skills/mongodb-schema-design/references/pattern-attribute.md +77 -0
  407. package/dist/global-skills/mongodb-schema-design/references/pattern-bucket.md +102 -0
  408. package/dist/global-skills/mongodb-schema-design/references/pattern-computed.md +162 -0
  409. package/dist/global-skills/mongodb-schema-design/references/pattern-document-versioning.md +166 -0
  410. package/dist/global-skills/mongodb-schema-design/references/pattern-extended-reference.md +72 -0
  411. package/dist/global-skills/mongodb-schema-design/references/pattern-outlier.md +159 -0
  412. package/dist/global-skills/mongodb-schema-design/references/pattern-polymorphic.md +167 -0
  413. package/dist/global-skills/mongodb-schema-design/references/pattern-schema-versioning.md +273 -0
  414. package/dist/global-skills/mongodb-schema-design/references/pattern-time-series-collections.md +190 -0
  415. package/dist/global-skills/mongodb-schema-design/references/source-query-stats.md +123 -0
  416. package/dist/global-skills/mongodb-schema-design/references/source-slow-query-logs.md +63 -0
  417. package/dist/global-skills/mongodb-search-and-ai/SKILL.md +142 -0
  418. package/dist/global-skills/mongodb-search-and-ai/references/hybrid-search.md +697 -0
  419. package/dist/global-skills/mongodb-search-and-ai/references/lexical-search-indexing.md +584 -0
  420. package/dist/global-skills/mongodb-search-and-ai/references/lexical-search-querying.md +636 -0
  421. package/dist/global-skills/mongodb-search-and-ai/references/vector-search.md +746 -0
  422. package/dist/global-skills/native-data-fetching/SKILL.md +505 -0
  423. package/dist/global-skills/native-data-fetching/agents/openai.yaml +4 -0
  424. package/dist/global-skills/native-data-fetching/references/expo-router-loaders.md +341 -0
  425. package/dist/global-skills/neon/SKILL.md +343 -0
  426. package/dist/global-skills/neon-ai-gateway/SKILL.md +236 -0
  427. package/dist/global-skills/neon-functions/SKILL.md +490 -0
  428. package/dist/global-skills/neon-functions/references/ai-sdk.md +139 -0
  429. package/dist/global-skills/neon-functions/references/hono-websockets.md +145 -0
  430. package/dist/global-skills/neon-functions/references/mastra-studio.md +127 -0
  431. package/dist/global-skills/neon-functions/references/mcp.md +137 -0
  432. package/dist/global-skills/neon-functions/references/sentry.md +131 -0
  433. package/dist/global-skills/neon-functions/references/sse.md +143 -0
  434. package/dist/global-skills/neon-object-storage/SKILL.md +197 -0
  435. package/dist/global-skills/neon-postgres/SKILL.md +376 -0
  436. package/dist/global-skills/neon-postgres-branches/SKILL.md +281 -0
  437. package/dist/global-skills/neon-postgres-egress-optimizer/SKILL.md +247 -0
  438. package/dist/global-skills/onboarding/SKILL.md +101 -0
  439. package/dist/global-skills/plan-my-idea/SKILL.md +67 -0
  440. package/dist/global-skills/publish-app/SKILL.md +72 -0
  441. package/dist/global-skills/publish-extension/SKILL.md +47 -0
  442. package/dist/global-skills/resend/SKILL.md +294 -0
  443. package/dist/global-skills/resend/references/api-keys.md +98 -0
  444. package/dist/global-skills/resend/references/automations.md +228 -0
  445. package/dist/global-skills/resend/references/broadcasts.md +125 -0
  446. package/dist/global-skills/resend/references/contact-properties.md +111 -0
  447. package/dist/global-skills/resend/references/contacts.md +174 -0
  448. package/dist/global-skills/resend/references/domains.md +179 -0
  449. package/dist/global-skills/resend/references/events.md +119 -0
  450. package/dist/global-skills/resend/references/fetch-all-templates.mjs +37 -0
  451. package/dist/global-skills/resend/references/installation.md +142 -0
  452. package/dist/global-skills/resend/references/logs.md +161 -0
  453. package/dist/global-skills/resend/references/receiving.md +287 -0
  454. package/dist/global-skills/resend/references/segments.md +77 -0
  455. package/dist/global-skills/resend/references/sending/batch-email-examples.md +807 -0
  456. package/dist/global-skills/resend/references/sending/best-practices.md +453 -0
  457. package/dist/global-skills/resend/references/sending/email-management.md +135 -0
  458. package/dist/global-skills/resend/references/sending/overview.md +209 -0
  459. package/dist/global-skills/resend/references/sending/single-email-examples.md +470 -0
  460. package/dist/global-skills/resend/references/templates.md +202 -0
  461. package/dist/global-skills/resend/references/topics.md +104 -0
  462. package/dist/global-skills/resend/references/webhooks.md +317 -0
  463. package/dist/global-skills/reset-password/SKILL.md +59 -0
  464. package/dist/global-skills/save-data/SKILL.md +70 -0
  465. package/dist/global-skills/sentry-sdk-setup/SKILL.md +116 -0
  466. package/dist/global-skills/sentry-workflow/SKILL.md +32 -0
  467. package/dist/global-skills/setup-email/SKILL.md +69 -0
  468. package/dist/global-skills/setup-payments/SKILL.md +82 -0
  469. package/dist/global-skills/setup-sms/SKILL.md +51 -0
  470. package/dist/global-skills/sign-in-with-email-link/SKILL.md +53 -0
  471. package/dist/global-skills/sign-in-with-google/SKILL.md +68 -0
  472. package/dist/global-skills/sign-in-with-phone/SKILL.md +53 -0
  473. package/dist/global-skills/stripe-best-practices/SKILL.md +48 -0
  474. package/dist/global-skills/stripe-best-practices/references/billing.md +58 -0
  475. package/dist/global-skills/stripe-best-practices/references/connect.md +173 -0
  476. package/dist/global-skills/stripe-best-practices/references/payments.md +79 -0
  477. package/dist/global-skills/stripe-best-practices/references/security.md +109 -0
  478. package/dist/global-skills/stripe-best-practices/references/tax.md +37 -0
  479. package/dist/global-skills/stripe-best-practices/references/treasury.md +16 -0
  480. package/dist/global-skills/supabase/CHANGELOG.md +53 -0
  481. package/dist/global-skills/supabase/SKILL.md +145 -0
  482. package/dist/global-skills/supabase/assets/feedback-issue-template.md +17 -0
  483. package/dist/global-skills/supabase/references/skill-feedback.md +17 -0
  484. package/dist/global-skills/supabase-postgres-best-practices/CHANGELOG.md +43 -0
  485. package/dist/global-skills/supabase-postgres-best-practices/SKILL.md +64 -0
  486. package/dist/global-skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  487. package/dist/global-skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  488. package/dist/global-skills/supabase-postgres-best-practices/references/_template.md +34 -0
  489. package/dist/global-skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  490. package/dist/global-skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  491. package/dist/global-skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  492. package/dist/global-skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  493. package/dist/global-skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  494. package/dist/global-skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  495. package/dist/global-skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  496. package/dist/global-skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  497. package/dist/global-skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  498. package/dist/global-skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  499. package/dist/global-skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  500. package/dist/global-skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  501. package/dist/global-skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  502. package/dist/global-skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  503. package/dist/global-skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  504. package/dist/global-skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  505. package/dist/global-skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  506. package/dist/global-skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  507. package/dist/global-skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  508. package/dist/global-skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  509. package/dist/global-skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  510. package/dist/global-skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  511. package/dist/global-skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  512. package/dist/global-skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  513. package/dist/global-skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  514. package/dist/global-skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  515. package/dist/global-skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  516. package/dist/global-skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  517. package/dist/global-skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  518. package/dist/global-skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  519. package/dist/global-skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  520. package/dist/global-skills/track-errors/SKILL.md +67 -0
  521. package/dist/global-skills/update-kit/SKILL.md +75 -0
  522. package/dist/global-skills/upgrading-expo/SKILL.md +134 -0
  523. package/dist/global-skills/upgrading-expo/agents/openai.yaml +4 -0
  524. package/dist/global-skills/upgrading-expo/references/expo-av-to-audio.md +132 -0
  525. package/dist/global-skills/upgrading-expo/references/expo-av-to-video.md +160 -0
  526. package/dist/global-skills/upgrading-expo/references/native-tabs.md +124 -0
  527. package/dist/global-skills/upgrading-expo/references/new-architecture.md +79 -0
  528. package/dist/global-skills/upgrading-expo/references/react-19.md +79 -0
  529. package/dist/global-skills/upgrading-expo/references/react-compiler.md +59 -0
  530. package/dist/global-skills/upgrading-expo/references/react-navigation-to-expo-router.md +61 -0
  531. package/dist/global-skills/use-dom/SKILL.md +417 -0
  532. package/dist/global-skills/use-dom/agents/openai.yaml +4 -0
  533. package/dist/global-skills/use-kit-mcp/SKILL.md +100 -0
  534. package/dist/global-skills/use-railway/SKILL.md +357 -0
  535. package/dist/global-skills/use-railway/references/analyze-db-mongo.md +84 -0
  536. package/dist/global-skills/use-railway/references/analyze-db-mysql.md +254 -0
  537. package/dist/global-skills/use-railway/references/analyze-db-postgres.md +479 -0
  538. package/dist/global-skills/use-railway/references/analyze-db-redis.md +208 -0
  539. package/dist/global-skills/use-railway/references/analyze-db.md +344 -0
  540. package/dist/global-skills/use-railway/references/configure.md +359 -0
  541. package/dist/global-skills/use-railway/references/deploy.md +225 -0
  542. package/dist/global-skills/use-railway/references/feature-flags.md +89 -0
  543. package/dist/global-skills/use-railway/references/iac.md +108 -0
  544. package/dist/global-skills/use-railway/references/operate.md +273 -0
  545. package/dist/global-skills/use-railway/references/request.md +262 -0
  546. package/dist/global-skills/use-railway/references/sandbox.md +167 -0
  547. package/dist/global-skills/use-railway/references/setup.md +364 -0
  548. package/dist/global-skills/use-railway/scripts/analyze-mongo.py +1549 -0
  549. package/dist/global-skills/use-railway/scripts/analyze-mysql.py +1195 -0
  550. package/dist/global-skills/use-railway/scripts/analyze-postgres.py +3058 -0
  551. package/dist/global-skills/use-railway/scripts/analyze-redis.py +1090 -0
  552. package/dist/global-skills/use-railway/scripts/dal.py +671 -0
  553. package/dist/global-skills/use-railway/scripts/enable-pg-stats.py +170 -0
  554. package/dist/global-skills/use-railway/scripts/pg-extensions.py +370 -0
  555. package/dist/global-skills/use-railway/scripts/railway-api.sh +52 -0
  556. package/dist/global-skills/vercel-composition-patterns/AGENTS.md +946 -0
  557. package/dist/global-skills/vercel-composition-patterns/README.md +60 -0
  558. package/dist/global-skills/vercel-composition-patterns/SKILL.md +89 -0
  559. package/dist/global-skills/vercel-composition-patterns/metadata.json +11 -0
  560. package/dist/global-skills/vercel-composition-patterns/rules/_sections.md +29 -0
  561. package/dist/global-skills/vercel-composition-patterns/rules/_template.md +24 -0
  562. package/dist/global-skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  563. package/dist/global-skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  564. package/dist/global-skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  565. package/dist/global-skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  566. package/dist/global-skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  567. package/dist/global-skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  568. package/dist/global-skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  569. package/dist/global-skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  570. package/dist/global-skills/vercel-react-best-practices/AGENTS.md +3810 -0
  571. package/dist/global-skills/vercel-react-best-practices/README.md +123 -0
  572. package/dist/global-skills/vercel-react-best-practices/SKILL.md +149 -0
  573. package/dist/global-skills/vercel-react-best-practices/metadata.json +15 -0
  574. package/dist/global-skills/vercel-react-best-practices/rules/_sections.md +46 -0
  575. package/dist/global-skills/vercel-react-best-practices/rules/_template.md +28 -0
  576. package/dist/global-skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  577. package/dist/global-skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  578. package/dist/global-skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  579. package/dist/global-skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  580. package/dist/global-skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  581. package/dist/global-skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  582. package/dist/global-skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  583. package/dist/global-skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  584. package/dist/global-skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  585. package/dist/global-skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  586. package/dist/global-skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  587. package/dist/global-skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  588. package/dist/global-skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  589. package/dist/global-skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  590. package/dist/global-skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  591. package/dist/global-skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  592. package/dist/global-skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  593. package/dist/global-skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  594. package/dist/global-skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  595. package/dist/global-skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  596. package/dist/global-skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  597. package/dist/global-skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  598. package/dist/global-skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  599. package/dist/global-skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  600. package/dist/global-skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  601. package/dist/global-skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  602. package/dist/global-skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  603. package/dist/global-skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  604. package/dist/global-skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  605. package/dist/global-skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  606. package/dist/global-skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  607. package/dist/global-skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  608. package/dist/global-skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  609. package/dist/global-skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  610. package/dist/global-skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  611. package/dist/global-skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  612. package/dist/global-skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  613. package/dist/global-skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  614. package/dist/global-skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  615. package/dist/global-skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  616. package/dist/global-skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  617. package/dist/global-skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  618. package/dist/global-skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  619. package/dist/global-skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  620. package/dist/global-skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  621. package/dist/global-skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  622. package/dist/global-skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  623. package/dist/global-skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  624. package/dist/global-skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  625. package/dist/global-skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  626. package/dist/global-skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  627. package/dist/global-skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  628. package/dist/global-skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  629. package/dist/global-skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  630. package/dist/global-skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  631. package/dist/global-skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  632. package/dist/global-skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  633. package/dist/global-skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  634. package/dist/global-skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  635. package/dist/global-skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  636. package/dist/global-skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  637. package/dist/global-skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  638. package/dist/global-skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  639. package/dist/global-skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  640. package/dist/global-skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  641. package/dist/global-skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  642. package/dist/global-skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  643. package/dist/global-skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  644. package/dist/global-skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  645. package/dist/global-skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  646. package/dist/global-skills/web-to-native/SKILL.md +83 -0
  647. package/dist/global-skills/web-to-native/references/false-friends.md +119 -0
  648. package/dist/global-skills/web-to-native/references/native-patterns.md +39 -0
  649. package/dist/global-skills/web-to-native/references/run-as-goal.md +48 -0
  650. package/dist/global-skills/web-to-native/references/verify-on-device.md +45 -0
  651. package/dist/global-skills/wire-auth/SKILL.md +28 -0
  652. package/dist/global-skills/wire-database/SKILL.md +28 -0
  653. package/dist/global-skills/wire-email/SKILL.md +27 -0
  654. package/dist/global-skills/wire-payments/SKILL.md +27 -0
  655. package/dist/global-skills/workers-best-practices/SKILL.md +127 -0
  656. package/dist/global-skills/workers-best-practices/references/review.md +174 -0
  657. package/dist/global-skills/workers-best-practices/references/rules.md +463 -0
  658. package/dist/global-skills/wrangler/SKILL.md +922 -0
  659. package/dist/global-skills/xcode-project-setup/SKILL.md +140 -0
  660. package/dist/global-skills/xcode-project-setup/scripts/xcode_spm_setup/Package.resolved +41 -0
  661. package/dist/global-skills/xcode-project-setup/scripts/xcode_spm_setup/Package.swift +17 -0
  662. package/dist/global-skills/xcode-project-setup/scripts/xcode_spm_setup/Sources/main.swift +232 -0
  663. package/package.json +21 -20
  664. package/LICENSE.md +0 -47
  665. package/dist/index.js +0 -21593
@@ -0,0 +1,944 @@
1
+ # PostHog angular Example Project
2
+
3
+ Repository: https://github.com/PostHog/context-mill
4
+ Path: example-apps/angular
5
+
6
+ ---
7
+
8
+ ## README.md
9
+
10
+ # PostHog Angular Example
11
+
12
+ This is an [Angular](https://angular.dev/) example demonstrating PostHog integration with product analytics, session replay, and error tracking.
13
+
14
+ ## Features
15
+
16
+ - **Product analytics**: Track user events and behaviors
17
+ - **Session replay**: Record and replay user sessions
18
+ - **Error tracking**: Capture and track errors
19
+ - **User authentication**: Demo login system with PostHog user identification
20
+ - **SSR-safe**: Uses platform checks for browser-only PostHog calls
21
+ - **Reverse proxy**: PostHog ingestion through Angular proxy
22
+
23
+ ## Getting started
24
+
25
+ ### 1. Install dependencies
26
+
27
+ ```bash
28
+ pnpm install
29
+ ```
30
+
31
+ ### 2. Configure environment variables
32
+
33
+ Create a `.env` file in the root directory:
34
+
35
+ ```bash
36
+ VITE_POSTHOG_PROJECT_TOKEN=your_posthog_project_token
37
+ VITE_POSTHOG_HOST=https://us.posthog.com
38
+ ```
39
+
40
+ Get your PostHog project token from your [PostHog project settings](https://app.posthog.com/project/settings).
41
+
42
+ ### 3. Run the development server
43
+
44
+ ```bash
45
+ pnpm start
46
+ ```
47
+
48
+ Open [http://localhost:3000](http://localhost:3000) with your browser to see the app.
49
+
50
+ ## Project structure
51
+
52
+ ```
53
+ src/
54
+ ├── app/
55
+ │ ├── components/
56
+ │ │ └── header/ # Navigation header with auth state
57
+ │ ├── pages/
58
+ │ │ ├── home/ # Home/Login page
59
+ │ │ ├── burrito/ # Demo feature page with event tracking
60
+ │ │ └── profile/ # User profile with error tracking demo
61
+ │ ├── services/
62
+ │ │ ├── posthog.service.ts # PostHog service wrapper (SSR-safe)
63
+ │ │ └── auth.service.ts # Auth service with PostHog integration
64
+ │ ├── guards/
65
+ │ │ └── auth.guard.ts # Route guard for protected pages
66
+ │ ├── app.component.ts # Root component with PostHog init
67
+ │ ├── app.routes.ts # Route definitions
68
+ │ └── app.config.ts # App configuration
69
+ ├── environments/
70
+ │ ├── environment.ts # Dev environment config
71
+ │ └── environment.production.ts
72
+ └── main.ts # App entry point
73
+ ```
74
+
75
+ ## Key integration points
76
+
77
+ ### PostHog service (services/posthog.service.ts)
78
+
79
+ A wrapper service that handles SSR safety and provides access to the PostHog instance:
80
+
81
+ ```typescript
82
+ import { Injectable, inject, PLATFORM_ID } from '@angular/core';
83
+ import { isPlatformBrowser } from '@angular/common';
84
+ import posthog from 'posthog-js';
85
+
86
+ @Injectable({ providedIn: 'root' })
87
+ export class PostHogService {
88
+ private readonly platformId = inject(PLATFORM_ID);
89
+
90
+ get posthog(): typeof posthog {
91
+ if (isPlatformBrowser(this.platformId)) {
92
+ return posthog;
93
+ }
94
+ // Return a no-op proxy for SSR safety
95
+ return new Proxy({} as typeof posthog, {
96
+ get: () => () => undefined,
97
+ });
98
+ }
99
+
100
+ init(apiKey: string, options: Partial<PostHogConfig>): void {
101
+ if (isPlatformBrowser(this.platformId)) {
102
+ posthog.init(apiKey, options);
103
+ }
104
+ }
105
+ }
106
+ ```
107
+
108
+ ### PostHog initialization (app.component.ts)
109
+
110
+ PostHog is initialized in the root component's `ngOnInit`:
111
+
112
+ ```typescript
113
+ import { PostHogService } from './services/posthog.service';
114
+ import { environment } from '../environments/environment';
115
+
116
+ export class AppComponent implements OnInit {
117
+ private readonly posthogService = inject(PostHogService);
118
+
119
+ ngOnInit(): void {
120
+ this.posthogService.init(environment.posthogKey, {
121
+ api_host: '/ingest',
122
+ ui_host: environment.posthogHost || 'https://us.posthog.com',
123
+ capture_exceptions: true,
124
+ });
125
+ }
126
+ }
127
+ ```
128
+
129
+ ### User identification (services/auth.service.ts)
130
+
131
+ ```typescript
132
+ import { PostHogService } from './posthog.service';
133
+
134
+ const posthogService = inject(PostHogService);
135
+
136
+ posthogService.posthog.identify(username, {
137
+ username,
138
+ isNewUser,
139
+ });
140
+ ```
141
+
142
+ ### Event tracking (pages/burrito/burrito.component.ts)
143
+
144
+ ```typescript
145
+ import { PostHogService } from '../../services/posthog.service';
146
+
147
+ const posthogService = inject(PostHogService);
148
+
149
+ posthogService.posthog.capture('burrito_considered', {
150
+ total_considerations: count,
151
+ username: username,
152
+ });
153
+ ```
154
+
155
+ ### Error tracking (pages/profile/profile.component.ts)
156
+
157
+ ```typescript
158
+ posthogService.posthog.captureException(error);
159
+ ```
160
+
161
+ ## Angular-specific details
162
+
163
+ This example uses Angular 21 with modern features:
164
+
165
+ 1. **Standalone components**: No NgModules, all components use `standalone: true`
166
+ 2. **Signals**: Reactive state management with Angular signals
167
+ 3. **SSR support**: Uses `isPlatformBrowser()` checks for SSR safety
168
+ 4. **Dependency injection**: PostHog wrapped in an injectable service
169
+ 5. **Proxy configuration**: Uses `proxy.conf.json` for PostHog API calls
170
+ 6. **Environment files**: Generated from `.env` at build time via prebuild script
171
+
172
+ ## Environment variable handling
173
+
174
+ Angular CLI doesn't natively support `.env` files. This project uses a prebuild script:
175
+
176
+ 1. `scripts/generate-env.js` reads `.env` and generates `environment.generated.ts`
177
+ 2. The script runs automatically before `pnpm start` and `pnpm build`
178
+ 3. Environment files import from the generated file
179
+
180
+ ## Learn more
181
+
182
+ - [PostHog Documentation](https://posthog.com/docs)
183
+ - [Angular Documentation](https://angular.dev/)
184
+ - [PostHog JavaScript Web SDK](https://posthog.com/docs/libraries/js)
185
+
186
+ ---
187
+
188
+ ## .env.example
189
+
190
+ ```example
191
+ NG_APP_POSTHOG_PROJECT_TOKEN=<ph_project_token>
192
+ NG_APP_POSTHOG_HOST=https://us.posthog.com
193
+
194
+ ```
195
+
196
+ ---
197
+
198
+ ## src/app/app.component.ts
199
+
200
+ ```ts
201
+ import {
202
+ Component,
203
+ inject,
204
+ OnInit,
205
+ PLATFORM_ID,
206
+ ChangeDetectionStrategy,
207
+ } from '@angular/core';
208
+ import { isPlatformBrowser } from '@angular/common';
209
+ import { RouterOutlet } from '@angular/router';
210
+ import { HeaderComponent } from './components/header/header.component';
211
+ import { PostHogService } from './services/posthog.service';
212
+ import { environment } from '../environments/environment';
213
+
214
+ @Component({
215
+ selector: 'app-root',
216
+ imports: [RouterOutlet, HeaderComponent],
217
+ template: `
218
+ <app-header />
219
+ <router-outlet />
220
+ `,
221
+ changeDetection: ChangeDetectionStrategy.OnPush,
222
+ })
223
+ export class AppComponent implements OnInit {
224
+ private readonly platformId = inject(PLATFORM_ID);
225
+ private readonly posthogService = inject(PostHogService);
226
+
227
+ ngOnInit(): void {
228
+ if (isPlatformBrowser(this.platformId)) {
229
+ this.posthogService.init(environment.posthogKey, {
230
+ api_host: '/ingest',
231
+ ui_host: environment.posthogHost || 'https://us.posthog.com',
232
+ capture_exceptions: true,
233
+ });
234
+ }
235
+ }
236
+ }
237
+
238
+ ```
239
+
240
+ ---
241
+
242
+ ## src/app/app.config.server.ts
243
+
244
+ ```ts
245
+ import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
246
+ import { provideServerRendering, withRoutes } from '@angular/ssr';
247
+ import { appConfig } from './app.config';
248
+ import { serverRoutes } from './app.routes.server';
249
+
250
+ const serverConfig: ApplicationConfig = {
251
+ providers: [provideServerRendering(withRoutes(serverRoutes))],
252
+ };
253
+
254
+ export const config = mergeApplicationConfig(appConfig, serverConfig);
255
+
256
+ ```
257
+
258
+ ---
259
+
260
+ ## src/app/app.config.ts
261
+
262
+ ```ts
263
+ import { ApplicationConfig } from '@angular/core';
264
+ import { provideRouter, withComponentInputBinding } from '@angular/router';
265
+ import {
266
+ provideClientHydration,
267
+ withEventReplay,
268
+ } from '@angular/platform-browser';
269
+ import { provideHttpClient, withFetch } from '@angular/common/http';
270
+ import { routes } from './app.routes';
271
+
272
+ export const appConfig: ApplicationConfig = {
273
+ providers: [
274
+ provideRouter(routes, withComponentInputBinding()),
275
+ provideHttpClient(withFetch()),
276
+ provideClientHydration(withEventReplay()),
277
+ ],
278
+ };
279
+
280
+ ```
281
+
282
+ ---
283
+
284
+ ## src/app/app.routes.server.ts
285
+
286
+ ```ts
287
+ import { RenderMode, ServerRoute } from '@angular/ssr';
288
+
289
+ export const serverRoutes: ServerRoute[] = [
290
+ {
291
+ path: '',
292
+ renderMode: RenderMode.Server,
293
+ },
294
+ {
295
+ path: 'burrito',
296
+ renderMode: RenderMode.Client, // Protected route, render client-side
297
+ },
298
+ {
299
+ path: 'profile',
300
+ renderMode: RenderMode.Client, // Protected route, render client-side
301
+ },
302
+ {
303
+ path: '**',
304
+ renderMode: RenderMode.Server,
305
+ },
306
+ ];
307
+
308
+ ```
309
+
310
+ ---
311
+
312
+ ## src/app/app.routes.ts
313
+
314
+ ```ts
315
+ import { Routes } from '@angular/router';
316
+ import { authGuard } from './guards/auth.guard';
317
+
318
+ export const routes: Routes = [
319
+ {
320
+ path: '',
321
+ title: 'Burrito Consideration App',
322
+ loadComponent: () =>
323
+ import('./pages/home/home.component').then((m) => m.HomeComponent),
324
+ },
325
+ {
326
+ path: 'burrito',
327
+ title: 'Burrito Consideration - Burrito Consideration App',
328
+ loadComponent: () =>
329
+ import('./pages/burrito/burrito.component').then(
330
+ (m) => m.BurritoComponent
331
+ ),
332
+ canActivate: [authGuard],
333
+ },
334
+ {
335
+ path: 'profile',
336
+ title: 'Profile - Burrito Consideration App',
337
+ loadComponent: () =>
338
+ import('./pages/profile/profile.component').then(
339
+ (m) => m.ProfileComponent
340
+ ),
341
+ canActivate: [authGuard],
342
+ },
343
+ {
344
+ path: '**',
345
+ redirectTo: '',
346
+ },
347
+ ];
348
+
349
+ ```
350
+
351
+ ---
352
+
353
+ ## src/app/components/header/header.component.ts
354
+
355
+ ```ts
356
+ import { Component, inject, ChangeDetectionStrategy } from '@angular/core';
357
+ import { RouterLink } from '@angular/router';
358
+ import { AuthService } from '../../services/auth.service';
359
+
360
+ @Component({
361
+ selector: 'app-header',
362
+ imports: [RouterLink],
363
+ template: `
364
+ <a class="skip-link" href="#main-content">Skip to main content</a>
365
+ <header class="header" role="banner">
366
+ <div class="header-container">
367
+ <nav aria-label="Main navigation">
368
+ <a routerLink="/">Home</a>
369
+ @if (auth.isAuthenticated()) {
370
+ <a routerLink="/burrito">Burrito Consideration</a>
371
+ <a routerLink="/profile">Profile</a>
372
+ }
373
+ </nav>
374
+ <div class="user-section">
375
+ @if (auth.user(); as user) {
376
+ <span>Welcome, {{ user.username }}!</span>
377
+ <button (click)="auth.logout()" class="btn-logout">Logout</button>
378
+ } @else {
379
+ <span>Not logged in</span>
380
+ }
381
+ </div>
382
+ </div>
383
+ </header>
384
+ `,
385
+ changeDetection: ChangeDetectionStrategy.OnPush,
386
+ })
387
+ export class HeaderComponent {
388
+ readonly auth = inject(AuthService);
389
+ }
390
+
391
+ ```
392
+
393
+ ---
394
+
395
+ ## src/app/guards/auth.guard.ts
396
+
397
+ ```ts
398
+ import { inject } from '@angular/core';
399
+ import { Router, CanActivateFn } from '@angular/router';
400
+ import { AuthService } from '../services/auth.service';
401
+
402
+ export const authGuard: CanActivateFn = () => {
403
+ const auth = inject(AuthService);
404
+ const router = inject(Router);
405
+
406
+ if (auth.isAuthenticated()) {
407
+ return true;
408
+ }
409
+
410
+ return router.createUrlTree(['/']);
411
+ };
412
+
413
+ ```
414
+
415
+ ---
416
+
417
+ ## src/app/pages/burrito/burrito.component.ts
418
+
419
+ ```ts
420
+ import {
421
+ Component,
422
+ inject,
423
+ signal,
424
+ ChangeDetectionStrategy,
425
+ } from '@angular/core';
426
+ import { Router } from '@angular/router';
427
+ import { AuthService } from '../../services/auth.service';
428
+ import { PostHogService } from '../../services/posthog.service';
429
+
430
+ @Component({
431
+ selector: 'app-burrito',
432
+ template: `
433
+ <main id="main-content" tabindex="-1">
434
+ <div class="container">
435
+ <h1>Burrito consideration zone</h1>
436
+ <p>Take a moment to truly consider the potential of burritos.</p>
437
+
438
+ <div style="text-align: center">
439
+ <button (click)="handleConsideration()" class="btn-burrito">
440
+ I have considered the burrito potential
441
+ </button>
442
+
443
+ @if (hasConsidered()) {
444
+ <p class="success" role="status" aria-live="polite">
445
+ Thank you for your consideration! Count:
446
+ {{ auth.user()?.burritoConsiderations }}
447
+ </p>
448
+ }
449
+ </div>
450
+
451
+ <div class="stats">
452
+ <h3>Consideration stats</h3>
453
+ <p>Total considerations: {{ auth.user()?.burritoConsiderations }}</p>
454
+ </div>
455
+ </div>
456
+ </main>
457
+ `,
458
+ changeDetection: ChangeDetectionStrategy.OnPush,
459
+ })
460
+ export class BurritoComponent {
461
+ readonly auth = inject(AuthService);
462
+ private readonly posthogService = inject(PostHogService);
463
+ private readonly router = inject(Router);
464
+
465
+ hasConsidered = signal(false);
466
+
467
+ constructor() {
468
+ // Redirect if not authenticated
469
+ if (!this.auth.isAuthenticated()) {
470
+ this.router.navigate(['/']);
471
+ }
472
+ }
473
+
474
+ handleConsideration(): void {
475
+ const user = this.auth.user();
476
+ if (!user) return;
477
+
478
+ this.auth.incrementBurritoConsiderations();
479
+ this.hasConsidered.set(true);
480
+ setTimeout(() => this.hasConsidered.set(false), 2000);
481
+
482
+ this.posthogService.posthog.capture('burrito_considered', {
483
+ total_considerations: user.burritoConsiderations + 1,
484
+ username: user.username,
485
+ });
486
+ }
487
+ }
488
+
489
+ ```
490
+
491
+ ---
492
+
493
+ ## src/app/pages/home/home.component.ts
494
+
495
+ ```ts
496
+ import {
497
+ Component,
498
+ inject,
499
+ signal,
500
+ ChangeDetectionStrategy,
501
+ } from '@angular/core';
502
+ import { ReactiveFormsModule, FormBuilder, Validators } from '@angular/forms';
503
+ import { AuthService } from '../../services/auth.service';
504
+
505
+ @Component({
506
+ selector: 'app-home',
507
+ imports: [ReactiveFormsModule],
508
+ template: `
509
+ <main id="main-content" tabindex="-1">
510
+ @if (auth.user(); as user) {
511
+ <div class="container">
512
+ <h1>Welcome back, {{ user.username }}!</h1>
513
+ <p>You are logged in. Feel free to explore:</p>
514
+ <ul>
515
+ <li>Consider the potential of burritos</li>
516
+ <li>View your profile and statistics</li>
517
+ </ul>
518
+ </div>
519
+ } @else {
520
+ <div class="container">
521
+ <h1>Welcome to Burrito Consideration App</h1>
522
+ <p>Please sign in to begin your burrito journey</p>
523
+
524
+ <form [formGroup]="loginForm" (ngSubmit)="handleSubmit()" class="form">
525
+ <div class="form-group">
526
+ <label for="username">Username:</label>
527
+ <input
528
+ type="text"
529
+ id="username"
530
+ formControlName="username"
531
+ placeholder="Enter any username"
532
+ autocomplete="username"
533
+ />
534
+ </div>
535
+
536
+ <div class="form-group">
537
+ <label for="password">Password:</label>
538
+ <input
539
+ type="password"
540
+ id="password"
541
+ formControlName="password"
542
+ placeholder="Enter any password"
543
+ autocomplete="current-password"
544
+ />
545
+ </div>
546
+
547
+ @if (error()) {
548
+ <p class="error" role="alert">{{ error() }}</p>
549
+ }
550
+
551
+ <button type="submit" class="btn-primary">Sign In</button>
552
+ </form>
553
+
554
+ <p class="note">
555
+ Note: This is a demo app. Use any username and password to sign in.
556
+ </p>
557
+ </div>
558
+ }
559
+ </main>
560
+ `,
561
+ changeDetection: ChangeDetectionStrategy.OnPush,
562
+ })
563
+ export class HomeComponent {
564
+ private readonly fb = inject(FormBuilder);
565
+ readonly auth = inject(AuthService);
566
+
567
+ loginForm = this.fb.nonNullable.group({
568
+ username: ['', Validators.required],
569
+ password: ['', Validators.required],
570
+ });
571
+
572
+ error = signal('');
573
+
574
+ handleSubmit(): void {
575
+ this.error.set('');
576
+
577
+ if (this.loginForm.invalid) {
578
+ this.error.set('Please provide both username and password');
579
+ return;
580
+ }
581
+
582
+ const { username, password } = this.loginForm.getRawValue();
583
+
584
+ const success = this.auth.login(username, password);
585
+ if (success) {
586
+ this.loginForm.reset();
587
+ } else {
588
+ this.error.set('Please provide both username and password');
589
+ }
590
+ }
591
+ }
592
+
593
+ ```
594
+
595
+ ---
596
+
597
+ ## src/app/pages/profile/profile.component.ts
598
+
599
+ ```ts
600
+ import {
601
+ Component,
602
+ inject,
603
+ computed,
604
+ ChangeDetectionStrategy,
605
+ } from '@angular/core';
606
+ import { Router } from '@angular/router';
607
+ import { AuthService } from '../../services/auth.service';
608
+ import { PostHogService } from '../../services/posthog.service';
609
+
610
+ @Component({
611
+ selector: 'app-profile',
612
+ template: `
613
+ <main id="main-content" tabindex="-1">
614
+ <div class="container">
615
+ <h1>User Profile</h1>
616
+
617
+ <div class="stats">
618
+ <h2>Your Information</h2>
619
+ <p><strong>Username:</strong> {{ auth.user()?.username }}</p>
620
+ <p>
621
+ <strong>Burrito Considerations:</strong>
622
+ {{ auth.user()?.burritoConsiderations }}
623
+ </p>
624
+ </div>
625
+
626
+ <div style="margin-top: 2rem">
627
+ <button
628
+ (click)="triggerTestError()"
629
+ class="btn-primary"
630
+ style="background-color: #dc3545"
631
+ >
632
+ Trigger Test Error (for PostHog)
633
+ </button>
634
+ </div>
635
+
636
+ <div style="margin-top: 2rem">
637
+ <h3>Your Burrito Journey</h3>
638
+ <p>{{ journeyMessage() }}</p>
639
+ </div>
640
+ </div>
641
+ </main>
642
+ `,
643
+ changeDetection: ChangeDetectionStrategy.OnPush,
644
+ })
645
+ export class ProfileComponent {
646
+ readonly auth = inject(AuthService);
647
+ private readonly posthogService = inject(PostHogService);
648
+ private readonly router = inject(Router);
649
+
650
+ journeyMessage = computed(() => {
651
+ const count = this.auth.user()?.burritoConsiderations ?? 0;
652
+
653
+ if (count === 0) {
654
+ return "You haven't considered any burritos yet. Visit the Burrito Consideration page to start!";
655
+ } else if (count === 1) {
656
+ return "You've considered the burrito potential once. Keep going!";
657
+ } else if (count < 5) {
658
+ return "You're getting the hang of burrito consideration!";
659
+ } else if (count < 10) {
660
+ return "You're becoming a burrito consideration expert!";
661
+ } else {
662
+ return 'You are a true burrito consideration master!';
663
+ }
664
+ });
665
+
666
+ constructor() {
667
+ if (!this.auth.isAuthenticated()) {
668
+ this.router.navigate(['/']);
669
+ }
670
+ }
671
+
672
+ triggerTestError(): void {
673
+ try {
674
+ throw new Error('Test error for PostHog error tracking');
675
+ } catch (err) {
676
+ const error = err as Error;
677
+ this.posthogService.posthog.captureException(error);
678
+ console.error('Captured error:', err);
679
+ alert('Error captured and sent to PostHog!');
680
+ }
681
+ }
682
+ }
683
+
684
+ ```
685
+
686
+ ---
687
+
688
+ ## src/app/services/auth.service.ts
689
+
690
+ ```ts
691
+ import {
692
+ Injectable,
693
+ signal,
694
+ computed,
695
+ inject,
696
+ PLATFORM_ID,
697
+ } from '@angular/core';
698
+ import { isPlatformBrowser } from '@angular/common';
699
+ import { PostHogService } from './posthog.service';
700
+
701
+ export interface User {
702
+ username: string;
703
+ burritoConsiderations: number;
704
+ }
705
+
706
+ @Injectable({ providedIn: 'root' })
707
+ export class AuthService {
708
+ private readonly platformId = inject(PLATFORM_ID);
709
+ private readonly posthogService = inject(PostHogService);
710
+
711
+ // In-memory user store (matches TanStack behavior)
712
+ private readonly users = new Map<string, User>();
713
+
714
+ // Signals for reactive state
715
+ private readonly _user = signal<User | null>(null);
716
+
717
+ // Public computed signals
718
+ readonly user = this._user.asReadonly();
719
+ readonly isAuthenticated = computed(() => this._user() !== null);
720
+
721
+ constructor() {
722
+ // Initialize from localStorage on browser
723
+ if (isPlatformBrowser(this.platformId)) {
724
+ const storedUsername = localStorage.getItem('currentUser');
725
+ if (storedUsername) {
726
+ const existingUser = this.users.get(storedUsername);
727
+ if (existingUser) {
728
+ this._user.set(existingUser);
729
+ }
730
+ }
731
+ }
732
+ }
733
+
734
+ login(username: string, password: string): boolean {
735
+ if (!username || !password) {
736
+ return false;
737
+ }
738
+
739
+ // Get or create user in local map (no API call)
740
+ let user = this.users.get(username);
741
+ const isNewUser = !user;
742
+
743
+ if (!user) {
744
+ user = { username, burritoConsiderations: 0 };
745
+ this.users.set(username, user);
746
+ }
747
+
748
+ this._user.set(user);
749
+
750
+ if (isPlatformBrowser(this.platformId)) {
751
+ localStorage.setItem('currentUser', username);
752
+ }
753
+
754
+ // PostHog identification (client-side only)
755
+ this.posthogService.posthog.identify(username, {
756
+ username,
757
+ isNewUser,
758
+ });
759
+
760
+ this.posthogService.posthog.capture('user_logged_in', {
761
+ username,
762
+ isNewUser,
763
+ });
764
+
765
+ return true;
766
+ }
767
+
768
+ logout(): void {
769
+ this.posthogService.posthog.capture('user_logged_out');
770
+ this.posthogService.posthog.reset();
771
+
772
+ this._user.set(null);
773
+
774
+ if (isPlatformBrowser(this.platformId)) {
775
+ localStorage.removeItem('currentUser');
776
+ }
777
+ }
778
+
779
+ incrementBurritoConsiderations(): void {
780
+ const currentUser = this._user();
781
+ if (currentUser) {
782
+ const updated = {
783
+ ...currentUser,
784
+ burritoConsiderations: currentUser.burritoConsiderations + 1,
785
+ };
786
+ this.users.set(currentUser.username, updated);
787
+ this._user.set(updated);
788
+ }
789
+ }
790
+ }
791
+
792
+ ```
793
+
794
+ ---
795
+
796
+ ## src/app/services/posthog.service.ts
797
+
798
+ ```ts
799
+ import { Injectable, inject, PLATFORM_ID } from '@angular/core';
800
+ import { isPlatformBrowser } from '@angular/common';
801
+ import posthog, { PostHogConfig } from 'posthog-js';
802
+
803
+ @Injectable({ providedIn: 'root' })
804
+ export class PostHogService {
805
+ private readonly platformId = inject(PLATFORM_ID);
806
+ private initialized = false;
807
+
808
+ /**
809
+ * The posthog instance. Use this directly to call posthog methods.
810
+ * Returns the actual posthog instance on browser, or a no-op proxy on server.
811
+ */
812
+ get posthog(): typeof posthog {
813
+ if (isPlatformBrowser(this.platformId) && this.initialized) {
814
+ return posthog;
815
+ }
816
+ // Return a no-op proxy for SSR safety
817
+ return new Proxy({} as typeof posthog, {
818
+ get: () => () => undefined,
819
+ });
820
+ }
821
+
822
+ init(apiKey: string, options: Partial<PostHogConfig>): void {
823
+ if (isPlatformBrowser(this.platformId) && !this.initialized) {
824
+ posthog.init(apiKey, options);
825
+ this.initialized = true;
826
+ }
827
+ }
828
+ }
829
+
830
+ ```
831
+
832
+ ---
833
+
834
+ ## src/env.d.ts
835
+
836
+ ```ts
837
+ // Define the type of the environment variables.
838
+ declare interface Env {
839
+ readonly NODE_ENV: string;
840
+ readonly NG_APP_POSTHOG_PROJECT_TOKEN: string;
841
+ readonly NG_APP_POSTHOG_HOST: string;
842
+ }
843
+
844
+ // Use import.meta.env.YOUR_ENV_VAR in your code.
845
+ declare interface ImportMeta {
846
+ readonly env: Env;
847
+ }
848
+
849
+ ```
850
+
851
+ ---
852
+
853
+ ## src/environments/environment.prod.ts
854
+
855
+ ```ts
856
+ export const environment = {
857
+ production: true,
858
+ posthogKey: import.meta.env['NG_APP_POSTHOG_PROJECT_TOKEN'] || '<ph_project_token>',
859
+ posthogHost: import.meta.env['NG_APP_POSTHOG_HOST'] || 'https://us.posthog.com',
860
+ };
861
+
862
+ ```
863
+
864
+ ---
865
+
866
+ ## src/environments/environment.production.ts
867
+
868
+ ```ts
869
+ export const environment = {
870
+ production: true,
871
+ posthogKey: import.meta.env['NG_APP_POSTHOG_PROJECT_TOKEN'] || '<ph_project_token>',
872
+ posthogHost: import.meta.env['NG_APP_POSTHOG_HOST'] || 'https://us.posthog.com',
873
+ };
874
+
875
+ ```
876
+
877
+ ---
878
+
879
+ ## src/environments/environment.ts
880
+
881
+ ```ts
882
+ export const environment = {
883
+ production: false,
884
+ posthogKey: import.meta.env['NG_APP_POSTHOG_PROJECT_TOKEN'] || '<ph_project_token>',
885
+ posthogHost: import.meta.env['NG_APP_POSTHOG_HOST'] || 'https://us.posthog.com',
886
+ };
887
+
888
+ ```
889
+
890
+ ---
891
+
892
+ ## src/index.html
893
+
894
+ ```html
895
+ <!doctype html>
896
+ <html lang="en">
897
+ <head>
898
+ <meta charset="utf-8">
899
+ <title>Burrito Consideration App</title>
900
+ <base href="/">
901
+ <meta name="viewport" content="width=device-width, initial-scale=1">
902
+ <meta name="description" content="Consider the potential of burritos">
903
+ <link rel="icon" type="image/x-icon" href="favicon.ico">
904
+ </head>
905
+ <body>
906
+ <app-root></app-root>
907
+ </body>
908
+ </html>
909
+
910
+ ```
911
+
912
+ ---
913
+
914
+ ## src/main.server.ts
915
+
916
+ ```ts
917
+ import { bootstrapApplication, BootstrapContext } from '@angular/platform-browser';
918
+ import { AppComponent } from './app/app.component';
919
+ import { config } from './app/app.config.server';
920
+
921
+ const bootstrap = (context: BootstrapContext) =>
922
+ bootstrapApplication(AppComponent, config, context);
923
+
924
+ export default bootstrap;
925
+
926
+ ```
927
+
928
+ ---
929
+
930
+ ## src/main.ts
931
+
932
+ ```ts
933
+ import { bootstrapApplication } from '@angular/platform-browser';
934
+ import { appConfig } from './app/app.config';
935
+ import { AppComponent } from './app/app.component';
936
+
937
+ bootstrapApplication(AppComponent, appConfig).catch((err) =>
938
+ console.error(err)
939
+ );
940
+
941
+ ```
942
+
943
+ ---
944
+