Skip to content

ENABLE_GITHUB_PAGES.md

Latest commit

 

History

History
112 lines (71 loc) · 2.65 KB

ENABLE_GITHUB_PAGES.md

File metadata and controls

112 lines (71 loc) · 2.65 KB

🚀 How to Enable GitHub Pages

Current Status: 404 Error

You're seeing a 404 because GitHub Pages is not enabled yet. This is a one-time setup that takes 2 minutes.

✅ Step-by-Step Guide

Step 1: Go to Repository Settings

Click this link: https://github.com/amrpyt/solar-panel-website-demo/settings/pages

Or manually:

  1. Go to your repository: https://github.com/amrpyt/solar-panel-website-demo
  2. Click "Settings" tab (top right)
  3. Click "Pages" in the left sidebar

Step 2: Configure Source

Under "Build and deployment" section:

  1. Find the "Source" dropdown
  2. Click it and select "GitHub Actions"
    • ⚠️ NOT "Deploy from a branch"
    • ⚠️ Must be "GitHub Actions"
  3. Click "Save" button

Step 3: Wait for Deployment

  1. A green banner will appear saying "GitHub Pages source saved"
  2. Wait 1-2 minutes for the workflow to deploy
  3. You can watch progress at: https://github.com/amrpyt/solar-panel-website-demo/actions

Step 4: Visit Your Site

Once deployed, your site will be live at:

https://amrpyt.github.io/solar-panel-website-demo/

🎯 What You'll See

After enabling, the site will have:

  • ✅ Home page with hero section
  • ✅ About page
  • ✅ Services page
  • ✅ Blog page
  • ✅ Contact page
  • ✅ Working navigation
  • ✅ CMS at /admin

❓ Why Is This Needed?

  • GitHub Pages is disabled by default for security
  • The workflow is ready and configured
  • It just needs permission to deploy
  • This is a one-time setup
  • Only repository owners can enable it

🔧 Troubleshooting

If you still see 404 after enabling:

  1. Check the workflow: https://github.com/amrpyt/solar-panel-website-demo/actions

    • Make sure the latest workflow succeeded (green checkmark)

  2. Wait a bit longer: Sometimes it takes 2-3 minutes

  3. Hard refresh: Press Ctrl+Shift+R (or Cmd+Shift+R on Mac)

  4. Check Pages settings: Make sure "Source" is set to "GitHub Actions"

📝 After It's Live

Once the site is live, you can:

  1. View the website: https://amrpyt.github.io/solar-panel-website-demo/
  2. Access the CMS: https://amrpyt.github.io/solar-panel-website-demo/admin
  3. Make changes: Any push to main branch auto-deploys
  4. Manage content: Use the CMS to add blog posts, projects, etc.

🎉 Summary

What you need to do:

  1. Go to Settings → Pages
  2. Source → GitHub Actions
  3. Click Save
  4. Wait 1-2 minutes
  5. Visit the site!

Direct link to settings: https://github.com/amrpyt/solar-panel-website-demo/settings/pages

Everything is ready - just needs this one click to enable! 🚀