# DNS Propagation Checker

**Global DNS Propagation Checker** - Check DNS propagation across worldwide DNS servers in real-time.

🌐 **Live Demo**: https://dns-propagation.autocompany.workers.dev

## Features

- **Global Coverage**: Query DNS servers across North America, Europe, Asia, and Australia
- **Real-time Results**: Get instant DNS propagation status with response times
- **Multiple Record Types**: Check A, AAAA, CNAME, MX, NS, and TXT records
- **Free API Access**: Integrate DNS checks into your workflow with our REST API
- **Edge Computing**: Powered by Cloudflare Workers for fast, global response

## Quick Start

### Web UI

Visit https://dns-propagation.autocompany.workers.dev and enter a domain to check.

### API

```bash
# Check A records
curl "https://dns-propagation.autocompany.workers.dev/api/check?domain=example.com&type=A"

# Check MX records
curl "https://dns-propagation.autocompany.workers.dev/api/check?domain=gmail.com&type=MX"
```

### Response Format

```json
{
  "domain": "example.com",
  "record_type": "A",
  "timestamp": "2026-02-18T12:00:00.000Z",
  "results": [
    {
      "server": {
        "name": "Cloudflare",
        "ip": "1.1.1.1",
        "location": "San Francisco",
        "country": "United States",
        "country_code": "US"
      },
      "records": ["93.184.215.14"],
      "query_time": 45,
      "status": "success"
    }
  ],
  "propagated_count": 10,
  "total_count": 10,
  "propagation_percentage": 100
}
```

## Supported DNS Record Types

| Type | Description |
|------|-------------|
| A | IPv4 address |
| AAAA | IPv6 address |
| CNAME | Canonical name |
| MX | Mail exchange |
| NS | Name server |
| TXT | Text record |

## DNS Servers

We query multiple public DNS resolvers worldwide:

| Server | Location | Country |
|--------|----------|---------|
| Cloudflare | San Francisco | US |
| Google | Mountain View | US |
| Quad9 | Zurich | CH |
| Cloudflare EU | London | GB |
| Google EU | Amsterdam | NL |
| DNS.WATCH | Frankfurt | DE |
| Cloudflare APAC | Tokyo | JP |
| Google APAC | Singapore | SG |
| Cloudflare AU | Sydney | AU |
| Google BR | São Paulo | BR |

## Use Cases

1. **DNS Migration**: Verify your DNS changes have propagated globally
2. **Troubleshooting**: Identify DNS resolution issues across regions
3. **Monitoring**: Check DNS health for your domains
4. **Development**: Test DNS configurations before going live

## Technology Stack

- **Runtime**: Cloudflare Workers (Edge Computing)
- **Language**: TypeScript
- **DNS-over-HTTPS**: Cloudflare DoH API
- **Caching**: Cloudflare KV

## Local Development

```bash
# Clone the repository
git clone https://github.com/brancogao/dns-propagation-checker.git
cd dns-propagation-checker

# Install dependencies
npm install

# Run development server
npm run dev

# Deploy to Cloudflare
npm run deploy
```

## API Rate Limits

| Tier | Requests/day | Price |
|------|--------------|-------|
| Free | 100 | $0 |
| Developer | 10,000 | $9/mo |
| Agency | Unlimited | $49/mo |

## License

MIT License - See [LICENSE](LICENSE) for details.

## Author

Built by [Auto Company](https://github.com/brancogao)

## Related Projects

- [Redirect Checker](https://github.com/brancogao/redirect-checker) - HTTP redirect chain analyzer
- [Webhook Debugger](https://github.com/brancogao/webhook-debugger) - Webhook testing tool