@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.
- package/LICENSE +1 -1
- package/README.md +73 -47
- package/package.json +4 -4
- package/skills/supabase-advanced-troubleshooting/SKILL.md +404 -200
- package/skills/supabase-advanced-troubleshooting/references/errors.md +11 -0
- package/skills/supabase-advanced-troubleshooting/references/evidence-collection-framework.md +34 -0
- package/skills/supabase-advanced-troubleshooting/references/examples.md +11 -0
- package/skills/supabase-advanced-troubleshooting/references/rls-edge-functions-realtime.md +363 -0
- package/skills/supabase-advanced-troubleshooting/references/systematic-isolation.md +56 -0
- package/skills/supabase-advanced-troubleshooting/references/timing-analysis.md +35 -0
- package/skills/supabase-architecture-variants/SKILL.md +395 -216
- package/skills/supabase-architecture-variants/references/errors.md +11 -0
- package/skills/supabase-architecture-variants/references/examples.md +12 -0
- package/skills/supabase-architecture-variants/references/serverless-and-multi-tenant.md +251 -0
- package/skills/supabase-architecture-variants/references/variant-a-monolith-(simple).md +44 -0
- package/skills/supabase-architecture-variants/references/variant-b-service-layer-(moderate).md +72 -0
- package/skills/supabase-architecture-variants/references/variant-c-microservice-(complex).md +81 -0
- package/skills/supabase-auth-storage-realtime-core/SKILL.md +471 -37
- package/skills/supabase-ci-integration/SKILL.md +315 -67
- package/skills/supabase-ci-integration/references/errors.md +10 -0
- package/skills/supabase-ci-integration/references/examples.md +36 -0
- package/skills/supabase-ci-integration/references/implementation.md +54 -0
- package/skills/supabase-common-errors/SKILL.md +320 -62
- package/skills/supabase-common-errors/references/errors.md +53 -0
- package/skills/supabase-common-errors/references/examples.md +23 -0
- package/skills/supabase-cost-tuning/SKILL.md +365 -131
- package/skills/supabase-cost-tuning/references/cost-estimation.md +34 -0
- package/skills/supabase-cost-tuning/references/cost-reduction-strategies.md +40 -0
- package/skills/supabase-cost-tuning/references/errors.md +11 -0
- package/skills/supabase-cost-tuning/references/examples.md +15 -0
- package/skills/supabase-data-handling/SKILL.md +378 -145
- package/skills/supabase-data-handling/references/errors.md +11 -0
- package/skills/supabase-data-handling/references/examples.md +27 -0
- package/skills/supabase-data-handling/references/implementation.md +223 -0
- package/skills/supabase-data-handling/references/retention-and-backup.md +221 -0
- package/skills/supabase-debug-bundle/SKILL.md +267 -73
- package/skills/supabase-debug-bundle/references/errors.md +12 -0
- package/skills/supabase-debug-bundle/references/examples.md +24 -0
- package/skills/supabase-debug-bundle/references/implementation.md +54 -0
- package/skills/supabase-deploy-integration/SKILL.md +258 -147
- package/skills/supabase-deploy-integration/references/errors.md +11 -0
- package/skills/supabase-deploy-integration/references/examples.md +21 -0
- package/skills/supabase-deploy-integration/references/google-cloud-run.md +36 -0
- package/skills/supabase-deploy-integration/references/vercel-deployment.md +35 -0
- package/skills/supabase-enterprise-rbac/SKILL.md +327 -160
- package/skills/supabase-enterprise-rbac/references/api-scoping-and-enforcement.md +255 -0
- package/skills/supabase-enterprise-rbac/references/errors.md +11 -0
- package/skills/supabase-enterprise-rbac/references/examples.md +12 -0
- package/skills/supabase-enterprise-rbac/references/role-implementation.md +33 -0
- package/skills/supabase-enterprise-rbac/references/sso-integration.md +35 -0
- package/skills/supabase-hello-world/SKILL.md +160 -54
- package/skills/supabase-incident-runbook/SKILL.md +453 -131
- package/skills/supabase-incident-runbook/references/errors.md +11 -0
- package/skills/supabase-incident-runbook/references/examples.md +10 -0
- package/skills/supabase-incident-runbook/references/immediate-actions-by-error-type.md +41 -0
- package/skills/supabase-install-auth/SKILL.md +186 -50
- package/skills/supabase-install-auth/references/examples.md +102 -0
- package/skills/supabase-known-pitfalls/SKILL.md +411 -241
- package/skills/supabase-known-pitfalls/references/errors.md +11 -0
- package/skills/supabase-known-pitfalls/references/examples.md +12 -0
- package/skills/supabase-load-scale/SKILL.md +346 -217
- package/skills/supabase-load-scale/references/capacity-planning.md +47 -0
- package/skills/supabase-load-scale/references/errors.md +11 -0
- package/skills/supabase-load-scale/references/examples.md +26 -0
- package/skills/supabase-load-scale/references/load-testing-with-k6.md +59 -0
- package/skills/supabase-load-scale/references/scaling-patterns.md +65 -0
- package/skills/supabase-load-scale/references/table-partitioning.md +263 -0
- package/skills/supabase-local-dev-loop/SKILL.md +272 -73
- package/skills/supabase-local-dev-loop/references/errors.md +11 -0
- package/skills/supabase-local-dev-loop/references/examples.md +21 -0
- package/skills/supabase-local-dev-loop/references/implementation.md +60 -0
- package/skills/supabase-migration-deep-dive/SKILL.md +338 -177
- package/skills/supabase-migration-deep-dive/references/backfill-versioning-rollback.md +258 -0
- package/skills/supabase-migration-deep-dive/references/errors.md +11 -0
- package/skills/supabase-migration-deep-dive/references/examples.md +12 -0
- package/skills/supabase-migration-deep-dive/references/implementation-plan.md +80 -0
- package/skills/supabase-migration-deep-dive/references/pre-migration-assessment.md +39 -0
- package/skills/supabase-multi-env-setup/SKILL.md +393 -152
- package/skills/supabase-multi-env-setup/references/configuration-structure.md +59 -0
- package/skills/supabase-multi-env-setup/references/errors.md +11 -0
- package/skills/supabase-multi-env-setup/references/examples.md +11 -0
- package/skills/supabase-observability/SKILL.md +318 -196
- package/skills/supabase-observability/references/alert-configuration.md +40 -0
- package/skills/supabase-observability/references/errors.md +11 -0
- package/skills/supabase-observability/references/examples.md +13 -0
- package/skills/supabase-observability/references/metrics-collection.md +65 -0
- package/skills/supabase-performance-tuning/SKILL.md +304 -160
- package/skills/supabase-performance-tuning/references/caching-strategy.md +49 -0
- package/skills/supabase-performance-tuning/references/errors.md +11 -0
- package/skills/supabase-performance-tuning/references/examples.md +13 -0
- package/skills/supabase-policy-guardrails/SKILL.md +248 -221
- package/skills/supabase-policy-guardrails/references/ci-cost-security.md +484 -0
- package/skills/supabase-policy-guardrails/references/errors.md +11 -0
- package/skills/supabase-policy-guardrails/references/eslint-rules.md +46 -0
- package/skills/supabase-policy-guardrails/references/examples.md +10 -0
- package/skills/supabase-prod-checklist/SKILL.md +474 -84
- package/skills/supabase-prod-checklist/references/errors.md +63 -0
- package/skills/supabase-prod-checklist/references/examples.md +153 -0
- package/skills/supabase-prod-checklist/references/implementation.md +113 -0
- package/skills/supabase-rate-limits/SKILL.md +311 -98
- package/skills/supabase-rate-limits/references/errors.md +11 -0
- package/skills/supabase-rate-limits/references/examples.md +46 -0
- package/skills/supabase-rate-limits/references/implementation.md +66 -0
- package/skills/supabase-reference-architecture/SKILL.md +249 -182
- package/skills/supabase-reference-architecture/references/errors.md +29 -0
- package/skills/supabase-reference-architecture/references/examples.md +116 -0
- package/skills/supabase-reference-architecture/references/key-components.md +244 -0
- package/skills/supabase-reference-architecture/references/project-structure.md +109 -0
- package/skills/supabase-reliability-patterns/SKILL.md +229 -234
- package/skills/supabase-reliability-patterns/references/circuit-breaker.md +36 -0
- package/skills/supabase-reliability-patterns/references/dead-letter-queue.md +48 -0
- package/skills/supabase-reliability-patterns/references/errors.md +11 -0
- package/skills/supabase-reliability-patterns/references/examples.md +11 -0
- package/skills/supabase-reliability-patterns/references/idempotency-keys.md +36 -0
- package/skills/supabase-reliability-patterns/references/offline-degradation-health-dualwrite.md +489 -0
- package/skills/supabase-schema-from-requirements/SKILL.md +373 -34
- package/skills/supabase-sdk-patterns/SKILL.md +388 -99
- package/skills/supabase-sdk-patterns/references/errors.md +11 -0
- package/skills/supabase-sdk-patterns/references/examples.md +45 -0
- package/skills/supabase-sdk-patterns/references/implementation.md +67 -0
- package/skills/supabase-security-basics/SKILL.md +282 -102
- package/skills/supabase-security-basics/references/errors.md +10 -0
- package/skills/supabase-security-basics/references/examples.md +70 -0
- package/skills/supabase-security-basics/references/implementation.md +39 -0
- package/skills/supabase-upgrade-migration/SKILL.md +248 -66
- package/skills/supabase-upgrade-migration/references/errors.md +10 -0
- package/skills/supabase-upgrade-migration/references/examples.md +51 -0
- package/skills/supabase-upgrade-migration/references/implementation.md +29 -0
- package/skills/supabase-webhooks-events/SKILL.md +412 -138
- package/skills/supabase-webhooks-events/references/errors.md +55 -0
- package/skills/supabase-webhooks-events/references/event-handler-pattern.md +106 -0
- package/skills/supabase-webhooks-events/references/examples.md +133 -0
- package/skills/supabase-webhooks-events/references/signature-verification.md +165 -0
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Supabase Skill Pack
|
|
2
2
|
|
|
3
|
-
> Claude Code
|
|
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
|
-
##
|
|
11
|
+
## What Makes This Different
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
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
|
|
17
|
-
| `supabase-hello-world` |
|
|
18
|
-
| `supabase-local-dev-loop` |
|
|
19
|
-
| `supabase-sdk-patterns` |
|
|
20
|
-
| `supabase-schema-from-requirements` |
|
|
21
|
-
| `supabase-auth-storage-realtime-core` | Auth Storage Realtime
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
|
26
|
-
|
|
27
|
-
| `supabase-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
|
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` |
|
|
33
|
-
| `supabase-deploy-integration` |
|
|
34
|
-
| `supabase-webhooks-events` |
|
|
35
|
-
| `supabase-performance-tuning` |
|
|
36
|
-
| `supabase-cost-tuning` |
|
|
37
|
-
| `supabase-reference-architecture` |
|
|
38
|
-
|
|
39
|
-
###
|
|
40
|
-
|
|
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` |
|
|
43
|
-
| `supabase-observability` |
|
|
44
|
-
| `supabase-incident-runbook` |
|
|
45
|
-
| `supabase-data-handling` |
|
|
46
|
-
| `supabase-enterprise-rbac` |
|
|
47
|
-
| `supabase-migration-deep-dive` |
|
|
48
|
-
|
|
49
|
-
###
|
|
50
|
-
|
|
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` |
|
|
53
|
-
| `supabase-load-scale` |
|
|
54
|
-
| `supabase-reliability-patterns` |
|
|
55
|
-
| `supabase-policy-guardrails` |
|
|
56
|
-
| `supabase-architecture-variants` |
|
|
57
|
-
| `supabase-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
|
|
85
|
+
Skills auto-activate based on context. Examples:
|
|
62
86
|
|
|
63
|
-
- "Help me set up Supabase"
|
|
64
|
-
- "
|
|
65
|
-
- "
|
|
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.
|
|
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://
|
|
39
|
+
"homepage": "https://tonsofskills.com/learn/supabase/",
|
|
40
40
|
"publishConfig": {
|
|
41
41
|
"access": "public"
|
|
42
42
|
}
|