Skip to content

Configure Astro Starlight i18n: English default, French as first additional locale#17840

Closed
Copilot wants to merge 2 commits intomainfrom
copilot/configure-localization-support
Closed

Configure Astro Starlight i18n: English default, French as first additional locale#17840
Copilot wants to merge 2 commits intomainfrom
copilot/configure-localization-support

Conversation

Copy link
Contributor

Copilot AI commented Feb 23, 2026

Adds multi-language support to the Astro Starlight docs site, with English as the default/fallback and French as the first additional locale.

Changes

  • docs/astro.config.mjs: Adds defaultLocale: 'root' and a locales block to the Starlight config:
defaultLocale: 'root',
locales: {
    root: {
        label: 'English',
        lang: 'en',
    },
    fr: {
        label: 'Français',
        lang: 'fr',
    },
},

Using root as the default locale keeps English served from root URLs (e.g., /setup/quick-start/) — no file moves, no broken links. French content lives under /fr/; until translations are added to src/content/docs/fr/, Starlight falls back to English automatically.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Configure Astro to support localization for multiple languages. English is the default and the full fallback language. Add French as the first additional language.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…lt and French

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Configure Astro for localization with English and French support Configure Astro Starlight i18n: English default, French as first additional locale Feb 23, 2026
@pelikhan pelikhan closed this Feb 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants