Skip to main content
AI/MLjeremylongshore

hex-deploy-integration

'Deploy Hex integrations to Vercel, Fly.io, and Cloud Run platforms.

Stars
2,267
Source
jeremylongshore/claude-code-plugins-plus-skills
Updated
2026-05-31
Slug
jeremylongshore--claude-code-plugins-plus-skills--hex-deploy-integration
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/HEAD/plugins/saas-packs/hex-pack/skills/hex-deploy-integration/SKILL.md -o .claude/skills/hex-deploy-integration.md

Drops the SKILL.md into .claude/skills/hex-deploy-integration.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Hex Deploy Integration

Overview

Deploy Hex orchestration services that trigger project runs from web endpoints or cron jobs.

Instructions

Vercel — On-Demand Data Refresh

// api/refresh.ts
export default async function handler(req, res) {
  const response = await fetch(`https://app.hex.tech/api/v1/project/${process.env.HEX_PROJECT_ID}/run`, {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${process.env.HEX_API_TOKEN}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ inputParams: req.body || {}, updateCacheResult: true }),
  });
  res.json(await response.json());
}

vercel env add HEX_API_TOKEN production
vercel env add HEX_PROJECT_ID production

Cloud Run — Scheduled Orchestrator

gcloud run deploy hex-orchestrator \
  --image gcr.io/$PROJECT_ID/hex-orchestrator \
  --set-secrets=HEX_API_TOKEN=hex-api-token:latest \
  --timeout=600

Prerequisites

  • An approved deployment change, secret references, project/destination allowlist, and immutable client/configuration revision.
  • Safe canary project, baselines for health/latency/quota/output assertions, and a tested rollback/cancel artifact.

Output

Produce a deployment receipt with artifact digest, environment, canary project, health/latency/quota/aggregate assertion outcomes, owner approval, rollout state, and rollback reference. Exclude SQL, output, and secrets.

Error Handling

Halt for unknown project/destination, unauthorized scope, failed canary assertion, unbounded retry, or leaked output in telemetry. Cancel affected execution and restore the previous revision rather than bypassing a gate.

Examples

artifact=sha256:opaque; env=staging; canary=proj-sandbox-12; health=pass; assertions=pass; quota=pass; rollback=release-r31 supports controlled promotion.

Resources