electric-sql / electric-sql/electric

Skill: HTTP/2 & SSE proxy configuration (Caddy/nginx)

Open
#3,914 0 comments 4 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
10.4k
Forks
375
Avg merge
3d 1h
Merged PRs (30d)
18

Description

## Context

A common developer pain point is "my shapes are slow in local dev" — caused by HTTP/1.1's 6-connection browser limit. The fix is non-obvious: set up an HTTP/2 reverse proxy. Similarly, SSE requires proxy buffering to be disabled.

## Scope

Create an `electric-proxy-config` skill covering:

1. **Problem explanation** — Why HTTP/1.1 causes slow shapes, how to diagnose
2. **Caddy setup** — Caddyfile for HTTP/2 + `flush_interval -1` for SSE
3. **nginx setup** — `proxy_buffering off`, HTTP/2 listener config
4. **Apache setup** — `flushpackets=on` for SSE
5. **Vercel/Cloudflare/AWS** — CDN-specific SSE and caching considerations
6. **Diagnosis** — How to tell if you're hitting the connection limit vs other issues

## Source

Identified during domain discovery skill test run. Kept as standalone skill since "shapes are slow" is a concrete troubleshooting moment distinct from general deployment.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.