velt-proxy-server-best-practices
Velt proxy server setup and configuration best practices for routing Velt SDK traffic through your own reverse proxy (nginx or Cloudflare Workers).
Skill by velt
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/velt-js-velt-proxy-server-best-practices
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: backend, cloud, security, writing
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/velt-proxy-server-best-practices
What's inside
- Skill name
velt-proxy-server-best-practices- Description
- Velt proxy server setup and configuration best practices for routing Velt SDK traffic through your own reverse proxy (nginx or Cloudflare Workers). Use when configuring proxyConfig on VeltProvider or initVelt, setting up nginx or Cloudflare Workers as a reverse proxy for Velt CDN/API/database/storage/auth endpoints, whitelisting Content Security Policy (CSP) domains for Velt, enabling Subresource Integrity (SRI), or debugging proxy-related connectivity issues. Triggers on any task involving Velt proxy, reverse proxy, proxyConfig, cdnHost, apiHost, v1DbHost, v2DbHost, storageHost, authHost, forceLongPolling, CSP whitelisting for Velt, nginx or Cloudflare Workers configuration for Velt, or network policy compliance with Velt — even if the user doesn't explicitly say 'proxy'.
- License
- MIT
- Metadata
- author: velt · version: 1.0.0
- Instructions
- 40 lines in SKILL.md · view on GitHub
Files (20)
- AGENTS.full.md
- AGENTS.md
- SKILL.md
- metadata.json
- _sections.md · rules/shared/
- core-auth-provider.md · rules/shared/core/
- core-proxy-overview.md · rules/shared/core/
- debug-proxy-verification.md · rules/shared/debugging/
- sdk-integrity-check.md · rules/shared/sdk-config/
- sdk-proxy-config-non-react.md · rules/shared/sdk-config/
- sdk-proxy-config-react.md · rules/shared/sdk-config/
- security-csp-whitelist.md · rules/shared/security/
- security-force-long-polling.md · rules/shared/security/
- server-cloudflare-workers.md · rules/shared/server-setup/
- server-nginx-api.md · rules/shared/server-setup/
- server-nginx-auth.md · rules/shared/server-setup/
- server-nginx-cdn.md · rules/shared/server-setup/
- server-nginx-ephemeral-db.md · rules/shared/server-setup/
- server-nginx-persistence-db.md · rules/shared/server-setup/
- server-nginx-storage.md · rules/shared/server-setup/
SKILL.md (first lines)
# 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
From velt-js/velt-plugin-claude, MIT.
More from velt-js/velt-plugin-claude
- 0.474score
velt-rest-apis-best-practices
velt
Velt REST API v2 and webhook best practices for server-side integration.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-node-sdk-best-practices
velt
Velt Node SDK (`@veltdev/node`) implementation patterns for Node.js / TypeScript backends.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-notifications-best-practices
velt
Velt Notifications implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-presence-best-practices
velt
Velt Presence implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-recorder-best-practices
velt
Velt Recorder implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-area-best-practices
velt
Best practices for Velt Area Comments — the rectangle area-annotation feature that lets users draw a region on the page and attach a comment thread to it…
SkillCFreshness: CClaude Code +9 - 0.474score
velt-arrows-best-practices
velt
Best practices for Velt Arrows — the directional arrow annotation feature that lets users draw arrows pinned to DOM elements for visual feedback, design…
SkillCFreshness: CClaude Code +9 - 0.474score
velt-chat-sdk-adapter-best-practices
velt
Velt Chat SDK Adapter implementation patterns and best practices for building bots that integrate with Velt comment threads.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-comments-best-practices
velt
Velt Comments implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-crdt-best-practices
velt
Velt CRDT (Yjs) collaborative editing best practices for real-time applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-activity-best-practices
velt
Velt Activity Logs implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-huddle-best-practices
velt
Velt Huddle implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- May 18, 2026 (5 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Version
- 1.0.0
- License
- MIT
- Repository
- github.com/velt-js/velt-plugin-claude
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Same skill elsewhere
Copies of this SKILL.md published by others; search shows only one of them.
More from velt
- 0.474score
velt-activity-best-practices
velt
Velt Activity Logs implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-area-best-practices
velt
Best practices for Velt Area Comments — the rectangle area-annotation feature that lets users draw a region on the page and attach a comment thread to it…
SkillCFreshness: CClaude Code +9 - 0.474score
velt-arrows-best-practices
velt
Best practices for Velt Arrows — the directional arrow annotation feature that lets users draw arrows pinned to DOM elements for visual feedback, design…
SkillCFreshness: CClaude Code +9 - 0.474score
velt-chat-sdk-adapter-best-practices
velt
Velt Chat SDK Adapter implementation patterns and best practices for building bots that integrate with Velt comment threads.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-comments-best-practices
velt
Velt Comments implementation patterns and best practices for React, Next.js, and web applications.
SkillCFreshness: CClaude Code +9 - 0.474score
velt-crdt-best-practices
velt
Velt CRDT (Yjs) collaborative editing best practices for real-time applications.
SkillCFreshness: CClaude Code +9
Cite this page
velt-proxy-server-best-practices skill. Agent Mart. https://agentmart.dev/skills/velt-js-velt-proxy-server-best-practices (last updated 2026-10-24)