How to Get a Free Subdomain :-> Here's the Complete Guide

How to Get a Free Subdomain :-> Here's the Complete Guide


3 min read

Introduction :->

Hey Folks! ๐Ÿ™‹๐Ÿปโ€โ™‚๏ธ In the world of emerging technology, every developer needs their own website for business, personal portfolio, or other work. Here's where comes in, offering a service that allows developers to get a sweet-looking subdomain for their personal websites. In this article, we'll walk through the complete steps to get your own domain.

Let's get started!

STEP 1 :->

Make sure your website is ready and its code is uploaded on GitHub with a repository name in the format, as shown below ๐Ÿ‘‡

Now go to the Settings In the "Code and automation" section of the sidebar, click Pages. Under "Build and deployment", under "Source", select Deploy from a branch. Under "Build and deployment", under "Branch", use the branch dropdown menu and select a publishing source.

Visit to view your new website. Note that it can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub.

STEP 2 :->

Fork this Repository ๐Ÿ‘‰ is-a-dev-repo

STEP 3 :->

Now open the forked Repository in your profile, to register a subdomain, you need to create a new JSON file in the domains directory paste the following code and make sure your file looks like the image below. & Don't forget to change your username and your email. For example, if you want your website link looks like this, you would create a file named example.json in the domains directory. The full path would be domains/example.json.

    "description": "Portfolio website",
    "repo": "",
    "owner": {
        "username": "your-username",
        "email": "your-email"
    "record": {
        "CNAME": ""

STEP 4 :->

Now after completing the above steps send a pull request to the owner for a review. Make sure you will tick the requirements and will provide your website link as show in the image below ๐Ÿ‘‡

Now wait for the review when reviewer finds your commits & if every thing will be fine then your pull request will be merged .

STEP 5 :->

Now if your pull request will be merged then only follow this step

  • Go to your GitHub repository that you use for your domain.

  • Click on the Settings tab.

  • Click on the Pages link in the sidebar.

  • In the custom domain option, enter the domain you registered.

  • Check the Enforce HTTPS checkbox.

  • Give your domain some time (~24 hours) for the changes to propagate.

  • Enjoy your domain!

I hope you found this article insightful! If you did, feel free to share it โ€“ sharing is caring, after all.

Thank you for reading! ๐Ÿ˜„

Connect with me on LinkedIn or visit my website to learn more about my work ๐Ÿ‘จ๐Ÿปโ€๐Ÿ’ป.

Happy coding!

Did you find this article valuable?

Support Gopal Gupta by becoming a sponsor. Any amount is appreciated!