# Domain Management

> Configure domain routing and DNS for motormetrics.app. Use when adding new services, updating domain patterns, or debugging DNS issues.

- Skill: `motormetrics/domain-management-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add motormetrics/domain-management-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/motormetrics/domain-management-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: motormetrics (https://skillmd.com/u/motormetrics)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/motormetrics/domain-management-2

---


# 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

```bash
# 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

```bash
# 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

```bash
# 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`:

```typescript
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

- Vercel Domains: https://vercel.com/docs/projects/domains
- Vercel DNS: https://vercel.com/docs/projects/domains/dns

## 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