My react website on GitHub Pages shows blank white screen

[velaragirlgroup]

🏷️ Discussion Type

Question

💬 Feature/Topic Area

Code Search and Navigation

Body

Manus AI app created a website for me. i downloaded the zip folder from manus AI app and extracted it. i uploaded some of those files to github repository: https://github.com/velaragirlgroup/official. I made changes to the folder: client/src/pages/Home.txs. My site at https://velaragirlgroup.github.io/official/ shows only a blank white screen. The build is green in GitHub Actions but nothing displays. My website on GitHub shows blank white screen.

i asked copilot chatgpt to help me but nothing has changed. AI cant help me at all and im stuck. im completely new to this and dont know how to handle these things. i really want this website to work: https://velaragirlgroup.github.io/official/. will anyone please help out?

[vishalvivek14332-source]

A blank white page with a successful Pages build usually means the React app is throwing a JavaScript error at runtime or is using incorrect asset/router paths for deployment under /official/.

The first thing I would do is open the browser's Developer Tools (F12) and check the Console and Network tabs for 404s or JavaScript errors. For React apps hosted in a repository subdirectory, you typically need to configure the app's base path (for example, base in Vite or homepage in Create React App) to /official/ and rebuild/redeploy. Also double-check that the file you edited is really Home.tsx (not Home.txs) and that all imports still resolve correctly.

If you can share the exact console error message (or a screenshot of it), it should be possible to pinpoint the issue quickly.

[velaragirlgroup]

i checked and i edited Home.tsx: https://github.com/velaragirlgroup/official/blob/main/client/src/pages/Home.tsx. if you look at the top side of the blank white page, its written "Velara - Official Website" but nothing is showing. The website is still white: https://velaragirlgroup.github.io/official/. you said that i need to configure the apps base path, i actually dont know what that means because manus ai created the website. will you please help

[mohamedosama2004]

A blank white screen with a successful GitHub Actions build usually means the app is loading but failing at runtime.

A few things to check:

Open Developer Tools (F12) → Console and see if there are any JavaScript errors.
Open the Network tab and check if any JS or CSS files return 404.
If this is a React + Vite project deployed to GitHub Pages, make sure vite.config.ts contains:
export default defineConfig({
base: "/official/",
})
If it's Create React App, make sure package.json includes:
"homepage": "https://velaragirlgroup.github.io/official/"
Verify that GitHub Pages is serving the correct build output (dist or build) rather than the source files.

If you can share the repository structure (especially package.json, vite.config.ts, or webpack config), it'll be much easier to identify the exact cause.

[velaragirlgroup]

hello package.json is inside the folder called client. here is the link: https://github.com/velaragirlgroup/official/blob/main/client/package.json Regarding vite.config.ts and webpack config, i dont know where they are. My repository is https://github.com/velaragirlgroup/official

[Mr-Nilarnab]

@velaragirlgroup

Since you're new to React and GitHub Pages, I'd suggest taking a step back and first determining whether the problem is with the deployment or with the application itself. A blank white page can be caused by several different issues that all look identical from the browser.

Here's a simple way to narrow it down:

1. Open your website and press F12 to open Developer Tools.
2. Check the Console tab:
   • Red error messages usually indicate that the application crashed while loading.
   • Copy the first error you see, as later errors are often just consequences of the first one.
3. Check the Network tab and refresh the page:
   • If JavaScript or CSS files return 404, the deployment path is likely incorrect.
   • If all assets load successfully but the page is still blank, the problem is probably inside the React application.
4. Verify that the branch GitHub Pages is publishing matches the output of your build (for example, the generated dist or build folder rather than the source files).

Because you mentioned that the project was generated by Manus AI, there's another possibility: the generated project may rely on environment variables, APIs, or configuration files that weren't included when you downloaded the ZIP. In that case, the project can build successfully but fail immediately when it starts in the browser.

If you're comfortable sharing a few additional files, the community can usually identify the issue much more quickly. The most helpful ones would be:

• package.json
• vite.config.ts or vite.config.js (if present)
• tsconfig.json (if present)
• A screenshot of the browser Console showing the first error
• The repository's file tree (or a screenshot of it)

Those details would help determine whether this is a GitHub Pages configuration issue, a React runtime error, or a missing project dependency.

[velaragirlgroup]

hey it seems that i did not upload these files: vite.config.ts/js and tsconfig.json. i just uploaded them and waited 10 minutes but the website is still white. but here is link and screenshot of package.json: https://github.com/velaragirlgroup/official/blob/main/client/package.json

i found a file called vite.config on my laptop and uploaded it, it changed to vite.config.ts. here is the link: https://github.com/velaragirlgroup/official/blob/main/vite.config.ts

i found tsconfig.json and uploaded it as well: https://github.com/velaragirlgroup/official/blob/main/tsconfig.json

i managed to upload vite.config.ts and tsconfig.json but still no change. i double-clicked on white page and selected 'inspect' and chose 'console'. i see red errors. here is the screenshot:

But i went to Actions on github but there are green marks

here is a screenshot of all the files i uploaded:

here is whats in the client folder:

Are there still files i need to upload?