404 due to redirect

[lazarusA]

Hello again. I'm looking for some advice or hints on the following issue.
Our workflow depends on vitepress and we are setting cleanUrls: true if that's relevant.

The issue:

https://luxdl.github.io/DocumenterVitepress.jl/stable/ (show the right landing page, flickers and then gives 404 error)
https://luxdl.github.io/DocumenterVitepress.jl/dev/ (this one works) and all versioned options also work. Only this redirect is the issue.

Maybe also relevant the corresponding redirect files:

https://github.com/LuxDL/DocumenterVitepress.jl/blob/gh-pages/index.html
https://github.com/LuxDL/DocumenterVitepress.jl/blob/gh-pages/stable

and ideas or suggestions will be very helpful.

[brc-dd]

GitHub pages don't support cleanUrls for that particular case. You'll need to use some other hosting provider if you want to avoid that. (#3468 (comment) -- although in your case it's not changing url 👀 )

[brc-dd]

DocumenterVitepress-v0.0.14.tar.gz

This too doesn't have structure similar to your gh-pages branch:

Can you just set DEBUG on your CI and deploy once?

What's the best way to serve build output to the browser?

You'll need to rename your output dir to your base (DocumenterVitepress.jl) and go to its parent and run npx serve there.

[asinghvi17]

Ah this is the source code which you would run npm run docs:build on.

In a few minutes a preview build with DEBUG=true should be up at https://luxdl.github.io/previews/PR88. I will also deploy a tagged build asap!

[brc-dd]

This is the commit that broke it - LuxDL/DocumenterVitepress.jl@27dc4e6 - not sure why though 👀

[lazarusA]

Ok. After more debugging. We know that the failure is do to:

• an Hydration error (it might be do to the vue component we have on the sites not working, failing to 404). But, not a 100%, we have site without it, with the same error (https://rafaqz.github.io/DimensionalData.jl/stable/) but same redirect logic.
• and the issue happens when the re-direct is activated.

here This is how we include the component.

Apparently, a possible solution is to use ClientOnly, or maybe this https://vite-plugin-ssr.com/hydration-mismatch#example but not sure how should I modified my component calling.

Or, is there another known solution?

Thanks again, for all the previous tips already given.

[brc-dd]

That component should work fine with SSR. It doesn't have any browser-specific code. Something else is causing the issue.