Custom domains are a basic requirement for any multi‑tenant SaaS, yet every hosting platform—Vercel, Cloudflare for SaaS, Railway, Render, Netlify—exposes its own API for adding, verifying, and removing hostnames. This fragmentation forces engineers to write platform‑specific glue code, handle different polling intervals, interpret disparate status fields, and maintain separate test mocks. The result is duplicated effort, higher bug risk, and slower onboarding when you need to support another provider.
OpenCoreDev’s Domain SDK solves this problem by providing a single TypeScript client that normalizes the custom‑domain lifecycle across all supported providers. The SDK does not register DNS, issue certificates, or store tenant data; it simply tells you exactly which DNS records you need to add, lets you add or remove a hostname, and polls the provider until the domain reaches an active state. Because it models DNS ownership, verification, and certificate steps as separate union values, you can react to each stage precisely—showing customers the right instructions at the right time without guessing when propagation finishes.
Using the SDK is straightforward: import the provider adapter you need, call add(hostname), render the required records returned in the response, then await waitUntilActive(hostname) with optional timeout and interval settings. Removal is just as simple with remove(hostname). All methods accept an AbortSignal for cancellation, and add/remove are idempotent so retries are safe. For CI or local testing, an in‑memory adapter lets you simulate state transitions, inject latency, and assert on call logs without touching real infrastructure.
Teams building multi‑tenant apps on Vercel can instantly display live CNAME/TXT records to customers. Those scaling on Cloudflare for SaaS benefit from explicit scoping inside a single zone. Swapping providers later only requires changing the import—the workflow stays identical. By centralizing the domain logic, the SDK reduces boilerplate, improves reliability, and lets developers focus on product features rather than provider quirks.