SuperAPI AI Directory

velt-proxy-server-best-practices

Deployment & operations

View repository

Updated 10-16 08:10

About this skill

Velt Proxy Server Best Practices

Comprehensive guide for routing all Velt SDK traffic through your own reverse proxy infrastructure. Contains 14 rules across 5 categories covering SDK configuration, nginx and Cloudflare Workers server setup, CSP security, and debugging.

When to Apply

Reference these guidelines when:

  • Routing Velt SDK traffic through your own domain (enterprise network policies, branding)
  • Configuring proxyConfig on VeltProvider (React) or initVelt() (other frameworks)
  • Setting up nginx (or another reverse proxy) to forward to Velt's backend services
  • Whitelisting Velt domains in Content Security Policy headers
  • Enabling Subresource Integrity (SRI) for the proxied SDK bundle
  • Debugging proxy connectivity issues (WebSocket upgrades, auth token refresh, CORS)

Rule Categories by Priority

Priority Category Impact Prefix
1 Core CRITICAL core-
2 SDK Config CRITICAL sdk-
3 Server Setup HIGH server-
4 Security HIGH security-
5 Debugging MEDIUM debug-

How to Use

Read individual rule files for detailed explanations and code examples:

rules/shared/core/core-proxy-overview.md
rules/shared/sdk-config/sdk-proxy-config-react.md
rules/shared/server-setup/server-nginx-cdn.md

Compiled Documents

  • AGENTS.md — Compressed index of all rules with file paths (start here)
  • AGENTS.full.md — Full verbose guide with all rules expanded inline