domain-management

Configure domain routing and Cloudflare DNS for sgcarstrends.com and subdomains. Use when adding new services, updating domain patterns, or debugging DNS issues.

domain
management

SKILL.md

GitHub

Domain Management Skill

This skill helps you manage domains and DNS configuration for the MotorMetrics platform.

When to Use This Skill

  • Configuring custom domains in Vercel
  • Debugging domain resolution issues
  • Setting up redirects
  • Troubleshooting SSL/TLS errors

Domain Architecture

Domain Structure

motormetrics.app                    # Production web app
*.vercel.app                        # Preview deployments

DNS Provider: Vercel

Vercel handles DNS management with automatic SSL certificates.

Features:

  • Automatic SSL/TLS certificates
  • Global edge network
  • Fast DNS propagation
  • Built-in DDoS protection

Vercel Domain Configuration

Adding Custom Domain

  1. Go to Vercel Dashboard → Project Settings → Domains
  2. Add motormetrics.app
  3. Follow DNS configuration instructions
  4. Vercel automatically provisions SSL certificate

DNS Records

Point your domain to Vercel:

Type    Name    Value
A       @       76.76.21.21
CNAME   www     cname.vercel-dns.com

Or use Vercel nameservers for full DNS management.

Debugging DNS Issues

Check DNS Propagation

# Check DNS resolution
dig motormetrics.app
dig @8.8.8.8 motormetrics.app

# Or use online tools
# https://www.whatsmydns.net/#A/motormetrics.app

Check SSL Certificate

# Check certificate details
openssl s_client -connect motormetrics.app:443 -servername motormetrics.app

# Check certificate expiry
echo | openssl s_client -connect motormetrics.app:443 2>/dev/null | openssl x509 -noout -dates

Test Domain Resolution

# Test HTTPS
curl -I https://motormetrics.app

# Test redirect (www → apex)
curl -I https://www.motormetrics.app

Common Issues

Issue: DNS not resolving Solutions:

  1. Check DNS records in Vercel dashboard
  2. Verify nameserver configuration
  3. Wait for propagation (usually < 5 minutes)

Issue: SSL certificate error Solutions:

  1. Check domain is verified in Vercel
  2. Wait for certificate provisioning (up to 24 hours)
  3. Check domain DNS points to Vercel

Issue: 404 on custom domain Solutions:

  1. Verify domain is added to correct project
  2. Check deployment is successful
  3. Verify build output

Security Headers

Configure in next.config.ts:

const securityHeaders = [
  {
    key: "Strict-Transport-Security",
    value: "max-age=63072000; includeSubDomains; preload",
  },
  {
    key: "X-Frame-Options",
    value: "SAMEORIGIN",
  },
  {
    key: "X-Content-Type-Options",
    value: "nosniff",
  },
];

const nextConfig = {
  async headers() {
    return [
      {
        source: "/:path*",
        headers: securityHeaders,
      },
    ];
  },
};

References

Best Practices

  1. Use Apex Domain: motormetrics.app for cleaner URLs
  2. HTTPS Only: Vercel enforces HTTPS automatically
  3. www Redirect: Configure www → apex redirect
  4. Monitor: Check Vercel dashboard for domain status