super_dns_client #

A modern and lightweight Dart library for performing DNS-over-HTTPS (DoH) lookups.
Supports multiple resolvers and can be easily integrated in Flutter or Dart server apps.

🚀 Features #

• 🔍 Query A, AAAA, CNAME, SRV, TXT records via DoH
• 🌐 Support for multiple resolvers (Google, Cloudflare, Quad9, OpenDNS, etc.)
• 🧠 Simple high-level API for easy DNS lookups
• 🧱 Built with http, freezed, and json_serializable
• ✅ Null-safe and fully tested

📦 Installation #

Add this to your pubspec.yaml:

dependencies:
  super_dns_client: ^0.1.0

Then run:

dart pub get

💡 Usage #

import 'package:super_dns_client/super_dns_client.dart';

void main() async {
  final client = DoHClient.resolver(DoHResolver.google);

  final response = await client.lookup('example.com', DnsRecordType.A);

  print('IPv4 addresses for example.com:');
  for (final record in response.records) {
    print('→ ${record.data}');
  }
}

⚙️ Supported DoH Resolvers #

🧪 Run Tests #

dart test

🪪 License #

Licensed under the MIT License.
See the LICENSE file for more details.

❤️ Contributing #

Pull requests and feature suggestions are welcome.
Open an issue at GitHub Issues if you find bugs or want to propose improvements.