Skip to content

Latest commit

 

History

History
114 lines (82 loc) · 4.04 KB

README.md

File metadata and controls

114 lines (82 loc) · 4.04 KB
Raw

*.thedev.me - Free Subdomains

Get your free {name}.thedev.me subdomain

header

GitHub stars   Domains   GitHub pull requests  

How to Get Your Subdomain

  1. 🌟 Star and fork this repository
  2. 📰 Read the entire README and review our Terms of Service
  3. 🗄️ Create a JSON file and name it yoursubdomain.thedev.me.json in ./domains of your forked repo.
  4. ✍️ Fill in the JSON file (format and instructions below). Make sure the JSON is valid with no trailing commas.
  5. 🫷 Open a pull request with your changes.
  6. 🤖 Automated checks will run and report any JSON errors. (First-time contributors await a manual trigger.)
  7. ✅ After manual review and approval, your subdomain will be live within minutes.

Note

Passing automated checks does NOT guarantee approval. All submissions undergo manual review to ensure quality and compliance. Read our Terms of Service.

Supported Record Types

  • We support A, AAAA, CNAME, NS, MX, and TXT record types.

  • We do NOT support wildcards or sub-subdomains. (yet).

JSON Formatting

To register your subdomain, create a new JSON file in the ./domains directory. The filename should be in the following format, yoursubdomain.thedev.me.json.

Use the following structure for your JSON file.

Important

Keep only the necessary records, update their values as needed, and delete the others. Typically, this means an IP address as an A record or a hostname as a CNAME record. NS records specify the nameservers that store DNS records. MX and TXT records handle email routing and ensure email authenticity and domain ownership. Learn more about DNS records.

Important

Ensure your JSON file is valid with NO trailing commas. You can easily check the format validity here.

{
  "subdomain": "yoursubdomain",
  "domain": "thedev.me",
  "public_email": "[email protected]",
  "github_username": "user",
  "description": "A brief description of the purpose of the subdomain",

  "records": {
    "A": [
      "192.0.2.1",
      "192.0.2.2"
    ],
    "AAAA": [
      "2001:db8::1",
      "2001:db8::2"
    ],
    "CNAME": [
      "example.com"
    ],
    "NS": [
      "ns1.example.com",
      "ns2.example.com"
    ],
    "MX": [
      "mail1.example.com",
      "mail2.example.com"
    ],
    "TXT": [
      "v=spf1 include:_spf.example.com ~all"
    ]
  },
  "proxied": true
}

Fields Explanation

  • subdomain: Your desired subdomain (e.g., "myproject" for myproject.thedev.me)
  • domain: Always "thedev.me"
  • public_email: Your public contact email
  • github_username: Your GitHub username
  • description: A brief description of your subdomain's purpose
  • records: DNS records for your subdomain. Only keep the ones you need. Learn more.
  • proxied: Set to true if you want to use Cloudflare's proxy, false otherwise.

Terms and Conditions

By using this service, you agree to be bound by our Terms of Service. Please review them carefully.

License

MIT License

Support

If you need help or have questions, please open an issue in this repository or send an email to [email protected]

Featured

If you're interested in registering subdomains similar to *.thedev.me, consider exploring these services: