@intentsolutionsio/supabase-pack 1.0.0 → 1.0.3

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 (133) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +73 -47
  3. package/package.json +4 -4
  4. package/skills/supabase-advanced-troubleshooting/SKILL.md +404 -200
  5. package/skills/supabase-advanced-troubleshooting/references/errors.md +11 -0
  6. package/skills/supabase-advanced-troubleshooting/references/evidence-collection-framework.md +34 -0
  7. package/skills/supabase-advanced-troubleshooting/references/examples.md +11 -0
  8. package/skills/supabase-advanced-troubleshooting/references/rls-edge-functions-realtime.md +363 -0
  9. package/skills/supabase-advanced-troubleshooting/references/systematic-isolation.md +56 -0
  10. package/skills/supabase-advanced-troubleshooting/references/timing-analysis.md +35 -0
  11. package/skills/supabase-architecture-variants/SKILL.md +395 -216
  12. package/skills/supabase-architecture-variants/references/errors.md +11 -0
  13. package/skills/supabase-architecture-variants/references/examples.md +12 -0
  14. package/skills/supabase-architecture-variants/references/serverless-and-multi-tenant.md +251 -0
  15. package/skills/supabase-architecture-variants/references/variant-a-monolith-(simple).md +44 -0
  16. package/skills/supabase-architecture-variants/references/variant-b-service-layer-(moderate).md +72 -0
  17. package/skills/supabase-architecture-variants/references/variant-c-microservice-(complex).md +81 -0
  18. package/skills/supabase-auth-storage-realtime-core/SKILL.md +471 -37
  19. package/skills/supabase-ci-integration/SKILL.md +315 -67
  20. package/skills/supabase-ci-integration/references/errors.md +10 -0
  21. package/skills/supabase-ci-integration/references/examples.md +36 -0
  22. package/skills/supabase-ci-integration/references/implementation.md +54 -0
  23. package/skills/supabase-common-errors/SKILL.md +320 -62
  24. package/skills/supabase-common-errors/references/errors.md +53 -0
  25. package/skills/supabase-common-errors/references/examples.md +23 -0
  26. package/skills/supabase-cost-tuning/SKILL.md +365 -131
  27. package/skills/supabase-cost-tuning/references/cost-estimation.md +34 -0
  28. package/skills/supabase-cost-tuning/references/cost-reduction-strategies.md +40 -0
  29. package/skills/supabase-cost-tuning/references/errors.md +11 -0
  30. package/skills/supabase-cost-tuning/references/examples.md +15 -0
  31. package/skills/supabase-data-handling/SKILL.md +378 -145
  32. package/skills/supabase-data-handling/references/errors.md +11 -0
  33. package/skills/supabase-data-handling/references/examples.md +27 -0
  34. package/skills/supabase-data-handling/references/implementation.md +223 -0
  35. package/skills/supabase-data-handling/references/retention-and-backup.md +221 -0
  36. package/skills/supabase-debug-bundle/SKILL.md +267 -73
  37. package/skills/supabase-debug-bundle/references/errors.md +12 -0
  38. package/skills/supabase-debug-bundle/references/examples.md +24 -0
  39. package/skills/supabase-debug-bundle/references/implementation.md +54 -0
  40. package/skills/supabase-deploy-integration/SKILL.md +258 -147
  41. package/skills/supabase-deploy-integration/references/errors.md +11 -0
  42. package/skills/supabase-deploy-integration/references/examples.md +21 -0
  43. package/skills/supabase-deploy-integration/references/google-cloud-run.md +36 -0
  44. package/skills/supabase-deploy-integration/references/vercel-deployment.md +35 -0
  45. package/skills/supabase-enterprise-rbac/SKILL.md +327 -160
  46. package/skills/supabase-enterprise-rbac/references/api-scoping-and-enforcement.md +255 -0
  47. package/skills/supabase-enterprise-rbac/references/errors.md +11 -0
  48. package/skills/supabase-enterprise-rbac/references/examples.md +12 -0
  49. package/skills/supabase-enterprise-rbac/references/role-implementation.md +33 -0
  50. package/skills/supabase-enterprise-rbac/references/sso-integration.md +35 -0
  51. package/skills/supabase-hello-world/SKILL.md +160 -54
  52. package/skills/supabase-incident-runbook/SKILL.md +453 -131
  53. package/skills/supabase-incident-runbook/references/errors.md +11 -0
  54. package/skills/supabase-incident-runbook/references/examples.md +10 -0
  55. package/skills/supabase-incident-runbook/references/immediate-actions-by-error-type.md +41 -0
  56. package/skills/supabase-install-auth/SKILL.md +186 -50
  57. package/skills/supabase-install-auth/references/examples.md +102 -0
  58. package/skills/supabase-known-pitfalls/SKILL.md +411 -241
  59. package/skills/supabase-known-pitfalls/references/errors.md +11 -0
  60. package/skills/supabase-known-pitfalls/references/examples.md +12 -0
  61. package/skills/supabase-load-scale/SKILL.md +346 -217
  62. package/skills/supabase-load-scale/references/capacity-planning.md +47 -0
  63. package/skills/supabase-load-scale/references/errors.md +11 -0
  64. package/skills/supabase-load-scale/references/examples.md +26 -0
  65. package/skills/supabase-load-scale/references/load-testing-with-k6.md +59 -0
  66. package/skills/supabase-load-scale/references/scaling-patterns.md +65 -0
  67. package/skills/supabase-load-scale/references/table-partitioning.md +263 -0
  68. package/skills/supabase-local-dev-loop/SKILL.md +272 -73
  69. package/skills/supabase-local-dev-loop/references/errors.md +11 -0
  70. package/skills/supabase-local-dev-loop/references/examples.md +21 -0
  71. package/skills/supabase-local-dev-loop/references/implementation.md +60 -0
  72. package/skills/supabase-migration-deep-dive/SKILL.md +338 -177
  73. package/skills/supabase-migration-deep-dive/references/backfill-versioning-rollback.md +258 -0
  74. package/skills/supabase-migration-deep-dive/references/errors.md +11 -0
  75. package/skills/supabase-migration-deep-dive/references/examples.md +12 -0
  76. package/skills/supabase-migration-deep-dive/references/implementation-plan.md +80 -0
  77. package/skills/supabase-migration-deep-dive/references/pre-migration-assessment.md +39 -0
  78. package/skills/supabase-multi-env-setup/SKILL.md +393 -152
  79. package/skills/supabase-multi-env-setup/references/configuration-structure.md +59 -0
  80. package/skills/supabase-multi-env-setup/references/errors.md +11 -0
  81. package/skills/supabase-multi-env-setup/references/examples.md +11 -0
  82. package/skills/supabase-observability/SKILL.md +318 -196
  83. package/skills/supabase-observability/references/alert-configuration.md +40 -0
  84. package/skills/supabase-observability/references/errors.md +11 -0
  85. package/skills/supabase-observability/references/examples.md +13 -0
  86. package/skills/supabase-observability/references/metrics-collection.md +65 -0
  87. package/skills/supabase-performance-tuning/SKILL.md +304 -160
  88. package/skills/supabase-performance-tuning/references/caching-strategy.md +49 -0
  89. package/skills/supabase-performance-tuning/references/errors.md +11 -0
  90. package/skills/supabase-performance-tuning/references/examples.md +13 -0
  91. package/skills/supabase-policy-guardrails/SKILL.md +248 -221
  92. package/skills/supabase-policy-guardrails/references/ci-cost-security.md +484 -0
  93. package/skills/supabase-policy-guardrails/references/errors.md +11 -0
  94. package/skills/supabase-policy-guardrails/references/eslint-rules.md +46 -0
  95. package/skills/supabase-policy-guardrails/references/examples.md +10 -0
  96. package/skills/supabase-prod-checklist/SKILL.md +474 -84
  97. package/skills/supabase-prod-checklist/references/errors.md +63 -0
  98. package/skills/supabase-prod-checklist/references/examples.md +153 -0
  99. package/skills/supabase-prod-checklist/references/implementation.md +113 -0
  100. package/skills/supabase-rate-limits/SKILL.md +311 -98
  101. package/skills/supabase-rate-limits/references/errors.md +11 -0
  102. package/skills/supabase-rate-limits/references/examples.md +46 -0
  103. package/skills/supabase-rate-limits/references/implementation.md +66 -0
  104. package/skills/supabase-reference-architecture/SKILL.md +249 -182
  105. package/skills/supabase-reference-architecture/references/errors.md +29 -0
  106. package/skills/supabase-reference-architecture/references/examples.md +116 -0
  107. package/skills/supabase-reference-architecture/references/key-components.md +244 -0
  108. package/skills/supabase-reference-architecture/references/project-structure.md +109 -0
  109. package/skills/supabase-reliability-patterns/SKILL.md +229 -234
  110. package/skills/supabase-reliability-patterns/references/circuit-breaker.md +36 -0
  111. package/skills/supabase-reliability-patterns/references/dead-letter-queue.md +48 -0
  112. package/skills/supabase-reliability-patterns/references/errors.md +11 -0
  113. package/skills/supabase-reliability-patterns/references/examples.md +11 -0
  114. package/skills/supabase-reliability-patterns/references/idempotency-keys.md +36 -0
  115. package/skills/supabase-reliability-patterns/references/offline-degradation-health-dualwrite.md +489 -0
  116. package/skills/supabase-schema-from-requirements/SKILL.md +373 -34
  117. package/skills/supabase-sdk-patterns/SKILL.md +388 -99
  118. package/skills/supabase-sdk-patterns/references/errors.md +11 -0
  119. package/skills/supabase-sdk-patterns/references/examples.md +45 -0
  120. package/skills/supabase-sdk-patterns/references/implementation.md +67 -0
  121. package/skills/supabase-security-basics/SKILL.md +282 -102
  122. package/skills/supabase-security-basics/references/errors.md +10 -0
  123. package/skills/supabase-security-basics/references/examples.md +70 -0
  124. package/skills/supabase-security-basics/references/implementation.md +39 -0
  125. package/skills/supabase-upgrade-migration/SKILL.md +248 -66
  126. package/skills/supabase-upgrade-migration/references/errors.md +10 -0
  127. package/skills/supabase-upgrade-migration/references/examples.md +51 -0
  128. package/skills/supabase-upgrade-migration/references/implementation.md +29 -0
  129. package/skills/supabase-webhooks-events/SKILL.md +412 -138
  130. package/skills/supabase-webhooks-events/references/errors.md +55 -0
  131. package/skills/supabase-webhooks-events/references/event-handler-pattern.md +106 -0
  132. package/skills/supabase-webhooks-events/references/examples.md +133 -0
  133. package/skills/supabase-webhooks-events/references/signature-verification.md +165 -0
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2025 Jeremy Longshore
3
+ Copyright (c) 2026 Jeremy Longshore
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Supabase Skill Pack
2
2
 
