Get your free {name}.thedev.me subdomain
- 🌟 Star and fork this repository
- 📰 Read the entire README and review our Terms of Service
- 🗄️ Create a JSON file and name it
yoursubdomain.thedev.me.jsonin./domainsof your forked repo. - ✍️ Fill in the JSON file (format and instructions below). Make sure the JSON is valid with no trailing commas.
- 🫷 Open a pull request with your changes.
- 🤖 Automated checks will run and report any JSON errors. (First-time contributors await a manual trigger.)
- ✅ 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.
-
We support A, AAAA, CNAME, NS, MX, and TXT record types.
-
We do NOT support wildcards or sub-subdomains. (yet).
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
}subdomain: Your desired subdomain (e.g., "myproject" for myproject.thedev.me)domain: Always "thedev.me"public_email: Your public contact emailgithub_username: Your GitHub usernamedescription: A brief description of your subdomain's purposerecords: DNS records for your subdomain. Only keep the ones you need. Learn more.proxied: Set totrueif you want to use Cloudflare's proxy,falseotherwise.
By using this service, you agree to be bound by our Terms of Service. Please review them carefully.
MIT License
If you need help or have questions, please open an issue in this repository or send an email to [email protected]
If you're interested in registering subdomains similar to *.thedev.me, consider exploring these services: