how to set up a website github

How to Set Up a Website on GitHub

By Christopher Johnson
AD

Setting up a website on GitHub is not only free and simple, but it's also an excellent way to showcase your projects, connect with the developer community, and build your personal brand online. Here's a comprehensive guide on how to get started with GitHub Pages.

Before we dive into the steps, ensure you have a GitHub account. If not, sign up at github.com, and then follow these instructions:

Setting up Your Personal GitHub Site

GitHub Pages allows you to create and host your own personal website for free. It's perfect for portfolios, blogs, or even simple factual websites.

AD
How to Host a Website for Free Using GitHub Pages
How to Host a Website for Free Using GitHub Pages
How to Get Started With GitHub in 2026 and Build Real Projects Fast
How to Get Started With GitHub in 2026 and Build Real Projects Fast
How to Set Up a Website
How to Set Up a Website

First, let's name your GitHub user site. A typical GitHub user page looks like this: username. Replace 'username' with your actual GitHub username.

Step 1: Create a Repository for Your Site

To create a GitHub Pages site, you need to create a repository with a specific name. Here's how:

Follow the Steps Outlined in This Guide to Set Up Your GitHub Repository As Web Page,
Follow the Steps Outlined in This Guide to Set Up Your GitHub Repository As Web Page,
Modern GitHub Profile UI
Modern GitHub Profile UI
  1. Log in to your GitHub account.
  2. Click on the '+' symbol in the top-right corner, then select 'New repository'.
  3. Name your repository 'username'.github.io (replace 'username' with your actual GitHub username).
  4. Click on 'Create repository'.

Initially, the repository is empty. Now let's add some content to it.

Step 2: Add Your Site Content

You can add plain text files, markdown files, or even HTML files to your repository. Here's how to create and add a simple HTML file:

AD
  1. Click on the 'Create new file' button in your repository.
  2. Name your file 'index.html'.
  3. Add the following simple HTML code into the file:
  <!DOCTYPE html>
  <html lang="en">
  <head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My GitHub Pages Site</title>
  </head>
  <body>
  <h1>Welcome to my GitHub Pages site!</h1>
  </body>
  </html>

Then, click on 'Commit new file'.

Linking Your Site to GitHub Pages

After creating your site content, you need to link it to GitHub Pages. Follow these steps:

Step 3: Initialize Git and Push Your Content

Before you can link your site to GitHub Pages, you need to initialize Git in your local repository and push your content to the remote GitHub repository.

AD

To do this, navigate to your repository directory on your local machine via the terminal. Then type:

git init
git add -A
git commit -m "Initial commit"

Then, connect your local repository to your GitHub repository:

git remote add origin https://github.com/username/username.github.io.git
git push -u origin main

Replace 'username' with your actual GitHub username.

AD

Step 4: Set Up GitHub Pages

Finally, go to your repository on GitHub. On the right-hand side, you'll see a 'Settings' button. Click on it and scroll down to the 'GitHub Pages' section. You should see your content listed under the 'Source' option. Check 'main' branch and save.

After a few minutes, your site should be live at https://username.github.io/.

You've now successfully created and linked your GitHub Pages site. Don't hesitate to explore themes, markdown files, and other ways to make your website more professional and engaging. Happy coding!

AD