3
- > Claude Code skill pack for Supabase integration (30 skills)
3
+ > 30 production-grade Claude Code skills for Supabase: real `@supabase/supabase-js` v2 client methods, real PostgreSQL RLS policies, real Edge Functions, real Supabase CLI workflows.
4
4
 
5
5
  ## Installation
6
6
 
@@ -8,61 +8,87 @@
8
8
  /plugin install supabase-pack@claude-code-plugins-plus
9
9
  ```
10
10
 
11
- ## Skills Included
11
+ ## What Makes This Different
12
12
 
13
- ### Standard Skills (S01-S12)
14
- | Skill | Description |
13
+ Every skill contains real, copy-paste-ready code. No placeholder `// Step 1 implementation` stubs. Real `createClient()` initialization, real `supabase.from().select().eq()` queries, real `supabase.auth.signUp()` calls, real `alter table enable row level security` policies, real `supabase functions deploy` workflows.
14
+
15
+ ## Skills (30)
16
+
17
+ ### Getting Started (S01-S06)
18
+
19
+ | Skill | What It Does |
15
20
  |-------|-------------|
16
- | `supabase-install-auth` | Install Auth |
17
- | `supabase-hello-world` | Hello World |
18
- | `supabase-local-dev-loop` | Local Dev Loop |
19
- | `supabase-sdk-patterns` | Sdk Patterns |
20
- | `supabase-schema-from-requirements` | Schema From Requirements |
21
- | `supabase-auth-storage-realtime-core` | Auth Storage Realtime Core |
22
- | `supabase-common-errors` | Common Errors |
23
- | `supabase-debug-bundle` | Debug Bundle |
24
- | `supabase-rate-limits` | Rate Limits |
25
- | `supabase-security-basics` | Security Basics |
26
- | `supabase-prod-checklist` | Prod Checklist |
27
- | `supabase-upgrade-migration` | Upgrade Migration |
28
-
29
- ### Pro Skills (P13-P18)
30
- | Skill | Description |
21
+ | `supabase-install-auth` | Install `@supabase/supabase-js`, CLI, configure keys, generate TypeScript types |
22
+ | `supabase-hello-world` | First table migration with RLS, INSERT/SELECT/UPDATE/DELETE, filtering, joins |
23
+ | `supabase-local-dev-loop` | `supabase start`, migrations, seeds, `db diff`, Edge Function hot reload, Vitest |
24
+ | `supabase-sdk-patterns` | Typed singleton, service layer, custom errors, retry with backoff, Zod validation |
25
+ | `supabase-schema-from-requirements` | Requirements to SQL migration: tables, FKs, indexes, RLS helper functions |
26
+ | `supabase-auth-storage-realtime-core` | Auth (signup, OAuth, MFA), Storage (upload, signed URLs, bucket RLS), Realtime (Postgres changes, broadcast, presence) |
27
+
28
+ ### Operations (S07-S12)
29
+
30
+ | Skill | What It Does |
31
+ |-------|-------------|
32
+ | `supabase-common-errors` | PGRST error codes, PostgreSQL errors, Auth/Storage/Realtime diagnostics, RLS debugging |
33
+ | `supabase-debug-bundle` | Collect redacted debug bundle: env info, `pg_stat_statements`, connection health |
34
+ | `supabase-rate-limits` | Supabase limits by tier, retry with backoff, request queue, batch operations, idempotency |
35
+ | `supabase-security-basics` | Anon vs service role keys, RLS policy patterns, security audit checklist |
36
+ | `supabase-prod-checklist` | Full production checklist: RLS, SSL, indexes, PITR, health checks, rollback |
37
+ | `supabase-upgrade-migration` | v1-to-v2 breaking changes, auth method renames, code migration steps |
38
+
39
+ ### DevOps (P13-P18)
40
+
41
+ | Skill | What It Does |
31
42
  |-------|-------------|
