Private documentation with auth or jwt token check

[alexstock1]

What version of starlight are you using?

4.0.0

What is your idea?

I have a commercial product and would like to implement the capability to authenticate by JWT tokens. This would enable users to access the documentation only after a successful check with the token

Why is this feature necessary?

Since the documentation is private and should not be publicly available I would like to add this check

Do you have examples of this feature in other projects?

No response

Participation

• I am willing to submit a pull request for this feature.

[dealmengor]

are you able to implement this?

[delucis]

Sharing a link to a new template for Starlight + authentication built by @TheOtterlord: https://github.com/TheOtterlord/starlight-auth

[adrianAzoitei]

Was anyone able to run starlight-auth with node? Seems to work as expected on Vercel, but I cannot get it to run on Node yet. Tried compiling server/indext.ts but couldn't figure it out yet.

[Fryuni]

starlight-auth uses a Vercel edge middleware for the auth on docs pages. To do it in Node, you'd need to build your Astro project to Node in middleware mode, write your own Node server doing the auth, and forward it to the Astro project if it passes.

[HiDeoo]

Sharing a new example I created that uses the Better Auth library to handle user authentication: users can create an account, sign in, and sign out — some pages are protected and require the user to be authenticated to access them or even be visible in the documentation sidebar.