Step-by-Step Guide: Launching Your Website with GitHub Pages

Shirley Berchel
4 min readOct 31, 2023

--

Icon made by Freepik from @flaticon

If you’re looking for an easy way to share your projects or ideas with the world, GitHub Pages is the perfect platform. 🌍

It allows you to effortlessly host websites directly from your GitHub repository, making it a top pick for those who want to display their work.

This step-by-step tutorial will guide you through the process of setting up your very own website on GitHub Pages. 🚀

Creating a repository for your site 🏗️

To get started, you can either create a new repository or use an existing one for your site. Here are the steps:

  1. Head over to GitHub and log in to your account. 🔑
  2. Click on the New button, located at the top right of your dashboard. 🆕
  3. Choose a name for your repository and provide an optional description. If you’re creating a user or organization site, your repository must be named `<user>.github.io` or `<organization>.github.io`. 📛

4. Make sure the repository visibility is set to Public. 👁️

5. Select the option to Initialize this repository with a README.

6. Finally, click on Create Repository. 🚢

🏁 Creating your site

Now, let’s set up your website:

1. On GitHub, navigate to your site’s repository. 🗺️
2. Decide which publishing source you want to use. 📤

Under your repository name, click on Settings. If you can’t see the “Settings” tab, click on the dropdown menu, then select Settings. ⚙️

In the “Code and automation” section of the sidebar, click on Pages.

🧰 Under “Build and deployment,” in the “Source” section, choose Deploy from a branch. 🌐

Under “Build and deployment,” use the branch dropdown menu to select your publishing source. 🌱

3. Click Save. 💾
To complete your site setup, you need to create an entry file. GitHub Pages will look for an `index.html`, `index.md`, or `README.md` file as the entry point for your site. 📄

🔍 To view your published site, go to the “Code and automation” section of the sidebar, click on Pages under “GitHub Pages,” and then click on the URL where your site is published.

🌟 Enhancing Your GitHub Pages Site

GitHub Pages doesn’t stop at just hosting your site; it offers a plethora of features to enhance and customize your web presence:

  • Enabling HTTPS: GitHub Pages allows you to secure your website with HTTPS, ensuring that your visitors’ data is encrypted. You can find detailed information on enabling HTTPS in your GitHub Pages site by referring to the [GitHub Pages HTTPS documentation]. 🔒
  • Custom Domains: If you want to use your own domain name instead of the default GitHub Pages URL, GitHub makes it easy. You can set up a custom domain by following the steps in the [GitHub Pages custom domain documentation]. 🌐
  • Adding a Jekyll Theme: GitHub Pages integrates seamlessly with Jekyll, a popular static site generator. You can apply Jekyll themes to your site for a professional and polished look. For more information on using Jekyll with GitHub Pages, you can explore the [GitHub Pages Jekyll documentation]. 📦

For further information and in-depth instructions on any of these topics, you can explore the GitHub Pages documentation.

Now that you’ve started the process of creating a website using GitHub Pages, I encourage you to give it a try and set up your very own site. 🌐

If you found this guide helpful, don’t forget to show your appreciation by clapping for this article. 👏

Your feedback and comments are always welcome, and I’d love to hear about your experiences with GitHub Pages. 📢

To stay updated with more informative content, don’t hesitate to hit that ‘Follow’ button. 🔔

Happy coding! 🚀

--

--

Shirley Berchel

👩🏽‍🎓 Digital Strategy Student | 💻 Web Developer | 📚 Books and Personal Development Enthusiast