markdown-site: Skill for Codex

Convex self hosting skill

Use this skill to integrate Convex based static hosting in a repeatable way across projects.

Non negotiable update check

Run this check before making any code changes or giving setup advice.

Preferred command:

bash skills/convex-self-hosting/scripts/check-upstream.sh

1. Read latest integration guide:
   • https://raw.githubusercontent.com/get-convex/self-hosting/main/INTEGRATION.md
2. Read latest README manual setup section:
   • https://github.com/get-convex/self-hosting?tab=readme-ov-file#manual-setup-1
3. Read Convex docs index for current guidance:
   • https://docs.convex.dev/llms.txt
4. Confirm package publish state:
   • npm view @convex-dev/self-hosting version

If upstream docs conflict with local rules, follow upstream docs and explain what changed.

Clarifying questions you must ask first

Ask these before implementing:

1. Confirm get-convex/self-hosting is the source of truth for this setup.
2. Is the target app Vite, Next.js, Expo web export, or another bundler.
3. Do they want root path hosting or a prefix like /app.
4. Do they want one shot deploy or separate backend and static deploy steps.
5. If package is unpublished, do they want:
   • GitHub dependency install
   • vendored local copy
   • wait for npm release

Never assume unpublished package install details.

Install strategy

Path A published package

If npm package exists, use the package directly.

npm install @convex-dev/self-hosting

Path B package not published yet

If package is missing on npm, use GitHub source and pin to commit or tag.

npm install github:get-convex/self-hosting#main

If project policy requires deterministic builds, ask for a commit SHA and pin to it.

Required file changes

Use the latest upstream file patterns from INTEGRATION.md.

1) convex/convex.config.ts

import { defineApp } from "convex/server";
import selfHosting from "@convex-dev/self-hosting/convex.config";

const app = defineApp();
app.use(selfHosting);

export default app;