vite-static-asset-proxy-debug

What problem does it solve?

This Skill solves the common issue where backend-served static assets (such as images and files) load correctly in production but return HTML instead of binary content when accessed via a local Vite dev server, breaking inline previews and asset display.

Core Features & Use Cases

• Proxy Configuration Guidance: Provides the exact Vite config setup to correctly proxy backend static asset paths to the backend service.
• Env Var Pitfall Fix: Covers the edge case where Vite loads .env.production instead of .env during dev builds, causing incorrect API endpoints in built assets.
• Verification Steps: Includes simple curl commands to confirm assets are served correctly after fixes.
• Use Case: For example, if your app's image lightbox works in production but shows broken images in local Vite dev, this Skill guides you through diagnosing the root cause and applying the correct fix.

Quick Start

Use the vite-static-asset-proxy-debug skill to fix the issue where your Vite dev server returns HTML instead of binary content for backend-served static asset paths.