Hosting Codex-Created HTML files on Github Pages

Overview

This guide walks faculty through:

• Creating a GitHub account (using Google sign-in)

• Uploading a single HTML file generated by Codex

• Publishing it live using GitHub Pages

No command line or Git experience is required.

Step 1: Create a GitHub Account

1. Go to: https://github.com

2. Click Sign up

3. Choose “Continue with Google” (recommended)

4. Complete the prompts:

   • Username (this becomes part of your website URL)

   • Email (auto-filled from Google)

   • Password (if prompted)

5. Verify your account if required

Once finished, you’ll land on your GitHub dashboard

Step 2: Create a New Repository

1. Click the “+” (top right) → New repository

2. Fill in:

   • Repository name: choose something simple (e.g., biology-module-1)

   • Visibility: Public (required for free GitHub Pages)

3. Click Create repository

Step 3: Upload Your HTML File

1. On the new repository page, click:

   • “Add file” → “Upload files”

2. Drag and drop your HTML file

⚠️ Important:

• The file must be named index.html

• File name is case-sensitive (Index.html will NOT work)

3. Scroll down and click Commit changes

Step 4: Enable GitHub Pages

1. Click the Settings tab in your repository

2. In the left sidebar, click Pages

3. Under Build and deployment → Source:

   • Branch: main

   • Folder: / (root)

4. Click Save

Step 5: Access Your Live Site

After ~30–60 seconds, your site will be available at:

https://<your-username>.github.io/<repository-name>/

Example:

https://jdoe.github.io/biology-module-1/ 

Once you have the link to your new site, you can publish this link to Canvas. 

Common Issues & Fixes

Tips

• You can update your module anytime by re-uploading a new index.html

• Each repository = one published module

• Keep repository names short and readable for cleaner URLs