Github website deployment

[brookssarah789-jpg]

Select Topic Area

Question

Body

Hi, I am trying to publish a website off of github pages transfered from another website (lovable). DNS has gone through according to NAMECHEAP to make a custom domain. Still showing blank screen when I load the website. I'm pretty new to github and coding and not sure what else to try, to troubleshoot if anyone has any ideas or advice. Thanks!

[MrConsoleka]

Hi! Since you are seeing a blank screen instead of a browser error, your DNS settings are likely fine. This usually happens when the index.html loads, but it fails to find the connected JavaScript or CSS files due to path issues.

Open your browser console (press F12 or Right Click -> Inspect -> Console). If you see a bunch of red 404 errors, that confirms it.

Two quick things that usually fix this for exported sites:

1. Add an empty file named .nojekyll to the root of your repository. GitHub ignores folders starting with an underscore (common in many builds) unless you have that file.
2. Check if your index.html is actually in the main folder (root) of the repo, and not nested inside another folder.

[brookssarahpt]

thank you! I just tried both of these and it still didnt work. Any other ideas?

[MazenShalaby]

Hi 👋
A blank screen on GitHub Pages is usually related to one of these issues. You can check them step by step:

1️⃣ Repository & Branch

Make sure GitHub Pages is enabled from Settings → Pages

Confirm the correct branch is selected (main or gh-pages)

If your site is in a subfolder, make sure the root folder is correct

2️⃣ index.html

GitHub Pages requires an index.html file at the root of the published folder

File name must be exactly index.html (case-sensitive)

3️⃣ Custom Domain (DNS)

Verify that:

CNAME file exists in the repo and contains only your domain (e.g. example.com)

DNS records are correct:

A records → GitHub Pages IPs

or CNAME pointing to username.github.io

DNS propagation can take up to 24–48 hours even if Namecheap says it’s complete

4️⃣ Relative Paths

If the site was transferred from another platform, check CSS/JS paths

Absolute paths (/assets/...) often cause blank pages on GitHub Pages

5️⃣ Browser DevTools

Open DevTools → Console & Network tab

Look for 404 errors or JS errors (they usually explain the blank screen)

If you want, share:

Repo link

Domain name

Screenshot of Pages settings

Happy to help 👍