ICANN TLDs

pub package Auto Update

A List of TLDs from ICANN that is automatically updated daily.

Features

  • 🔄 Auto-updated daily - TLDs list is automatically synchronized with ICANN's official data
  • 📦 Zero dependencies - Pure Dart implementation with no external dependencies
  • 🌐 Complete coverage - Includes all official TLDs including internationalized domain names (IDNs)
  • ⚡ Lightweight - Minimal package size with efficient data structure

Install

With Dart:

dart pub add icann_tlds

With Flutter:

flutter pub add icann_tlds

Usage

Basic Usage

import 'package:icann_tlds/icann_tlds.dart';

void main() {
  // Get all TLDs
  print(tlds);
  //=> ['aaa', 'aarp', 'abarth', 'abb', 'abbott', 'abbvie', 'abc', ...]
  
  // Check if a TLD exists
  print(tlds.contains('com')); //=> true
  print(tlds.contains('invalid')); //=> false
  
  // Get total count
  print('Total TLDs: ${tlds.length}');
}

Domain Validation

import 'package:icann_tlds/icann_tlds.dart';

void main() {
  // Use the built-in domain validation function
  print(isValidDomain('example.com')); //=> true
  print(isValidDomain('test.xyz')); //=> true
  print(isValidDomain('invalid.notexist')); //=> false
  print(isValidDomain('no-tld')); //=> false
  print(isValidDomain('.com')); //=> false (invalid format)
}

Email Validation Helper

import 'package:icann_tlds/icann_tlds.dart';

void main() {
  // Use the built-in email TLD validation function
  print(hasValidTLD('[email protected]')); //=> true
  print(hasValidTLD('[email protected]')); //=> true
  print(hasValidTLD('[email protected]')); //=> false
  print(hasValidTLD('invalid-email')); //=> false (invalid format)
}

TLD Utilities

import 'package:icann_tlds/icann_tlds.dart';

void main() {
  // Use built-in utility functions
  
  // Get all country code TLDs (2 characters)
  final ccTLDs = getCountryCodeTLDs();
  print('Country code TLDs: ${ccTLDs.length}');
  print('Examples: ${ccTLDs.take(5).toList()}'); // [us, uk, jp, ...]
  
  // Get TLDs starting with 'a'
  final aTLDs = getTLDsStartingWith('a');
  print('TLDs starting with "a": ${aTLDs.length}');
  print('Examples: ${aTLDs.take(5).toList()}'); // [aaa, aarp, ...]
  
  // Get the longest TLD
  final longestTLD = getLongestTLD();
  print('Longest TLD: $longestTLD (${longestTLD.length} characters)');
  
  // You can still use the raw tlds list for custom filtering
  final shortTLDs = tlds.where((tld) => tld.length <= 3).toList();
  print('Short TLDs (≤3 chars): ${shortTLDs.length}');
}

Automatic Updates

This package is automatically updated daily at 02:00 UTC using GitHub Actions. When ICANN releases new TLDs or removes existing ones, the package will be automatically updated and published to pub.dev within 24 hours.

Update Process

  1. Daily Check - GitHub Actions runs daily to fetch the latest TLD list from ICANN
  2. Change Detection - Compares with the current list to detect any changes
  3. Auto Publish - If changes are detected, automatically:
    • Updates the TLD list
    • Increments the patch version
    • Runs tests to ensure data integrity
    • Publishes to pub.dev
    • Creates a GitHub release

Manual Updates

You can also trigger updates manually by running the GitHub Action workflow or by running the update script locally:

dart run scripts/update.dart

Libraries

icann_tlds