convex-domains

Configure DNS records and attach custom domains to Convex deployments.

1|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-domains-rocktown-labs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-domains
Source: https://github.com/Rocktown-Labs/rivercitymd/tree/main/.agents/skills/convex-domains
Command: npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-domains-rocktown-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pointing a domain you already own at a Convex app involves multiple error-prone steps: creating the right DNS records at your registrar, attaching the custom domain to Convex, and rebinding your auth origin so sign-in keeps working. This Skill walks through the entire process and prevents common mistakes like missing TXT verification records or broken auth after the switch. ## Core Features & Use Cases - DNS Record Setup: Detects an already-authenticated DNS CLI (flarectl, aws, gcloud, doctl, vercel) and offers to create the CNAME/A and TXT verification records automatically, or gives exact record values for manual entry at your registrar. - Custom Domain Attachment: Attaches the domain as a Convex custom domain and verifies propagation with dig. - Auth Origin Rebinding: Updates SITE_URL, RP_ID, and ORIGIN environment variables so passkeys and OAuth keep working on the new domain. - Use Case: You deployed a booking app on Convex and want it served at bookings.example.com instead of the default convex.app URL, without breaking existing user sign-ins. ## Quick Start Point my domain example.com at my Convex app and update the auth settings so login still works.

Frequently Asked Questions about convex-domains

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

FAQPage Schema
How do I point my custom domain at a Convex app?▼

Create a CNAME record (or A/ALIAS at the apex) pointing to your Convex hosting or HTTP actions URL, add the TXT verification record, then attach the domain as a Convex custom domain via the dashboard or CLI. Verify propagation with dig +short before testing HTTPS.

How to create DNS records for Convex with Cloudflare or Route53?▼

If a DNS CLI is already authenticated on your machine, records can be created with flarectl dns create for Cloudflare or aws route53 change-resource-record-sets for Route53. Otherwise, create the CNAME and TXT records manually at your registrar using the exact host and value strings provided.

Why does sign-in break after switching to a custom domain?▼

Changing the domain changes the auth origin, so passkeys and OAuth stop matching the old configuration. Rebind SITE_URL, RP_ID, and ORIGIN environment variables to the new domain and re-deploy or re-publish the app to restore sign-in.

Can I use wrangler to manage Cloudflare DNS records?▼

No, wrangler itself does not manage DNS records. Use flarectl dns create or the Cloudflare API with your token instead. Check authentication first with flarectl user info before creating records.

How long does DNS verification take for a custom domain?▼

DNS propagation can take from minutes to hours depending on your registrar and TTL settings. Verify that records have landed using dig +short before expecting the domain to serve the app over HTTPS.