Media Management

Complete documentation for Liberty Dynamic's media management system using Supabase Storage + Keystatic CMS.

Media Management Documentation

Complete documentation for Liberty Dynamic's media management system using Supabase Storage + Keystatic CMS.

🎯 Quick Navigation

For Daily Work → Media Workflow Quickstart

Fast-track guide for content creators and daily operations.

For Technical Details → Media Management Guide

Comprehensive technical reference for developers and administrators.

📋 What's Inside

Media Workflow Quickstart

Perfect for: Content creators, marketing team, daily operations

  • ✅ Two-step upload process (Supabase → Keystatic)
  • ✅ Business bucket guide (when to use each)
  • ✅ Console upload walkthrough
  • ✅ Common workflows with examples
  • ✅ Quick troubleshooting

Media Management Guide

Perfect for: Developers, system administrators, technical deep-dives

  • ✅ Complete architecture overview
  • ✅ CLI tools reference
  • ✅ MCP tools for safe operations
  • ✅ Security & RLS policies
  • ✅ Performance optimization
  • ✅ Emergency procedures
  • ✅ Production safety warnings

🏗️ Current System

Production Infrastructure

  • Storage: Supabase Storage (5 business-focused buckets)
  • CMS: Keystatic with centralized Media Library
  • Strategy: Production Supabase for media, local development for database

Business Buckets

  • media_library - General CMS content (blog, pages)
  • website_media - Visual assets (logos, products, branding)
  • marketing_media - Downloadable content (PDFs, videos)
  • demonstration_media - Product demos and tutorials
  • legal_documents - Legal and compliance materials

Key Benefits

  • ✅ Cross-branch media sharing (same URLs work everywhere)
  • ✅ No GitHub repo bloat (files stored in cloud)
  • ✅ Global CDN delivery (fast worldwide access)
  • ✅ Team collaboration (shared production storage)
  • ✅ Professional workflow (proper asset management)

🚨 Important Safety Notes

Production Protection

Your production Supabase contains real business assets that power your live website.

Never perform destructive operations on production without testing locally first.

Safe Operations

  • ✅ Use MCP tools for bucket management
  • ✅ Test changes locally before production
  • ✅ Always backup before major changes
  • ✅ Use ADD-only operations when possible

🚀 Getting Started

Content Creators & Marketing Team

👉 Start with: Media Workflow Quickstart

Quick Process:

  1. Upload to Supabase Console
  2. Copy public URL
  3. Create Media Library entry in Keystatic
  4. Use in your content

Developers & Administrators

👉 Start with: Media Management Guide

Setup Verification:

# Test environment and connection
node scripts/debug-env.mjs

# Verify bucket access
node scripts/setup-production-media-simple.mjs

# List available commands
pnpm media:help

📞 Need Help?

Documentation Issues

  • Check both guides above for comprehensive coverage
  • Use CLI help: pnpm media:help
  • Run diagnostics: node scripts/debug-env.mjs

Technical Issues

  • Supabase Support: Dashboard → Support → New Ticket
  • Community: GitHub Discussions
  • Emergency: Follow procedures in technical guide

This documentation system covers all media management operations while maintaining safety and clarity for both technical and non-technical users.