All Articles

Setting up Sub-Domain on Polywork with Cloudflare Pages

Cloudflare Pages allows you deploy your dynamic frontend applications using a Jamstacky Git workflow.

Over the last couple of years, we have seen a trend in how the Jamstack CI/CD process has given frontend developers superpowers with Git and Github . Also, this process also introduces frontend developers to domain name systems (DNS) and terminologies like CNAME which involves deployment. 

My first experience was to Google what the heck a CNAME was. Apparently it is a type of resource record in the Domain Name System (DNS) that maps one domain name (an alias) to another (the canonical name). 

Think of it as a pet name you give a link or a site so that it can all be hosted on your domain (In my case obinnaspeaks.dev).

 What is Polywork?

I heard about this cool new platform that allowed people showcase all their amazing talents in a timeline format, and I was hooked. You can add tags and links to activities and if not for anything, it is an actual trip down memory lane.

My personal take on this platform is that, it is a way for people in developer relations to  keep track of all the activities we get up to, in a single place. It gives that feeling of confidence and a way to have your work speak for you. 

Hosting your Polywork profile on Cloudflare pages.

Now, let’s get into the good stuff. After you’ve set up your profile, the people at Polywork had the brilliant idea to allow users host their profiles as sub domains of their own sites. To do this, you would have to go to your profile settings, and you will see some steps to set up your custom domain, by selecting your provider. 

In my case, my provider is Namecheap and instead of the basic DNS setup Namecheap provides, I am using a custom DNS on Cloudflare pages, so that I can leverage on Cloudflare’s edge network to host my site.

Although there is a document that shows how to set up your Namecheap DNS this doesn’t include Cloudflare Pages custom settings, but we will fix this. 

Set up Custom domain on Pages. 

If you head over to Cloudflare pages site and login you can see the list of projects you’ve added through Github. Right now, if you already have your domain set up. 

  • Step 1 :  Click on the manage Cloudflare DNS option.

This will take you to a DNS management environment 

  • Step 2: Add new record 

 As you can see, there are other options you can take advantage of but we are concerned with the CNAME today. 

 The thing I appreciate the most about this process is that, as you fill in the name and the target , it updates the text on-top. So you see that  “timeline.obinnaspeaks.dev is an alias of heroku line from polywork and has its traffic proxied through Cloudflare.” 

Well that’s all folks! Let’s connect on Polywork! Until next time, happy coding 💜

https://timeline.obinnaspeaks.dev/