How to deploy my HTML website using GitHub Pages?

[rudushi4]

Select Topic Area

Show & Tell

Body

Hello everyone!

I'm creating my first personal website using just HTML and CSS. I’ve written the code on my mobile using Acode Editor and I’m trying to deploy it using GitHub Pages.

Here’s what I’ve done so far:

• Created a new repository named rudushi-site
• Uploaded index.html to the root
• Went to Settings → Pages → Set source to main branch

However, my site is not showing up yet. Am I missing any steps?
Also, any tips on improving mobile workflow or adding CSS animation would be appreciated.

Thank you in advance!

— Maria Rudushi

[ainstarc]

How to deploy your HTML website using GitHub Pages

1. Create a GitHub repository

   • Go to GitHub and create a new repository (public or private).
   • Name it anything you like.

2. Add your website files

   • Upload your HTML, CSS, JavaScript, and other website files to the repository.
   • Make sure your main HTML file is named index.html.

3. Push your code to GitHub

   • If working locally, commit and push your files to the repository’s default branch (main or master).

4. Enable GitHub Pages

   • Go to your repository on GitHub.
   • Click on the Settings tab.
   • Scroll down to the Pages section.
   • Under Source, select the branch you want to serve your site from (main or master).
   • Select the folder to serve from, usually /root (or /docs if your site files are in a docs folder).
   • Click Save.
   • Wait a few minutes for GitHub to build and deploy your site.

   

5. Access your website

   • GitHub will build and deploy your site.
   • After a few minutes, your site will be available at:
     • https://<your-username>.github.io/<repository-name>/ (for project pages) or
     • https://<your-username>.github.io/ (if your repo is named <your-username>.github.io).

6. Important: Ensure index.html exists
   It appears none of your repositories currently have an index.html file. GitHub Pages requires this file as the entry point for your website. Without it, the site will not display correctly or may show a 404 error.

   To fix this:

   • Add an index.html file to the root or the selected folder of your repo.
   • Commit and push the changes.
   • Wait a few minutes for the site to update.

   

7. Optional: Use a custom domain

   • You can configure a custom domain in the GitHub Pages settings if you have one.

---

If you need help creating a basic index.html or have any other questions, feel free to ask!

[github-actions[bot]]

🕒 Discussion Activity Reminder 🕒

This Discussion has been labeled as dormant by an automated system for having no activity in the last 60 days. Please consider one the following actions:

1️⃣ Close as Out of Date: If the topic is no longer relevant, close the Discussion as out of date at the bottom of the page.

2️⃣ Provide More Information: Share additional details or context — or let the community know if you've found a solution on your own.

3️⃣ Mark a Reply as Answer: If your question has been answered by a reply, mark the most helpful reply as the solution.

Note: This dormant notification will only apply to Discussions with the Question label. To learn more, see our recent announcement.

Thank you for helping bring this Discussion to a resolution! 💬