nginx-sse-streaming-fix

What problem does it solve?

This Skill resolves the common issue where Server-Sent Events (SSE) endpoints function correctly on the backend but fail to stream data in real time to browsers when routed through an nginx reverse proxy, which buffers full responses by default and blocks incremental chunk delivery.

Core Features & Use Cases

• Dual-side configuration fixes: Provides exact changes for both backend response headers and nginx location directives to disable buffering and enable proper streaming.
• Troubleshooting guidance: Helps distinguish nginx-related issues from browser-side SSE parser bugs to avoid unnecessary config changes.
• Verification steps: Includes simple checks to confirm streaming is working as expected in both curl and browser environments.
• Use Case: Use this Skill when building real-time features like live chat, progressive image generation, or live data feeds that rely on SSE and are deployed behind nginx.

Quick Start

Use this skill to fix broken real-time SSE streaming for your nginx-reverse-proxied API endpoints by applying the provided backend and nginx configuration changes.