withastro · HiDeoo · Nov 14, 2025 · Nov 18, 2025 · Nov 18, 2025 · Nov 18, 2025
diff --git a/.changeset/fresh-ads-sneeze.md b/.changeset/fresh-ads-sneeze.md
@@ -0,0 +1,7 @@
+---
+'@astrojs/starlight': minor
+---
+
+Removes the `tagline` configuration option, which was never used.
+
+If your configuration included a `tagline` option, you can safely remove it without any replacement.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -35,6 +35,9 @@ jobs:
       - name: Install Dependencies
         run: pnpm i
 
+      - name: Build Packages
+        run: pnpm run build
+
       - name: Create Release Pull Request
         uses: changesets/action@6a0a831ff30acef54f2c6aa1cbbc1096b066edaf # v1.7.0
         with:

diff --git a/.prettierignore b/.prettierignore
@@ -17,10 +17,10 @@ pnpm-lock.yaml
 **/__tests__/**/snapshots
 
 # https://github.com/withastro/prettier-plugin-astro/issues/337
-packages/starlight/user-components/Tabs.astro
+packages/starlight/src/user-components/Tabs.astro
 
 # Prettier forces whitespace between elements we want to avoid for consistency with the rehype version
-packages/starlight/components/AnchorHeading.astro
+packages/starlight/src/components/AnchorHeading.astro
 packages/starlight/__e2e__/fixtures/basics/src/content/docs/anchor-heading-component.mdx
 
 # Malformed YAML file used for testing

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -228,7 +228,7 @@ Check out the dedicated [i18n contribution guidelines](https://contribute.docs.a
 
 Starlight’s UI comes with some built-in text elements. For example, the table of contents on a Starlight page has a heading of “On this page” and the theme picker shows “Light”, “Dark”, and “Auto” labels. Starlight aims to provide these in as many languages as possible.
 
-Help out by adding or updating translation files in [`packages/starlight/translations`](./packages/starlight/translations/).
+Help out by adding or updating translation files in [`packages/starlight/src/translations`](./packages/starlight/src/translations/).
 Each language’s JSON file follows the [translation structure described in Starlight’s docs](https://starlight.astro.build/guides/i18n/#translate-starlights-ui).
 
 📺 **Prefer a visual walkthrough?** [Watch an introduction to Starlight’s translation files.](https://scrimba.com/scrim/cpb44bt3)
@@ -262,14 +262,14 @@ To add a language, you will need its BCP-47 tag and a label. See [“Adding a ne
 - Starlight is built as an Astro integration.
   Read the [Astro Integration API docs][api-docs] to learn more about how integrations work.
 
-  The Starlight integration is exported from [`packages/starlight/index.ts`](./packages/starlight/index.ts).
+  The Starlight integration is exported from [`packages/starlight/src/index.ts`](./packages/starlight/src/index.ts).
   It sets up Starlight’s routing logic, parses user config, and adds configuration to a Starlight user’s Astro project.
 
-- Most pages in a Starlight project are built using a single [`packages/starlight/index.astro`](./packages/starlight/index.astro) route.
+- Most pages in a Starlight project are built using a single [`packages/starlight/src/routes/common.astro`](./packages/starlight/src/routes/common.astro) route.
   If you’ve worked on an Astro site before, much of this should look familiar: it’s an Astro component and uses a number of other components to build a page based on user content.
 
 - Starlight consumes a user’s content from the `'docs'` [content collection](https://docs.astro.build/en/guides/content-collections/).
-  This allows us to specify the permissible frontmatter via [a Starlight-specific schema](./packages/starlight/schema.ts) and get predictable data while providing clear error messages if a user sets invalid frontmatter in a page.
+  This allows us to specify the permissible frontmatter via [a Starlight-specific schema](./packages/starlight/src/schema.ts) and get predictable data while providing clear error messages if a user sets invalid frontmatter in a page.
 
 - Components that require JavaScript for their functionality are all written without a UI framework, most often as custom elements.
   This helps keep Starlight lightweight and makes it easier for a user to choose to add components from a framework of their choice to their project.

diff --git a/docs/package.json b/docs/package.json
@@ -9,7 +9,6 @@
     "start": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
-    "typecheck": "tsc --noEmit",
     "linkcheck": "CHECK_LINKS=true pnpm build",
     "astro": "astro",
     "lunaria:build": "lunaria build",

diff --git a/docs/src/components/icons-list.astro b/docs/src/components/icons-list.astro
@@ -1,6 +1,6 @@
 ---
 import { Icon } from '@astrojs/starlight/components';
-import { Icons, type StarlightIcon } from '../../../packages/starlight/components-internals/Icons';
+import { Icons, type StarlightIcon } from '../../../packages/starlight/src/components-internals/Icons';
 
 interface Props {
 	labels?: {

diff --git a/docs/src/components/languages-list.astro b/docs/src/components/languages-list.astro
@@ -1,6 +1,6 @@
 ---
 import { getEntry } from 'astro:content';
-import translations from '../../../packages/starlight/translations';
+import translations from '../../../packages/starlight/src/translations';
 
 interface Props {
 	startsSentence?: boolean;

diff --git a/docs/src/components/sidebar-preview.astro b/docs/src/components/sidebar-preview.astro
@@ -3,10 +3,10 @@ import type {
 	AutoSidebarGroup,
 	SidebarItem,
 	InternalSidebarLinkItem,
-} from '../../../packages/starlight/schemas/sidebar';
-import SidebarSublist from '../../../packages/starlight/components/SidebarSublist.astro';
-import type { Badge } from '../../../packages/starlight/schemas/badge';
-import type { SidebarEntry } from '../../../packages/starlight/utils/routing/types';
+} from '../../../packages/starlight/src/schemas/sidebar';
+import SidebarSublist from '../../../packages/starlight/src/components/SidebarSublist.astro';
+import type { Badge } from '../../../packages/starlight/src/schemas/badge';
+import type { SidebarEntry } from '../../../packages/starlight/src/utils/routing/types';
 
 interface Props {
 	config: SidebarConfig;

diff --git a/docs/src/components/ui-strings-list.astro b/docs/src/components/ui-strings-list.astro
@@ -1,6 +1,6 @@
 ---
 import { Code } from '@astrojs/starlight/components';
-import uiStrings from '../../../packages/starlight/translations/en.json?raw';
+import uiStrings from '../../../packages/starlight/src/translations/en.json?raw';
 ---
 
 <Code code={uiStrings} lang="json" />
diff --git a/docs/src/content/docs/components/asides.mdx b/docs/src/content/docs/components/asides.mdx
@@ -164,7 +164,7 @@ A tip aside *with* a custom icon.
 
 ## `<Aside>` Props
 
-**Implementation:** [`Aside.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Aside.astro)
+**Implementation:** [`Aside.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Aside.astro)
 
 The `<Aside>` component accepts the following props:
 

diff --git a/docs/src/content/docs/components/badges.mdx b/docs/src/content/docs/components/badges.mdx
@@ -125,7 +125,7 @@ import { Badge } from '@astrojs/starlight/components';
 
 ## `<Badge>` Props
 
-**Implementation:** [`Badge.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Badge.astro)
+**Implementation:** [`Badge.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Badge.astro)
 
 The `<Badge>` component accepts the following props and also any [other `<span>` attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes):
 

diff --git a/docs/src/content/docs/components/card-grids.mdx b/docs/src/content/docs/components/card-grids.mdx
@@ -162,7 +162,7 @@ More information you want to share.
 
 ## `<CardGrid>` Props
 
-**Implementation:** [`CardGrid.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/CardGrid.astro)
+**Implementation:** [`CardGrid.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/CardGrid.astro)
 
 The `<CardGrid>` component accepts the following props:
 

diff --git a/docs/src/content/docs/components/cards.mdx b/docs/src/content/docs/components/cards.mdx
@@ -90,7 +90,7 @@ See the [“Group cards”](/components/card-grids/#group-cards) guide for an ex
 
 ## `<Card>` Props
 
-**Implementation:** [`Card.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Card.astro)
+**Implementation:** [`Card.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Card.astro)
 
 The `<Card>` component accepts the following props:
 

diff --git a/docs/src/content/docs/components/file-tree.mdx b/docs/src/content/docs/components/file-tree.mdx
@@ -260,6 +260,6 @@ import { FileTree } from '@astrojs/starlight/components';
 
 ## `<FileTree>` Props
 
-**Implementation:** [`FileTree.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/FileTree.astro)
+**Implementation:** [`FileTree.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/FileTree.astro)
 
 The `<FileTree>` component does not accept any props.
diff --git a/docs/src/content/docs/components/icons.mdx b/docs/src/content/docs/components/icons.mdx
@@ -88,7 +88,7 @@ import { Icon } from '@astrojs/starlight/components';
 
 ## `<Icon>` Props
 
-**Implementation:** [`Icon.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Icon.astro)
+**Implementation:** [`Icon.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Icon.astro)
 
 The `<Icon>` component accepts the following props:
 

diff --git a/docs/src/content/docs/components/link-buttons.mdx b/docs/src/content/docs/components/link-buttons.mdx
@@ -112,7 +112,7 @@ Related: Astro
 
 ## `<LinkButton>` Props
 
-**Implementation:** [`LinkButton.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkButton.astro)
+**Implementation:** [`LinkButton.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/LinkButton.astro)
 
 The `<LinkButton>` component accepts the following props and also any [other `<a>` attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a):
 

diff --git a/docs/src/content/docs/components/link-cards.mdx b/docs/src/content/docs/components/link-cards.mdx
@@ -100,7 +100,7 @@ See the [“Group link cards”](/components/card-grids/#group-link-cards) guide
 
 ## `<LinkCard>` Props
 
-**Implementation:** [`LinkCard.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/LinkCard.astro)
+**Implementation:** [`LinkCard.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/LinkCard.astro)
 
 The `<LinkCard>` component accepts the following props, as well as all other [`<a>` element attributes](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a):
 

diff --git a/docs/src/content/docs/components/steps.mdx b/docs/src/content/docs/components/steps.mdx
@@ -115,6 +115,6 @@ import { Steps } from '@astrojs/starlight/components';
 
 ## `<Steps>` Props
 
-**Implementation:** [`Steps.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Steps.astro)
+**Implementation:** [`Steps.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Steps.astro)
 
 The `<Steps>` component does not accept any props.
diff --git a/docs/src/content/docs/components/tabs.mdx b/docs/src/content/docs/components/tabs.mdx
@@ -191,7 +191,7 @@ Io, Europa, Ganymede
 
 ## `<Tabs>` Props
 
-**Implementation:** [`Tabs.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/Tabs.astro)
+**Implementation:** [`Tabs.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/Tabs.astro)
 
 The `<Tabs>` component groups multiple `<TabItem>` components together and accepts the following props:
 
@@ -203,7 +203,7 @@ A key used to keep multiple tab groups synchronized across multiple pages.
 
 ## `<TabItem>` Props
 
-**Implementation:** [`TabItem.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/user-components/TabItem.astro)
+**Implementation:** [`TabItem.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/src/user-components/TabItem.astro)
 
 A set of tabs is composed of tab items, each with the following props:
 

diff --git a/docs/src/content/docs/guides/css-and-tailwind.mdx b/docs/src/content/docs/guides/css-and-tailwind.mdx
@@ -48,7 +48,7 @@ Customize the styles applied to your Starlight site by providing additional CSS
 
 </Steps>
 
-You can see all the CSS custom properties used by Starlight that you can set to customize your site in the [`props.css` file on GitHub](https://github.com/withastro/starlight/blob/main/packages/starlight/style/props.css).
+You can see all the CSS custom properties used by Starlight that you can set to customize your site in the [`props.css` file on GitHub](https://github.com/withastro/starlight/blob/main/packages/starlight/src/style/props.css).
 
 ### Cascade layers