Step 1: Create Your GitHub Account
 

To host your website on GitHub Pages, you first need a GitHub account.

• Open your browser and go to https://github.com/
• Click the Sign up button in the top-right corner
• Enter a valid email address, choose a username and password
• Complete any additional verification steps (captcha, email confirmation)

 
Step 2: Install Git on Your Local Machine
 

Git is the version control system that lets you push your code to GitHub.

• On Windows, download and install from https://git-scm.com/download/win
• On macOS, use Homebrew: install Homebrew first if needed, then run:

  
  brew install git
      

• On Linux, use your package manager, for example on Ubuntu:

  
  sudo apt update
  sudo apt install git
      

• Verify installation:

  
  git --version
      

 
Step 3: Create a New Repository for Your Website
 

Your repository will host the HTML, CSS, and assets for your site.

• Log in to GitHub and click the + New repository button
• Set the repository name to your-username.github.io (replace “your-username” accordingly)
• Add a description (optional)
• Choose Public visibility
• Do not initialize with a README (we’ll add files locally)
• Click Create repository

 
Step 4: Clone the Repository Locally
 

Clone the empty repository to create a local folder for your files.

• Open a terminal or command prompt
• Navigate to the directory where you want your project:

  
  cd /path/to/projects
      

• Clone your repo:

  
  git clone https://github.com/your-username/your-username.github.io.git
      

• Enter the project folder:

  
  cd your-username.github.io
      

 
Step 5: Create Your Website Files
 

Start with a basic HTML and optional CSS file.

• Create an index.html file:

  
  
  
  
    
    
    
    
  
  
    
  
      
  Welcome to My GitHub Pages Site
    
    
  
      
  This is a simple website hosted with GitHub Pages.
    
    
  
  
      

• Create a style.css file for basic styling:

  
  body {
    font-family: Arial, sans-serif;
    margin: 0;
    padding: 0;
    text-align: center;
  }
  header {
    background-color: #24292e;
    color: #ffffff;
    padding: 1rem;
  }
  main {
    padding: 2rem;
  }
  footer {
    background-color: #f6f8fa;
    padding: 1rem;
  }
      

 
Step 6: Commit and Push Your Changes
 

Use Git commands to save and publish your website files.

• Stage all new files:

  
  git add .
      

• Create a commit with a message:

  
  git commit -m "Initial website setup"
      

• Push to the main branch on GitHub:

  
  git push origin main
      

 
Step 7: Enable GitHub Pages
 

Tell GitHub to serve your site from the repository.

• Go to your repository on GitHub
• Click on Settings in the top menu
• In the left sidebar, click Pages
• Under Source, select Branch: main and folder / (root)
• Click Save
• Wait a minute—GitHub will provide a URL like https://your-username.github.io/

 
Step 8: View and Update Your Website
 

After a short build time, your site is live.

• Open the provided URL in your browser
• To make updates, edit files locally, then repeat git add ., git commit, and git push
• Refresh your browser to see changes instantly