32
- | `supabase-ci-integration` | Ci Integration |
33
- | `supabase-deploy-integration` | Deploy Integration |
34
- | `supabase-webhooks-events` | Webhooks Events |
35
- | `supabase-performance-tuning` | Performance Tuning |
36
- | `supabase-cost-tuning` | Cost Tuning |
37
- | `supabase-reference-architecture` | Reference Architecture |
38
-
39
- ### Flagship Skills (F19-F24)
40
- | Skill | Description |
43
+ | `supabase-ci-integration` | GitHub Actions: local Supabase in CI, migration deploy, pgTAP tests, type drift |
44
+ | `supabase-deploy-integration` | Edge Functions (Deno), Vercel/Fly.io/Cloud Run deploy, Supavisor connection pooling |
45
+ | `supabase-webhooks-events` | Database webhooks, `pg_net` async HTTP from triggers, Edge Function handlers, Auth hooks |
46
+ | `supabase-performance-tuning` | `EXPLAIN ANALYZE`, index optimization, RLS performance, caching, N+1 elimination |
47
+ | `supabase-cost-tuning` | Pricing breakdown, database size audit, storage cleanup, bandwidth reduction |
48
+ | `supabase-reference-architecture` | Layered project structure: client layer, service layer, hooks, error handling, health check |
49
+
50
+ ### Enterprise (F19-F24)
51
+
52
+ | Skill | What It Does |
41
53
  |-------|-------------|
