/vercel-storage

--- name: vercel-storage description: Vercel storage expert guidance — Blob, Global Config (formerly Edge Config), and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications. metadata: priority: 7 docs:

• "https://vercel.com/docs/storage"

sitemap: "https://vercel.com/sitemap.xml" pathPatterns:

• 'lib/blob/**'
• 'lib/storage/**'
• 'src/lib/blob/**'
• 'src/lib/storage/**'
• 'lib/blob.*'
• 'lib/storage.*'
• 'lib/edge-config.*'
• 'lib/global-config.*'
• 'src/lib/blob.*'
• 'src/lib/storage.*'
• 'src/lib/edge-config.*'
• 'src/lib/global-config.*'
• 'supabase/**'
• 'lib/supabase.*'
• 'src/lib/supabase.*'
• 'prisma/schema.prisma'
• 'prisma/**'

bashPatterns:

• '\bnpm\s+(install|i|add)\s+[^\n]*@vercel/blob\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@vercel/blob\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@vercel/blob\b'
• '\byarn\s+add\s+[^\n]*@vercel/blob\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@vercel/edge-config\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@vercel/edge-config\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@vercel/edge-config\b'
• '\byarn\s+add\s+[^\n]*@vercel/edge-config\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@vercel/global-config\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@vercel/global-config\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@vercel/global-config\b'
• '\byarn\s+add\s+[^\n]*@vercel/global-config\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@neondatabase/serverless\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@neondatabase/serverless\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@neondatabase/serverless\b'
• '\byarn\s+add\s+[^\n]*@neondatabase/serverless\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@upstash/redis\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@upstash/redis\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@upstash/redis\b'
• '\byarn\s+add\s+[^\n]*@upstash/redis\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@vercel/kv\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@vercel/kv\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@vercel/kv\b'
• '\byarn\s+add\s+[^\n]*@vercel/kv\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@vercel/postgres\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@vercel/postgres\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@vercel/postgres\b'
• '\byarn\s+add\s+[^\n]*@vercel/postgres\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@supabase/supabase-js\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@supabase/supabase-js\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@supabase/supabase-js\b'
• '\byarn\s+add\s+[^\n]*@supabase/supabase-js\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@supabase/ssr\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@supabase/ssr\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@supabase/ssr\b'
• '\byarn\s+add\s+[^\n]*@supabase/ssr\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@prisma/client\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@prisma/client\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@prisma/client\b'
• '\byarn\s+add\s+[^\n]*@prisma/client\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*\bmongodb\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*\bmongodb\b'
• '\bbun\s+(install|i|add)\s+[^\n]*\bmongodb\b'
• '\byarn\s+add\s+[^\n]*\bmongodb\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*\bconvex\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*\bconvex\b'
• '\bbun\s+(install|i|add)\s+[^\n]*\bconvex\b'
• '\byarn\s+add\s+[^\n]*\bconvex\b'
• '\bnpm\s+(install|i|add)\s+[^\n]*@libsql/client\b'
• '\bpnpm\s+(install|i|add)\s+[^\n]*@libsql/client\b'
• '\bbun\s+(install|i|add)\s+[^\n]*@libsql/client\b'
• '\byarn\s+add\s+[^\n]*@libsql/client\b'

importPatterns:

• "@vercel/blob"
• "@vercel/edge-config"
• "@vercel/global-config"
• "@neondatabase/serverless"
• "@upstash/redis"
• "@vercel/kv"
• "@vercel/postgres"
• "@supabase/supabase-js"
• "@prisma/client"

validate: - pattern: from\s+['"]@vercel/kv['"] message: '@vercel/kv is deprecated — migrate to @upstash/redis (Redis.fromEnv()) instead. Run `vercel integration add upstash` for one-click setup.' severity: error upgradeToSkill: vercel-storage upgradeWhy: 'Reload storage guidance for @vercel/kv → @upstash/redis migration steps, Marketplace provisioning, and API differences.' skipIfFileContains: '@upstash/redis' - pattern: from\s+['"]@vercel/postgres['"] message: '@vercel/postgres is deprecated — use @neondatabase/serverless with drizzle-orm instead. Run `vercel integration add neon` for one-click setup.' severity: error upgradeToSkill: vercel-storage upgradeWhy: 'Reload storage guidance for @vercel/postgres → @neondatabase/serverless migration steps, Marketplace provisioning, and drizzle-orm setup.' skipIfFileContains: '@neondatabase/serverless' - pattern: from\s+['"]@vercel/edge-config['"] message: 'Edge Config is now Global Config — @vercel/global-config is a drop-in replacement for @vercel/edge-config. The legacy package cannot read newly connected stores (it only reads EDGE_CONFIG).' severity: recommended skipIfFileContains: '@vercel/global-config' chainTo: - pattern: "@vercel/postgres" targetSkill: vercel-storage message: '@vercel/postgres is sunset — migrate to @neondatabase/serverless. Run `vercel integration add neon` for one-click Marketplace provisioning with unified billing.' skipIfFileContains: "@neondatabase/serverless|from\\s+['\"]@neondatabase" - pattern: "createPool\\s*\\(|from\\s+['\"]@vercel/postgres/pool['\"]" targetSkill: vercel-storage message: 'createPool from @vercel/postgres detected — this package is sunset. Use @neondatabase/serverless with neon() or Pool for connection pooling.' skipIfFileContains: "@neondatabase/serverless|from\\s+['\"]@neondatabase" - pattern: "sql\\s*`|from\\s+['\"]@vercel/postgres['\"].*sql" targetSkill: vercel-storage message: 'sql template literal