/vercel-storage

--- name: vercel-storage description: Vercel storage expert guidance — Blob, 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/docs.xml" pathPatterns:

• 'lib/blob/**'
• 'lib/storage/**'
• 'src/lib/blob/**'
• 'src/lib/storage/**'
• 'lib/blob.*'
• 'lib/storage.*'
• 'lib/edge-config.*'
• 'src/lib/blob.*'
• 'src/lib/storage.*'
• 'src/lib/edge-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]*@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"
• "@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' chainTo: - pattern: "from\\s+['\"]@vercel/postgres['\"]" targetSkill: nextjs message: '@vercel/postgres is sunset — loading Next.js guidance for integrating @neondatabase/serverless with App Router.' - 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: "from\\s+['\"]@vercel/kv['\"]" targetSkill: nextjs message: '@vercel/kv is sunset — loading Next.js guidance for integrating @upstash/redis with App Router.' - 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 from @vercel/postgres detected — this API is sunset. Use @neondatabase/serverless with neon() for tagged template queries.' skipIfFileContains: "@neondatabase/serverless|from\\s+['\"]@neondatabase" - pattern: "from\\s+['\"]@supabase/(supabase-js|ssr)['\"]" targetSkill: vercel-storage