Medusa Collection Thumbnail Plugin

Collection thumbnail management plugin for Medusa v2

Features

• ✅ Upload, replace, and delete collection thumbnails
• ✅ Google Cloud Storage integration
• ✅ Admin UI widget with drag-and-drop upload
• ✅ Store API endpoints for fetching collections with thumbnails
• ✅ Automatic cleanup of old thumbnails
• ✅ File validation (5MB limit, images only)

Installation

npm install @lodashventure/medusa-collection-thumbnail

Configuration

Add the plugin to your medusa-config.js:

const plugins = [
  // ... other plugins
  {
    resolve: "@lodashventure/medusa-collection-thumbnail",
    options: {},
  },
];

Environment Variables

Required environment variables for Google Cloud Storage:

CLIENT_EMAIL=your-service-account@project.iam.gserviceaccount.com
PRIVATE_KEY=your-private-key
BUCKET_NAME=your-bucket-name
GCP_STORAGE_BASE_PUBLIC_URL=https://storage.cloud.google.com

API Endpoints

Admin Endpoints

• GET /admin/collections/:id/thumbnail - Fetch thumbnail for a collection
• POST /admin/collections/:id/thumbnail - Upload thumbnail (multipart or base64)
• DELETE /admin/collections/:id/thumbnail - Delete thumbnail

Store Endpoints

• GET /store/collections - List collections with thumbnails
• GET /store/collections/:id - Get single collection with thumbnail

Development

# Build the plugin
npm run build

# Watch mode for development
npm run dev

License

MIT