Base path support

[patryk-smc]

What version of starlight are you using?

0.16.0

What is your idea?

I already have a marketing page to which I want to add Starlight-powered docs under /docs path.

I worked around this by patching Starlight package with the following patch:

node_modules/@astrojs/starlight/components/SidebarSublist.astro
- href={entry.href}
+ href={"/docs" + entry.href}

node_modules/@astrojs/starlight/components/SiteTitle.astro
- const href = formatPath(Astro.props.locale || '/');
+ const href = formatPath(Astro.props.locale || '/docs');

node_modules/@astrojs/starlight/index.ts
- pattern: '[...slug]',
+ pattern: 'docs/[...slug]',

Why is this feature necessary?

Without it it's hard to integrate Starlight with existing site

Do you have examples of this feature in other projects?

No response

Participation

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

[delucis]

Hi @patryk-smc — thanks for the post!

Just double checking you’ve seen some related links:

• “Use Starlight at a subpath” docs section
• Improved support for serving Starlight docs from a custom subpath #966 discussion

In fact, I’d say this probably a duplicate of that discussion there, so if it’s OK with you, I’ll close this as a duplicate 🙌