42
- | `supabase-multi-env-setup` | Multi Env Setup |
43
- | `supabase-observability` | Observability |
44
- | `supabase-incident-runbook` | Incident Runbook |
45
- | `supabase-data-handling` | Data Handling |
46
- | `supabase-enterprise-rbac` | Enterprise Rbac |
47
- | `supabase-migration-deep-dive` | Migration Deep Dive |
48
-
49
- ### Flagship+ Skills (X25-X30)
50
- | Skill | Description |
54
+ | `supabase-multi-env-setup` | Dev/staging/prod with separate Supabase projects, migration promotion, env guards |
55
+ | `supabase-observability` | `pg_stat_statements`, structured logging, instrumented client, health checks, alerting |
56
+ | `supabase-incident-runbook` | 5-minute triage, platform vs app isolation, mitigation, communication, postmortem |
57
+ | `supabase-data-handling` | PII classification, GDPR deletion, data export, retention policies with pg_cron, audit log |
58
+ | `supabase-enterprise-rbac` | Custom roles, JWT custom claims via Auth Hooks, org-scoped RLS, SAML SSO |
59
+ | `supabase-migration-deep-dive` | Firebase/MongoDB to Supabase, strangler fig pattern, data migration scripts, auth migration |
60
+
61
+ ### Advanced (X25-X30)
62
+
63
+ | Skill | What It Does |
51
64
  |-------|-------------|
