I followed the GitHub documentation to create a custom 404 page( 404.html at the root ) for my GitHub Pages site, but it's not working.

[JohnYang02182]

Select Topic Area

Question

Body

Problem:
I used Vite4 to bundle my code and deployed it to the GitHub page( custom domain ), and when I reloaded the page( except the index page ), it was then redirected to the 404 page. I have followed the GitHub documentation to create a custom 404 page, and it is still not working.

Mode: history mode.
Build and deployment: GitHub Actions.

Vite version: 4.3.5
Vue: 3.3.2

I would appreciate it if someone could tell me how to fix this issue.

[adydeeram]

Hey @JohnYang02182. I see your frustration with the redirection issue on GitHub Pages using Vite4. Since you've followed GitHub's custom 404 page setup and are encountering problems when reloading pages other than the index, consider these steps:

• Confirm your base URL in Vite config matches your GitHub Pages repository path.

• Ensure correct settings for custom domain and HTTPS in GitHub repository settings.

• Verify your custom 404 page is named 404.html and in the repository root.

• Add fallback: 'index.html' in Vite's server configuration.

• Check for in your HTML template.

• Use relative, not absolute, paths for links and assets.

• Double-check Vite and Vue compatibility.

These measures should help address your redirection issue. If problems persist, feel free to share specific code snippets for further assistance.

[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! 💬

[JohnYang02182]

I have found the solution. Thanks for your replication.

[emartinez-dev]

How did you finally solve it? It could be useful for everyone here