Skip to content
Honeycomb Docs

Custom Domains

The Domains app lets users connect their own domains (e.g., links.mybrand.com) to Honeycomb-powered bio links and short links. It handles DNS verification, SSL certificate provisioning, and target app assignment.

Key Features

Section titled “Key Features”
  • Add custom domains with an inline form supporting domain name and optional target app selection
  • DNS verification tracking with pending/verified/failed status indicators
  • SSL provisioning with status badges (pending, provisioning, active, failed)
  • Default domain designation marked with a star icon
  • Target app routing — domains can be scoped to Bio Links, Short Links, or left open to any app
  • Domain settings page for additional configuration

Page Structure

Section titled “Page Structure”
RoutePurpose
/business/apps/domainsDomain list with inline add-domain form and status badges
/business/apps/domains/[id]Single domain detail and management
/business/apps/domains/settingsGlobal domain settings

Data Model Overview

Section titled “Data Model Overview”

Domain

Section titled “Domain”

Each domain record tracks the domain string, verification_status (pending, verified, failed), ssl_status (pending, provisioning, active, failed), DNS record details (dns_record_type, dns_record_value), and optional target_app scoping.

DomainWithStatus

Section titled “DomainWithStatus”

Extended type that adds computed is_dns_valid and is_ssl_ready boolean flags.

Key Components

Section titled “Key Components”
  • Add domain form — uses sveltekit-superforms with Zod validation (addDomainSchema), toggled via a button in the header. Includes a domain input and a target app dropdown (Any, Bio Links, Short Links).
  • Domain list — each row shows the domain name, default star indicator, target app label, verification status badge, and SSL status badge. Color-coded: green for verified/active, yellow for pending/provisioning, red for failed.
  • Status badges — dynamic CSS classes based on status using the statusBadge helper function

Notable Integrations

Section titled “Notable Integrations”
  • Services: listDomains and addDomain from $lib/apps/domains/services
  • Validation: addDomainSchema from $lib/apps/domains/modules/domains
  • Form handling: sveltekit-superforms with zod4 adapter for server-side validation and progressive enhancement
  • Toast notifications: svelte-sonner for success/error feedback on domain addition