52
- | `supabase-advanced-troubleshooting` | Advanced Troubleshooting |
53
- | `supabase-load-scale` | Load Scale |
54
- | `supabase-reliability-patterns` | Reliability Patterns |
55
- | `supabase-policy-guardrails` | Policy Guardrails |
56
- | `supabase-architecture-variants` | Architecture Variants |
57
- | `supabase-known-pitfalls` | Known Pitfalls |
65
+ | `supabase-advanced-troubleshooting` | `EXPLAIN ANALYZE`, RLS step-by-step debug, connection leaks, lock contention, Realtime debug |
66
+ | `supabase-load-scale` | k6 load test scripts, connection pool sizing, read replicas, capacity planning |
67
+ | `supabase-reliability-patterns` | Circuit breaker, idempotent writes, bulkhead isolation, graceful degradation, DLQ |
68
+ | `supabase-policy-guardrails` | ESLint rules, pre-commit secret scanning, CI RLS checks, runtime safety guards |
69
+ | `supabase-architecture-variants` | Monolith vs modular monolith vs service layer decision matrix with migration paths |
70
+ | `supabase-known-pitfalls` | 12 anti-patterns ranked by severity with fix + detection for each |
71
+
72
+ ## Key Technologies Covered
73
+
74
+ - **SDK**: `@supabase/supabase-js` v2, `@supabase/ssr`, TypeScript generics
75
+ - **Database**: PostgreSQL, PostgREST, Row Level Security, `pg_stat_statements`, `pg_net`, `pg_cron`
76
+ - **Auth**: Email/password, OAuth (Google, GitHub), Magic Links, MFA, SAML SSO, Auth Hooks, JWT custom claims
77
+ - **Storage**: Uploads, signed URLs, public URLs, bucket RLS policies, TUS resumable uploads
78
+ - **Realtime**: Postgres Changes, Broadcast, Presence
79
+ - **Edge Functions**: Deno runtime, `supabase functions deploy`, local serve with hot reload
80
+ - **CLI**: `supabase start`, `supabase db push`, `supabase db diff`, `supabase gen types`, `supabase migration new`
81
+ - **Deployment**: Vercel, Fly.io, Cloud Run, Supavisor connection pooling
58
82
 
59
83
  ## Usage
60
84
 
61
- Skills trigger automatically when you discuss Supabase topics. For example:
85
+ Skills auto-activate based on context. Examples:
62
86
 
63
- - "Help me set up Supabase" triggers `supabase-install-auth`
64
- - "Debug this Supabase error" triggers `supabase-common-errors`
65
- - "Deploy my Supabase integration" triggers `supabase-deploy-integration`
87
+ - "Help me set up Supabase" activates `supabase-install-auth`
88
+ - "My Supabase query is slow" activates `supabase-performance-tuning`
89
+ - "Set up RLS for my tables" activates `supabase-security-basics`
90
+ - "Deploy my Edge Function" activates `supabase-deploy-integration`
91
+ - "Migrate from Firebase to Supabase" activates `supabase-migration-deep-dive`
66
92
 
67
93
  ## License
68
94
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intentsolutionsio/supabase-pack",
3
- "version": "1.0.0",
3
+ "version": "1.0.3",
4
4
  "description": "Claude Code skill pack for Supabase - 30 skills covering database operations, authentication, edge functions, realtime subscriptions, and production operations",
5
5
  "main": "README.md",
6
6
  "type": "module",
@@ -30,13 +30,13 @@
30
30
  "license": "MIT",
31
31
  "repository": {
32
32
  "type": "git",
33
- "url": "git+https://github.com/jeremylongshore/claude-code-plugins.git",
33
+ "url": "git+https://github.com/jeremylongshore/claude-code-plugins-plus-skills.git",
34
34
  "directory": "plugins/saas-packs/supabase-pack"
35
35
  },
36
36
  "bugs": {
37
- "url": "https://github.com/jeremylongshore/claude-code-plugins/issues"
37
+ "url": "https://github.com/jeremylongshore/claude-code-plugins-plus-skills/issues"
38
38
  },
39
- "homepage": "https://claudecodeplugins.io/plugins/supabase-pack",
39
+ "homepage": "https://tonsofskills.com/learn/supabase/",
40
40
  "publishConfig": {
41
41
  "access": "public"
42
42
  }