skills.rest
get-convex
get-convexOFFICIAL
Explore all skills by this author →
Website𝕏@convex_devGitHub

convex-self-hosting

Configure Convex static self-hosting with deployment scripts and framework-specific routes.

9|3|Updated Nov 28, 2025
Search Tags:#deployment#troubleshooting#nextjs#vite#convex#self-hosting#static-hosting
One-click install
npx skills add https://github.com/get-convex/components-submissions-directory --skill convex-self-hosting-get-convex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-self-hosting
Source: https://github.com/get-convex/components-submissions-directory/tree/main/.codex/skills/convex-self-hosting
Command: npx skills add https://github.com/get-convex/components-submissions-directory --skill convex-self-hosting-get-convex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Integrate Convex static self hosting consistently across projects by following the latest upstream instructions, streamlining setup for upload APIs, HTTP routes, deployment scripts, migrations from external hosting, and troubleshooting static deploy issues across React, Vite, Next.js, and other frontends.

Core Features & Use Cases

  • Upstream-informed setup: check and apply the latest integration guidelines before implementing hosting.
  • End-to-end deployment workflow: configure convex.config.ts, static hosting, and deployment scripts for mixed environments.
  • Flexible deployment paths: supports published npm package or GitHub source with deterministic pinning.
  • Cross-framework compatibility: accommodates Vite, Next.js, React-based apps, Expo web, and other frontends with pathPrefix options and SPA fallbacks.
  • Troubleshooting guardrails: includes a thorough checklist, validation steps, and guidance on common issues.

Quick Start

Run the upstream check and begin the self-hosting setup following the latest integration guide.

Frequently Asked Questions about convex-self-hosting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Convex static self-hosting for a Next.js or Vite frontend?▼

Convex static self-hosting is configured by adding convex.config.ts, defining static hosting HTTP routes, and setting up deployment scripts tailored to your frontend framework's pathPrefix and SPA fallback requirements.

What is the two-step deploy flow for Convex static hosting?▼

The Convex static hosting deploy flow involves publishing your frontend static assets and updating your self-hosted backend configuration via deployment scripts, choosing between the published npm package or deterministic GitHub source pinning.

Does Convex self-hosting work with Expo web and other React-based apps?▼

Convex self-hosting accommodates Expo web and React-based apps by supporting cross-framework compatibility through configurable pathPrefix options and SPA fallback routing within your static hosting setup.

Why are my static assets not serving correctly after migrating to Convex self-hosting?▼

Static deploy issues during Convex self-hosting migration often stem from missing convex.config.ts static route definitions or incorrect pathPrefix settings, which you can resolve using the provided troubleshooting checklist and validation steps.

When should I choose the npm publish path over GitHub source for Convex self-hosting deployment?▼

Choose the npm publish path for streamlined Convex static hosting package distribution, or pin to GitHub source when you need deterministic builds directly from the upstream repository for your deployment scripts.

Do I need to check upstream instructions before setting up Convex static hosting?▼

Yes, fetching the latest upstream instructions from get-convex/self-hosting ensures your Convex static hosting configuration, upload APIs, and HTTP routes align with current integration guidelines before you implement deployment scripts.

Related Skills

Explore More Software Engineering Skills→
M4RC0SxM4RC0Sx

nextjs-static-init

Scaffold a Next.js project configured for static export to GitHub Pages.

Community
Advanced
TNHoang2708TNHoang2708
1

markdown-novel-viewer

Convert Markdown files into an HTML-based book-like reader.

Community
Intermediate
jezwebjezweb
961

cloudflare-worker-base

Configure Cloudflare Workers projects with Hono routing and Static Assets.

Community
Intermediate
waynesuttonwaynesutton
5

convex-self-hosting

Automate Convex static self-hosting integration and upkeep for frontend stacks.

Community
Advanced