Troubleshooting

Quick reference for resolving common issues in Plainform. Issues are organized by category for fast lookup.

Development Server

Environment Variables

Database & Prisma

Authentication (Clerk)

Payments (Stripe)

Build & Deployment

Content & MDX

Styling & UI

Performance

Email (Resend)

Storage (AWS S3)

Getting Help

If you can't resolve an issue:

1. Check logs:

   • Browser console (F12)
   • Terminal output
   • Vercel function logs
   • Stripe Dashboard logs

2. Search documentation:

   • Next.js Docs
   • Clerk Docs
   • Stripe Docs
   • Prisma Docs

3. Debug systematically:

   • Isolate the issue
   • Check one integration at a time
   • Test in isolation
   • Compare with working examples

4. Common debugging commands:

   # Clear all caches
   rm -rf .next node_modules package-lock.json
   npm install
   npm run dev
   
   # Check environment
   npm run build
   npx prisma db pull
   npx prisma generate
   
   # Test integrations
   npm run stripe:listen
   npx prisma studio

Next Steps

• Build & Deploy - Production deployment guide
• Git Workflow - Commit and push best practices
• Environment Variables - Detailed variable configuration