From b13a2952f741f3f5ce3137c672ac0a156b41c02b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bed=C5=99ich=20Schindler?= <bedrich.schindler@gmail.com>
Date: Wed, 7 Oct 2026 09:44:57 +0200
Subject: [PATCH 1/2] Use relative links in docs and fix broken links (#650)

---
 .claude/rules/docs.md                   |  6 ++---
 src/components/Alert/README.md          | 10 ++++----
 src/components/Badge/README.md          |  8 +++----
 src/components/Button/README.md         | 32 ++++++++++++-------------
 src/components/ButtonGroup/README.md    | 12 +++++-----
 src/components/Card/README.md           | 12 +++++-----
 src/components/CheckboxField/README.md  | 17 ++++++-------
 src/components/FileInputField/README.md | 10 ++++----
 src/components/FormLayout/README.md     | 20 ++++++++--------
 src/components/Grid/README.md           | 14 +++++------
 src/components/InputGroup/README.md     | 16 ++++++-------
 src/components/Modal/README.md          | 20 ++++++++--------
 src/components/Paper/README.md          |  6 ++---
 src/components/Popover/README.md        |  6 ++---
 src/components/Radio/README.md          | 19 ++++++++-------
 src/components/ScrollView/README.md     |  6 ++---
 src/components/SelectField/README.md    | 17 ++++++-------
 src/components/Table/README.md          | 12 +++++-----
 src/components/Tabs/README.md           |  4 ++--
 src/components/Text/README.md           |  6 ++---
 src/components/TextArea/README.md       |  8 +++----
 src/components/TextField/README.md      |  8 +++----
 src/components/TextLink/README.md       | 10 ++++----
 src/components/Toggle/README.md         | 17 ++++++-------
 src/components/Toolbar/README.md        |  8 +++----
 src/docs/contribute/api.md              |  6 ++---
 src/docs/contribute/composition.md      |  2 +-
 src/docs/contribute/css.md              |  6 ++---
 src/docs/css-helpers/box-alignment.md   |  6 ++---
 src/docs/css-helpers/colors.md          |  8 +++----
 src/docs/css-helpers/display.md         |  2 +-
 src/docs/css-helpers/spacing.md         |  4 ++--
 src/docs/customize/font.md              |  2 +-
 src/docs/customize/theming/forms.md     | 22 ++++++++---------
 src/docs/customize/theming/overview.md  |  4 ++--
 src/docs/customize/translations.md      |  4 ++--
 src/docs/foundation/accessibility.md    | 27 +++++++++++----------
 src/docs/foundation/borders.md          |  8 +++----
 src/docs/foundation/colors.md           | 30 ++++++++++++-----------
 src/docs/foundation/design-tokens.md    |  2 +-
 src/docs/foundation/shadows.md          |  8 +++----
 src/docs/foundation/spacing.md          |  5 ++--
 src/docs/foundation/typography.md       |  8 +++----
 src/docs/getting-started/usage.md       | 14 +++++------
 src/index.md                            | 14 +++++------
 45 files changed, 247 insertions(+), 239 deletions(-)

diff --git a/.claude/rules/docs.md b/.claude/rules/docs.md
index 33cf24f02..ad4f73553 100644
--- a/.claude/rules/docs.md
+++ b/.claude/rules/docs.md
@@ -28,9 +28,9 @@ See [Commands](../../CLAUDE.md#commands).
 * Use relative links between docs.
 * Keep theming out of README prose: document it only in the `## Theming` section
   at the end of a component's `README.md`, including examples that override
-  `--rui-*` custom properties. Other sections must not link to
-  `/docs/customize/theming/*` or to `#theming` — downstream design systems drop
-  the whole section when they sync our docs.
+  `--rui-*` custom properties. Other sections must not link to the theming
+  guides (`docs/customize/theming/*.md`) or to `#theming` — downstream design
+  systems drop the whole section when they sync our docs.
 
 ## Reference
 
diff --git a/src/components/Alert/README.md b/src/components/Alert/README.md
index fa277a9d8..8bab92217 100644
--- a/src/components/Alert/README.md
+++ b/src/components/Alert/README.md
@@ -32,7 +32,7 @@ See [API](#api) for all available options.
 ## Color Variants
 
 To cover all possible needs of your project, Alert is available in colors from
-[Feedback color collection](/docs/foundation/collections#colors).
+[Feedback color collection](../../docs/foundation/collections.md#colors).
 
 ### Success
 
@@ -116,7 +116,7 @@ Neutral informative alert.
 An icon can (and should) accompany the message.
 
 👉 Please note there are no icons pre-packed in React UI. Visit
-[Icons](/docs/foundation/icons) to see how it works.
+[Icons](../../docs/foundation/icons.md) to see how it works.
 
 ```docoff-react-preview
 <Alert color="success" icon={<rui-icon icon="success" />}>
@@ -159,8 +159,8 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -195,7 +195,7 @@ convention looks as follows:
 Where:
 
 - `<COLOR>` is a value from supported
-  [color collections](/docs/foundation/collections#colors)
+  [color collections](../../docs/foundation/collections.md#colors)
   (check [color variants](#color-variants) and [API](#api) to see which
   collections are supported),
 - `<PROPERTY>` is one of `color` (color of text), `foreground-color` (color of
diff --git a/src/components/Badge/README.md b/src/components/Badge/README.md
index fea6f3ad1..acda35c10 100644
--- a/src/components/Badge/README.md
+++ b/src/components/Badge/README.md
@@ -30,7 +30,7 @@ lowest:
 2. outline
 
 All priorities are available in colors from supported
-[color collections](/docs/foundation/collections#colors).
+[color collections](../../docs/foundation/collections.md#colors).
 Check [API](#api) to see which collections are supported.
 
 ### Filled
@@ -90,8 +90,8 @@ Medium-emphasis priority to provide additional context in an unobtrusive way.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -114,7 +114,7 @@ Where:
 
 - `<PRIORITY>` is one of `filled` or `outline`,
 - `<COLOR>` is a value from supported
-  [color collections](/docs/foundation/collections#colors)
+  [color collections](../../docs/foundation/collections.md#colors)
   (check [API](#api) to see which collections are supported),
 - `<PROPERTY>` is one of `color` (color of text) or `background-color` for the
   filled priority, or just `color` for the outline priority.
diff --git a/src/components/Button/README.md b/src/components/Button/README.md
index da2ca7d9d..b758d61b4 100644
--- a/src/components/Button/README.md
+++ b/src/components/Button/README.md
@@ -41,7 +41,7 @@ lowest:
 3. flat
 
 All priorities are available in colors from supported
-[color collections](/docs/foundation/collections#colors).
+[color collections](../../docs/foundation/collections.md#colors).
 Check [API](#api) to see which collections are supported.
 
 ### Filled
@@ -133,7 +133,7 @@ To improve clarity or to draw attention to the action, icons can be added
 before or after the button's label.
 
 👉 Please note there are no icons pre-packed in React UI. Visit
-[Icons](/docs/foundation/icons) to see how to include them.
+[Icons](../../docs/foundation/icons.md) to see how to include them.
 
 ```docoff-react-preview
 <Button
@@ -162,7 +162,7 @@ technologies.
   />
 ```
 
-Icon buttons can optionally enhance on a [breakpoint](/docs/foundation/breakpoints)
+Icon buttons can optionally enhance on a [breakpoint](../../docs/foundation/breakpoints.md)
 of your choice and display label once you know there is enough room for it.
 
 📐 Try resizing your browser to see how label visibility changes.
@@ -197,7 +197,7 @@ of your choice and display label once you know there is enough room for it.
 
 ## Buttons with Badges
 
-A [Badge](/components/Badge) can be added to buttons to provide additional
+A [Badge](../Badge/README.md) can be added to buttons to provide additional
 information or to draw user's attention.
 
 ```docoff-react-preview
@@ -258,10 +258,10 @@ Disabled state makes the action unavailable.
 
 When user's action triggers an asynchronous process on background, the button's
 feedback state (not to be mistaken with
-[feedback colors](/docs/foundation/colors#feedback-colors)) can be indicated by
-showing an icon. The icon replaces button's label while retaining original
-dimensions of the button. Buttons in feedback state are automatically disabled
-to prevent unwanted interaction.
+[feedback colors](../../docs/foundation/colors.md#feedback-colors)) can be
+indicated by showing an icon. The icon replaces button's label while retaining
+original dimensions of the button. Buttons in feedback state are automatically
+disabled to prevent unwanted interaction.
 
 Filled buttons in feedback state:
 
@@ -384,17 +384,17 @@ Flat buttons in feedback state:
 />
 ```
 
-👉 Visit the [CSS Helpers](/docs/css-helpers/animation) section to see how the icon
-animation is made.
+👉 Visit the [CSS Helpers](../../docs/css-helpers/animation.md) section to see
+how the icon animation is made.
 
 ## Forwarding HTML Attributes
 
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<button>` HTML element. This enables making the component interactive and
-helps to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<button>` HTML element. This enables making the component interactive
+and helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
@@ -433,7 +433,7 @@ Where:
 - `<PRIORITY>` is one of `filled`, `outline`, or `flat` (see
   [Priorities](#priorities) and [API](#api)),
 - `<COLOR>` is a value from supported
-  [color collections](/docs/foundation/collections#colors)
+  [color collections](../../docs/foundation/collections.md#colors)
   (check color variants of [each priority](#priorities) and [API](#api) to see
   which collections are supported),
 - `<INTERACTION STATE>` is one of `default`, `hover`, `active`, or `disabled`
@@ -457,8 +457,8 @@ Where:
 - `<PROPERTY>` is one of `height`, `padding-x`, `padding-y`, or `font-size`
 
 👉 Button sizes are linked to
-[box field sizes](/docs/customize/theming/forms#box-field-sizes) sizes so they align
-nicely when placed in row.
+[box field sizes](../../docs/customize/theming/forms.md#box-field-sizes) sizes
+so they align nicely when placed in row.
 
 ### Example Theme
 
diff --git a/src/components/ButtonGroup/README.md b/src/components/ButtonGroup/README.md
index 4ccd39cc5..fab9b5c59 100644
--- a/src/components/ButtonGroup/README.md
+++ b/src/components/ButtonGroup/README.md
@@ -37,11 +37,11 @@ See [API](#api) for all available options.
 - Use **short labels or icons** so the buttons can fit small screens.
 
 - For toggling between on/off states, use rather the
-  [Toggle](/components/Toggle) component.
+  [Toggle](../Toggle/README.md) component.
 
 - For switching between options in a form that needs to be submitted, use rather
-  the [SelectField](/components/SelectField) or
-  [Radio](/components/Radio) components.
+  the [SelectField](../SelectField/README.md) or
+  [Radio](../Radio/README.md) components.
 
 - In the background, ButtonGroup uses the [`fieldset`][fieldset] element. Not
   only it improves the [accessibility] of the group, it also allows you to make
@@ -69,7 +69,7 @@ buttons of totally different types or sizes.
 ## Priorities
 
 There are three **visual priorities** of buttons which exactly copy the
-priorities of the [Button](/components/Button/) component:
+priorities of the [Button](../Button/README.md) component:
 
 1. filled
 2. outline
@@ -251,8 +251,8 @@ and communicating the state of individual options.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
diff --git a/src/components/Card/README.md b/src/components/Card/README.md
index 3192ffe55..3a8f6e820 100644
--- a/src/components/Card/README.md
+++ b/src/components/Card/README.md
@@ -36,7 +36,7 @@ See [API](#api) for all available options.
   grid. It will help you keep the UI clean and easy to scan.
 
 - **Card, or Paper?** Card is a versatile surface for displaying content.
-  However, there is also the [Paper](/components/Paper) component. While Card
+  However, there is also the [Paper](../Paper/README.md) component. While Card
   is designed for displaying items (and also supports more visual options),
   Paper is usually used to hold larger content areas like lists, grids, or
   forms.
@@ -108,7 +108,7 @@ card should be also smaller to keep the card contained and easy to scan.
 
 ## Scrollable Card
 
-Combine Card with [ScrollView](/components/ScrollView) to enable scrolling
+Combine Card with [ScrollView](../ScrollView/README.md) to enable scrolling
 for card content.
 
 ```docoff-react-preview
@@ -147,7 +147,7 @@ for card content.
 ## Color Variants
 
 To cover all possible needs of your project, Card is available in colors from
-[Feedback color collection](/docs/foundation/collections#colors).
+[Feedback color collection](../../docs/foundation/collections.md#colors).
 
 ```docoff-react-preview
 <Card color="success">
@@ -257,8 +257,8 @@ its interactive elements to disallow user's interaction.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -312,7 +312,7 @@ looks as follows:
 Where:
 
 - `<COLOR>` is a value from supported
-  [color collections](/docs/foundation/collections#colors)
+  [color collections](../../docs/foundation/collections.md#colors)
   (check [color variants](#color-variants) and [API](#api) to see which
   collections are supported),
 - `<PROPERTY>` is one of `color` (color of text), `border-color`, or
diff --git a/src/components/CheckboxField/README.md b/src/components/CheckboxField/README.md
index 8b9905ac1..8349f727d 100644
--- a/src/components/CheckboxField/README.md
+++ b/src/components/CheckboxField/README.md
@@ -38,13 +38,13 @@ See [API](#api) for all available options.
 - Use the CheckboxField when there are lists of options and the user may
   **select any number of choices,** including zero, one, or several. For
   selecting just a single option from the list, use either the
-  [Radio](/components/Radio) or [SelectField](/components/SelectField)
+  [Radio](../Radio/README.md) or [SelectField](../SelectField/README.md)
   component.
 
 - Use the CheckboxField for boolean (true/false) input **in forms that require
   to be confirmed** by a button to become active. To toggle things on or off
   with an immediate effect (without confirmation), use rather the
-  [Toggle](/components/Toggle) component.
+  [Toggle](../Toggle/README.md) component.
 
 - **Use positive wording for the checkbox label,** so that it's clear what will
   happen when the user turns on the checkbox. Avoid negations such as “Don't
@@ -257,9 +257,9 @@ Disabled state makes the input unavailable.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<input>` HTML element. This enables making the component interactive and helps
-to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<input>` HTML element. This enables making the component interactive and
+helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
@@ -276,8 +276,9 @@ If you provide [ref], it is forwarded to the native HTML `<input>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options. On top of that, the following options are available for CheckboxField.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options. On top of that, the following options are available for
+CheckboxField.
 
 | Custom Property                                                      | Description                                  |
 |----------------------------------------------------------------------|----------------------------------------------|
@@ -287,7 +288,7 @@ options. On top of that, the following options are available for CheckboxField.
 ### Theming the Required State
 
 Required fields are indicated by
-[shared theming options](/docs/customize/theming/forms/#required-state).
+[shared theming options](../../docs/customize/theming/forms.md#required-state).
 
 If your project uses the label color as the primary means to indicate the
 required state of input fields and the usual asterisk `*` is omitted, you may
diff --git a/src/components/FileInputField/README.md b/src/components/FileInputField/README.md
index d7cfa6208..2156b76e6 100644
--- a/src/components/FileInputField/README.md
+++ b/src/components/FileInputField/README.md
@@ -279,9 +279,9 @@ inside a form.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<input>` HTML element. This enables making the component interactive and helps
-to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<input>` HTML element. This enables making the component interactive and
+helps to improve its accessibility.
 
 ```docoff-react-preview
 <FileInputField
@@ -311,8 +311,8 @@ If you provide [ref], it is forwarded to the native HTML `<input>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options.
 
 [React common props]: https://react.dev/reference/react-dom/components/common#common-props
 [file-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#additional_attributes
diff --git a/src/components/FormLayout/README.md b/src/components/FormLayout/README.md
index 96a948231..cde3b256e 100644
--- a/src/components/FormLayout/README.md
+++ b/src/components/FormLayout/README.md
@@ -48,11 +48,11 @@ there are longer validation messages or help texts.
 ## Supported Form Fields
 
 The FormLayout supports buttons and all React UI form fields:
-[Button](/components/Button), [CheckboxField](/components/CheckboxField),
-[FileInputField](/components/FileInputField),
-[InputGroup](/components/InputGroup), [Radio](/components/Radio),
-[SelectField](/components/SelectField), [TextArea](/components/TextArea),
-[TextField](/components/TextField), and [Toggle](/components/Toggle).
+[Button](../Button/README.md), [CheckboxField](../CheckboxField/README.md),
+[FileInputField](../FileInputField/README.md),
+[InputGroup](../InputGroup/README.md), [Radio](../Radio/README.md),
+[SelectField](../SelectField/README.md), [TextArea](../TextArea/README.md),
+[TextField](../TextField/README.md), and [Toggle](../Toggle/README.md).
 
 ```docoff-react-preview
 React.createElement(() => {
@@ -174,7 +174,7 @@ React.createElement(() => {
 
 ## Vertical Layout
 
-Vertical FormLayout works similar to single-column [Grid](/components/Grid)
+Vertical FormLayout works similar to single-column [Grid](../Grid/README.md)
 layout while it also forces vertical layout mode on form fields. To use this
 layout, simply wrap your form fields with the FormLayout component:
 
@@ -304,7 +304,7 @@ horizontal FormLayout.
 
 Please note the `auto` and `limited` label width options may not function
 correctly in combination with other auto layout mechanisms, e.g. the auto-width
-[Modal](/components/Modal). It's just too much of magic that does not quite
+[Modal](../Modal/README.md). It's just too much of magic that does not quite
 work together yet 🎩.
 
 ## Custom Fields
@@ -425,8 +425,8 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -456,7 +456,7 @@ A place for custom content inside FormLayout.
 ### FormLayoutCustomField Theming
 
 FormLayoutCustomField can be styled using a small subset of
-[other form fields theming options](/docs/customize/theming/forms).
+[other form fields theming options](../../docs/customize/theming/forms.md).
 
 | Custom Property                                             | Description                                      |
 |-------------------------------------------------------------|--------------------------------------------------|
diff --git a/src/components/Grid/README.md b/src/components/Grid/README.md
index 6e1f75a49..d5818c2dc 100644
--- a/src/components/Grid/README.md
+++ b/src/components/Grid/README.md
@@ -35,7 +35,7 @@ See [API](#api) for all available options.
   markup** like GridItem or Cell is necessary for your items. But it's there
   when you really need it—see [Advanced Layouts](#advanced-layouts).
 
-- For forms, use rather the [FormLayout](/components/FormLayout) component
+- For forms, use rather the [FormLayout](../FormLayout/README.md) component
   which is designed specifically for that purpose.
 
 - The Grid component is so powerful that it enables you to build even very
@@ -108,7 +108,7 @@ Use `columns` and `rows` to specify a more complicated grid layout.
 ## Gaps
 
 Both column and row gaps can be customized. The value must correspond to any of
-[available spacings](/docs/foundation/spacing).
+[available spacings](../../docs/foundation/spacing.md).
 
 ```docoff-react-preview
 <Grid columns="repeat(3, 1fr)" columnGap={2} rowGap={6}>
@@ -164,9 +164,9 @@ and wrap your items with `<li>`.
 
 If you need to build more complicated layouts, you have full control over the
 grid definition. Just specify your grid layout for
-[breakpoints](/docs/foundation/breakpoints) where a change of layout is needed.
-The Grid component is written with the mobile-first approach so values for small
-breakpoints are used until they're overridden by a bigger breakpoint.
+[breakpoints](../../docs/foundation/breakpoints.md) where a change of layout is
+needed. The Grid component is written with the mobile-first approach so values
+for small breakpoints are used until they're overridden by a bigger breakpoint.
 
 👉 With this syntax there are no defaults for individual breakpoints.
 
@@ -250,8 +250,8 @@ property. Check [MDN][grid-auto-flow] to fully understand available options.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root HTML element of your choice provided by `tag`, which is `<div>` by
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root HTML element of your choice provided by `tag`, which is `<div>` by
 default. This enables making the component interactive and helps to improve its
 accessibility.
 
diff --git a/src/components/InputGroup/README.md b/src/components/InputGroup/README.md
index ee87fd0d1..a2c348981 100644
--- a/src/components/InputGroup/README.md
+++ b/src/components/InputGroup/README.md
@@ -65,15 +65,15 @@ See [API](#api) for all available options.
   the group with a form outside. Consult [the MDN docs][fieldset] to learn more.
 
 - InputGroup currently **supports grouping of**
-  [TextField](/components/TextField), [SelectField](/components/SelectField),
-  [FileInputField](/components/FileInputField), and [Button](/components/Button)
+  [TextField](../TextField/README.md), [SelectField](../SelectField/README.md),
+  [FileInputField](../FileInputField/README.md), and [Button](../Button/README.md)
   components.
 
-- To group [Buttons](/components/Button) only, use the
-  [ButtonGroup](/components/ButtonGroup) component which is designed
+- To group [Buttons](../Button/README.md) only, use the
+  [ButtonGroup](../ButtonGroup/README.md) component which is designed
   specifically for that purpose.
 
-- InputGroup can be used inside [FormLayout](/components/FormLayout). In that
+- InputGroup can be used inside [FormLayout](../FormLayout/README.md). In that
   case, its `layout` prop is ignored and the value is inherited from
   FormLayout instead.
 
@@ -311,9 +311,9 @@ for the underlying `<fieldset>` element.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<fieldset>` HTML element. This enables making the component interactive
-and helps to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<fieldset>` HTML element. This enables making the component
+interactive and helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
diff --git a/src/components/Modal/README.md b/src/components/Modal/README.md
index 89b235085..3b77c252d 100644
--- a/src/components/Modal/README.md
+++ b/src/components/Modal/README.md
@@ -123,7 +123,7 @@ Modal is decomposed into the following components:
         - ModalCloseButton
     - [ModalBody](#modalbody)
         - ModalContent
-          (may be wrapped with [ScrollView](/components/ScrollView))
+          (may be wrapped with [ScrollView](../ScrollView/README.md))
     - [ModalFooter](#modalfooter)
 
 Using different combinations, you can compose different kinds of modals,
@@ -145,7 +145,7 @@ There are two ways how to position elements within the ModalHeader:
    the ModalHeader and use `justify` prop to set up the positioning of those
    elements.
 2. You can customize positioning using another component (e.g.
-   [Toolbar](/components/Toolbar)). In that case, set `justify` to `stretch` and
+   [Toolbar](../Toolbar/README.md)). In that case, set `justify` to `stretch` and
    position elements on your own.
 
 ```docoff-react-preview
@@ -279,7 +279,7 @@ There are two ways to position buttons within the ModalFooter:
 1. You can use provided positioning. Place Button component (or any arbitrary
    element) and use `justify` prop to set up the positioning of those elements.
 2. You can customize positioning using another component (e.g.
-   [Toolbar](/components/Toolbar)). In that case, set `justify` to `stretch`
+   [Toolbar](../Toolbar/README.md)). In that case, set `justify` to `stretch`
    and position elements on your own.
 
 ```docoff-react-preview
@@ -550,7 +550,7 @@ React.createElement(() => {
 
 👉 Please note the auto width may not function correctly in combination with
 other auto-layout mechanisms, e.g. the auto-width
-[FormLayout](/components/FormLayout#label-width). It's just too much
+[FormLayout](../FormLayout/README.md#label-width). It's just too much
 magic that doesn't work together (yet?) 🎩.
 
 👉 Beware of horizontal FormLayout inside `small` modals. While automatic
@@ -693,7 +693,7 @@ React.createElement(() => {
 ## Color Variants
 
 Modal can be colored using the `color` prop. The `color` prop implements the
-[Feedback color collection](/docs/foundation/collections#colors)
+[Feedback color collection](../../docs/foundation/collections.md#colors)
 and is applied to the border of the modal and the modal footer.
 
 ```docoff-react-preview
@@ -880,7 +880,7 @@ React.createElement(() => {
 ### Forms
 
 Modal can be used to display forms. It is recommended to use
-[FormLayout](/components/FormLayout) component to layout form fields.
+[FormLayout](../FormLayout/README.md) component to layout form fields.
 
 While we support only [controlled components][controlled-components],
 and we encourage you to use them, it is possible to use native form and its
@@ -1049,7 +1049,7 @@ independent of the page itself. This can be done in three ways using the
 
 - `auto` (default) — ModalBody is responsible for scrolling,
 - `custom` — you must provide a custom component to handle scrolling,
-   typically an instance of [ScrollView](/components/ScrollView) wrapping
+   typically an instance of [ScrollView](../ScrollView/README.md) wrapping
    ModalContent,
 - `none` — entire Modal is responsible for scrolling.
 
@@ -1219,7 +1219,7 @@ opened.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to:
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to:
 
 - the `<dialog>` HTML element in case of the `Modal` component.
 - the root `<div>` HTML element in case of `ModalHeader`, `ModalBody`, `ModalContent`
@@ -1301,13 +1301,13 @@ looks as follows:
 Where:
 
 - `<COLOR>` is a value from supported
-  [color collections](/docs/foundation/collections#colors)
+  [color collections](../../docs/foundation/collections.md#colors)
   (check [color variants](#color-variants) and [API](#api) to see which
   collections are supported),
 - `<PROPERTY>` is one of `border-color` or `background-color`.
 
 [button-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attributes
-[controlled-components]: /docs/getting-started/usage#foundation-css
+[controlled-components]: ../../docs/getting-started/usage.md#controlled-vs-uncontrolled
 [dialog-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/dialog#attributes
 [div-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div#attributes
 [heading-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements#attributes
diff --git a/src/components/Paper/README.md b/src/components/Paper/README.md
index de8add8ee..c0f513d07 100644
--- a/src/components/Paper/README.md
+++ b/src/components/Paper/README.md
@@ -26,7 +26,7 @@ See [API](#api) for all available options.
   [raised variant](#raised-paper) to make it stand out on white background.
 
 - **Paper, or Card?** Paper is a basic surface to put content on. However,
-  there is also the [Card](/components/Card) component. While Paper is
+  there is also the [Card](../Card/README.md) component. While Paper is
   usually used to hold larger content areas like lists, grids, or forms, Card is
   designed for displaying items. Card also supports more visual options.
 
@@ -55,8 +55,8 @@ Dim background and add transparency to visually suppress the Paper.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
diff --git a/src/components/Popover/README.md b/src/components/Popover/README.md
index ad1d6e5da..e1ab744cf 100644
--- a/src/components/Popover/README.md
+++ b/src/components/Popover/README.md
@@ -318,7 +318,7 @@ When Popover is rendered inside a scrollable container (e.g. an element with
 `overflow: auto`) and its closest positioned parent is the container itself or
 an element inside it, Popover is clipped by the container and scrolls along
 with its content. This is always the case inside
-[ScrollView](/components/ScrollView), and it also applies to Popover wrapped in
+[ScrollView](../ScrollView/README.md), and it also applies to Popover wrapped in
 PopoverWrapper.
 
 If Popover needs to overflow the scrollable container, use Floating UI with the
@@ -362,8 +362,8 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
diff --git a/src/components/Radio/README.md b/src/components/Radio/README.md
index 9827604f3..3bcea8a68 100644
--- a/src/components/Radio/README.md
+++ b/src/components/Radio/README.md
@@ -44,13 +44,13 @@ See [API](#api) for all available options.
 ## General Guidelines
 
 - Use Radio for **just a few options**. For larger sets of many options (say 4
-  and more) consider using the [SelectField](/components/SelectField)
+  and more) consider using the [SelectField](../SelectField/README.md)
   component. This will help keep your UI clean and uncluttered and prevent your
   users from being overwhelmed by too many options.
 
 - **Don't use for boolean** (true/false) selection or to toggle things on and
-  off. [CheckboxField](/components/CheckboxField) and
-  [Toggle](/components/Toggle) are more suitable for such cases.
+  off. [CheckboxField](../CheckboxField/README.md) and
+  [Toggle](../Toggle/README.md) are more suitable for such cases.
 
 - Use **short and descriptive labels**, ideally nouns rather than seemingly
   polite phrases like _Please select your favourite fruit_. Short labels will
@@ -362,9 +362,9 @@ It's possible to disable just some options or the whole set.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<input>` HTML element. This enables making the component interactive and helps
-to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<input>` HTML element. This enables making the component interactive and
+helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
@@ -377,8 +377,9 @@ to improve its accessibility.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options. On top of that, the following options are available for Radio.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options. On top of that, the following options are available for
+Radio.
 
 | Custom Property                                                    | Description                                      |
 |--------------------------------------------------------------------|--------------------------------------------------|
@@ -388,7 +389,7 @@ options. On top of that, the following options are available for Radio.
 ### Theming the Required State
 
 Required fields are indicated by
-[shared theming options](/docs/customize/theming/forms/#required-state).
+[shared theming options](../../docs/customize/theming/forms.md#required-state).
 
 If your project uses the label color as the primary means to indicate the
 required state of input fields and the usual asterisk `*` is omitted, you may
diff --git a/src/components/ScrollView/README.md b/src/components/ScrollView/README.md
index af7c91ca0..2faad050b 100644
--- a/src/components/ScrollView/README.md
+++ b/src/components/ScrollView/README.md
@@ -384,7 +384,7 @@ custom properties then reacts to the `direction` option:
 
 This is useful if you want to create a single definition of linear gradients for
 scrolling shadows in both directions via
-[global props](/docs/customize/global-props).
+[global props](../../docs/customize/global-props.md).
 
 ```docoff-react-preview
 React.createElement(() => {
@@ -482,8 +482,8 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
diff --git a/src/components/SelectField/README.md b/src/components/SelectField/README.md
index 233b9d1a0..9340ee6d9 100644
--- a/src/components/SelectField/README.md
+++ b/src/components/SelectField/README.md
@@ -44,13 +44,13 @@ See [API](#api) for all available options.
 ## General Guidelines
 
 - Use SelectField for **many options**. For sets of just a few options
-  (say 3 at maximum) consider using the [Radio](/components/Radio) component.
+  (say 3 at maximum) consider using the [Radio](../Radio/README.md) component.
   This will help keep your UI clean and uncluttered and prevent your users from
   being overwhelmed by too many options.
 
 - **Don't use for boolean** (true/false) selection or to toggle things on and
-  off. [CheckboxField](/components/CheckboxField) and
-  [Toggle](/components/Toggle) are more suitable for such cases.
+  off. [CheckboxField](../CheckboxField/README.md) and
+  [Toggle](../Toggle/README.md) are more suitable for such cases.
 
 - Use **short and descriptive labels**, ideally nouns rather than seemingly
   polite phrases like _Please select your favourite fruit_. Short labels will
@@ -731,8 +731,8 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<select>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<select>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -750,8 +750,9 @@ If you provide [ref], it is forwarded to the native HTML `<select>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options. On top of that, the following options are available for SelectField.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options. On top of that, the following options are available for
+SelectField.
 
 | Custom Property                                         | Description                                                  |
 |---------------------------------------------------------|--------------------------------------------------------------|
@@ -762,7 +763,7 @@ options. On top of that, the following options are available for SelectField.
 ### Theming the Required State
 
 Required fields are indicated by
-[shared theming options](/docs/customize/theming/forms/#required-state).
+[shared theming options](../../docs/customize/theming/forms.md#required-state).
 
 If your project uses the label color as the primary means to indicate the
 required state of input fields and the usual asterisk `*` is omitted, you may
diff --git a/src/components/Table/README.md b/src/components/Table/README.md
index 1526c8424..e005234ec 100644
--- a/src/components/Table/README.md
+++ b/src/components/Table/README.md
@@ -63,16 +63,16 @@ See [API](#api) for all available options.
 
 - Tables are **good for displaying complex tabular data.** For simpler data sets
   or even plain key-value pairs, consider using the
-  [Grid](/components/Grid) component.
+  [Grid](../Grid/README.md) component.
 
 - Tables make **lots of information easier to scan and compare.** If you have
   fewer sections and want to emphasize each group more, consider using
-  [Cards](/components/Card).
+  [Cards](../Card/README.md).
 
 ## Responsive Tables
 
 The easiest way to make tables responsive is to wrap them with the
-[ScrollView](/components/ScrollView) component in the horizontal mode.
+[ScrollView](../ScrollView/README.md) component in the horizontal mode.
 
 ```docoff-react-preview
 <ScrollView direction="horizontal">
@@ -245,9 +245,9 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<table>` HTML element. This enables making the component interactive and
-helps to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<table>` HTML element. This enables making the component interactive
+and helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
diff --git a/src/components/Tabs/README.md b/src/components/Tabs/README.md
index 793d210e3..6234c5b8d 100644
--- a/src/components/Tabs/README.md
+++ b/src/components/Tabs/README.md
@@ -104,7 +104,7 @@ React.createElement(() => {
 
 If you have more than a few tabs, you may need to make sure they will be all
 accessible no matter the space they have around. Wrap Tabs into
-[ScrollView](/components/ScrollView) to make them scrollable if necessary.
+[ScrollView](../ScrollView/README.md) to make them scrollable if necessary.
 
 ```docoff-react-preview
 React.createElement(() => {
@@ -159,7 +159,7 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to:
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to:
 
 - the root `<nav>` HTML element in case of `Tabs` component
 - the `<a>` HTML element in case of `TabsItem`
diff --git a/src/components/Text/README.md b/src/components/Text/README.md
index f214fe3dc..390fa7b39 100644
--- a/src/components/Text/README.md
+++ b/src/components/Text/README.md
@@ -115,8 +115,8 @@ insert hyphens where appropriate.
 👉 The `auto` setting's behavior depends on the language being properly tagged
 to select the appropriate hyphenation rules. **You must specify a language**
 using the `lang` HTML attribute (e.g.
-[on `<html>` tag](/docs/getting-started/usage#full-example)) to guarantee that
-automatic hyphenation is applied in that language.
+[on `<html>` tag](../../docs/getting-started/usage.md#full-example)) to
+guarantee that automatic hyphenation is applied in that language.
 
 👉 [Manually suggested line break opportunities](https://developer.mozilla.org/en-US/docs/Web/CSS/hyphens#suggesting_line_break_opportunities)
 will override automatic break point selection in `auto` mode when present.
@@ -204,7 +204,7 @@ React.createElement(() => {
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to:
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to:
 
 - `<span>` HTML element in case that `blockLevel` is set to `false`
 - `<div>` HTML element in case that `blockLevel` is set to `true`
diff --git a/src/components/TextArea/README.md b/src/components/TextArea/README.md
index eb2a4caa5..19cf53f53 100644
--- a/src/components/TextArea/README.md
+++ b/src/components/TextArea/README.md
@@ -319,8 +319,8 @@ It's possible to disable the whole input.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<textarea>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<textarea>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 ```docoff-react-preview
@@ -354,8 +354,8 @@ If you provide [ref], it is forwarded to the native HTML `<textarea>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options.
 
 [React common props]: https://react.dev/reference/react-dom/components/common#common-props
 [ref]: https://reactjs.org/docs/refs-and-the-dom.html
diff --git a/src/components/TextField/README.md b/src/components/TextField/README.md
index f26c0499c..ef9e173d5 100644
--- a/src/components/TextField/README.md
+++ b/src/components/TextField/README.md
@@ -460,9 +460,9 @@ It's possible to disable the whole input.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<input>` HTML element. This enables making the component interactive and helps
-to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<input>` HTML element. This enables making the component interactive and
+helps to improve its accessibility.
 
 ```docoff-react-preview
 <TextField
@@ -514,7 +514,7 @@ If you provide [ref], it is forwarded to the native HTML `<input>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared form
 theming options.
 
 [pattern]: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern
diff --git a/src/components/TextLink/README.md b/src/components/TextLink/README.md
index 6daf6b952..1f983e6ac 100644
--- a/src/components/TextLink/README.md
+++ b/src/components/TextLink/README.md
@@ -23,7 +23,7 @@ See [API](#api) for all available options.
 
 ## General Guidelines
 
-**Avoid using links for actions**, use a [Button](/components/Button/)
+**Avoid using links for actions**, use a [Button](../Button/README.md)
 instead. This is because users expect navigation to happen when clicking on
 something what looks like a link.
 
@@ -49,8 +49,8 @@ It's common to use custom function for routing within SPAs. Use the
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<a>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<a>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -66,9 +66,9 @@ helps to improve its accessibility.
 
 ℹ️ The TextLink component is context-aware and can inherit text color from its
 parent component. This applies for components using
-[Feedback color collection](/docs/foundation/collections#colors) and for
+[Feedback color collection](../../docs/foundation/collections.md#colors) and for
 components in any of the supported
-[validation states](/docs/foundation/colors#validation-states).
+[validation states](../../docs/foundation/colors.md#validation-states).
 In such cases, the custom properties marked with an asterisk (\*) are ignored.
 
 | Custom Property                           | Description                         |
diff --git a/src/components/Toggle/README.md b/src/components/Toggle/README.md
index 3596cbb1e..67c595565 100644
--- a/src/components/Toggle/README.md
+++ b/src/components/Toggle/README.md
@@ -32,7 +32,7 @@ See [API](#api) for all available options.
 - Use the toggle only for boolean (true/false) input **with an immediate effect
   (without confirmation)**. To toggle things on or off in forms that require to
   be submitted by a button, use rather the
-  [CheckboxField](/components/CheckboxField) component.
+  [CheckboxField](../CheckboxField/README.md) component.
 
 - **Use positive wording for the toggle label,** so that it's clear what will
   happen when the user turns on the toggle. Avoid negations such as “Don't send
@@ -54,7 +54,7 @@ See [API](#api) for all available options.
 - The toggle is designed for **switching things on and off.** Don't use it to
   switch between two different things that cannot be described as on or off
   using a single label, e.g. different viewing modes. In such cases, consider
-  using the [ButtonGroup](/components/ButtonGroup) component.
+  using the [ButtonGroup](../ButtonGroup/README.md) component.
 
 ## Help Text
 
@@ -230,9 +230,9 @@ Disabled state makes the input unavailable.
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-`<input>` HTML element. This enables making the component interactive and helps
-to improve its accessibility.
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the `<input>` HTML element. This enables making the component interactive and
+helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
 
@@ -249,8 +249,9 @@ If you provide [ref], it is forwarded to the native HTML `<input>` element.
 
 ## Theming
 
-Head to [Forms Theming](/docs/customize/theming/forms) to see shared form theming
-options. On top of that, the following options are available for Toggle.
+Head to [Forms Theming](../../docs/customize/theming/forms.md) to see shared
+form theming options. On top of that, the following options are available for
+Toggle.
 
 | Custom Property                                                       | Description                                            |
 |-----------------------------------------------------------------------|--------------------------------------------------------|
@@ -265,7 +266,7 @@ options. On top of that, the following options are available for Toggle.
 ### Theming the Required State
 
 Required fields are indicated by
-[shared theming options](/docs/customize/theming/forms/#required-state).
+[shared theming options](../../docs/customize/theming/forms.md#required-state).
 
 If your project uses the label color as the primary means to indicate the
 required state of input fields and the usual asterisk `*` is omitted, you may
diff --git a/src/components/Toolbar/README.md b/src/components/Toolbar/README.md
index 8909e99d5..596678c85 100644
--- a/src/components/Toolbar/README.md
+++ b/src/components/Toolbar/README.md
@@ -324,8 +324,8 @@ Or to build a classic media layout with image on the left and text on the right:
 In addition to the options below in the [component's API](#api) section, you
 can specify **any HTML attribute you like.** All attributes that don't
 interfere with the API of the React component and that aren't filtered out by
-[`transferProps`](/docs/js-helpers/transferProps) helper are forwarded to the
-root `<div>` HTML element. This enables making the component interactive and
+[`transferProps`](../../helpers/transferProps/README.md) helper are forwarded to
+the root `<div>` HTML element. This enables making the component interactive and
 helps to improve its accessibility.
 
 👉 For the full list of supported attributes refer to:
@@ -357,6 +357,6 @@ A wrapper for individual toolbar items.
 | `--rui-Toolbar__gap--dense`                          | Dense gap between toolbar items                              |
 
 [div-attributes]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/div#attributes
-[grid]: /components/Grid
-[text]: /components/Text
+[grid]: ../Grid/README.md
+[text]: ../Text/README.md
 [React common props]: https://react.dev/reference/react-dom/components/common#common-props
diff --git a/src/docs/contribute/api.md b/src/docs/contribute/api.md
index 8e8aeab06..bd0bea948 100644
--- a/src/docs/contribute/api.md
+++ b/src/docs/contribute/api.md
@@ -16,14 +16,14 @@ the component instance:
 instance?
 
 - If yes, put it into the API of the component. Developers can adjust their
-  [global props](/docs/customize/global-props), but the option value can still be
+  [global props](../customize/global-props.md), but the option value can still be
   overridden per component instance.
 - If not, put it into the theme. Developers can change it
-  [in their theme](/docs/customize/theming/overview) and it will be
+  [in their theme](../customize/theming/overview.md) and it will be
   the same for all component instances.
 
 ## Measures
 
-Always use [spacing values](/docs/foundation/spacing) for all kinds of measures
+Always use [spacing values](../foundation/spacing.md) for all kinds of measures
 like offsets, gaps, or spacings. This helps keep the design consistent across
 components.
diff --git a/src/docs/contribute/composition.md b/src/docs/contribute/composition.md
index a48a0d683..b99f7fe9e 100644
--- a/src/docs/contribute/composition.md
+++ b/src/docs/contribute/composition.md
@@ -27,4 +27,4 @@ While authoring self-contained components (1) and wrappers (3) is quite
 straightforward, components with subcomponents require special attention when
 styling. Head to [CSS Guidelines] to learn more.
 
-[CSS Guidelines]: /docs/contribute/css
+[CSS Guidelines]: css.md
diff --git a/src/docs/contribute/css.md b/src/docs/contribute/css.md
index 09fe03a71..b288d62c6 100644
--- a/src/docs/contribute/css.md
+++ b/src/docs/contribute/css.md
@@ -257,14 +257,14 @@ according to [Browserslist] configuration stored in `.browserslistrc`.
 [stylelint-config]: https://github.com/react-ui-org/stylelint-config
 [stylelint-config-standard]: https://github.com/stylelint/stylelint-config-standard
 [Web Components]: https://developer.mozilla.org/en-US/docs/Web/Web_Components
-[foundation CSS layer]: /docs/getting-started/usage#foundation-css
+[foundation CSS layer]: ../getting-started/usage.md#css
 [foundation-css-source]: https://github.com/react-ui-org/react-ui/blob/master/src/foundation.scss
 [cascade layers]: https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
 [CSS modules]: https://github.com/css-modules/css-modules
 [modular CSS specification]: https://developer.mozilla.org/en-US/docs/Learn/CSS/First_steps/What_is_CSS#css_modules
-[modern browsers]: /docs/getting-started/browsers-and-devices
+[modern browsers]: ../getting-started/browsers-and-devices.md
 [CSS custom properties]: https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties
-[theming overview]: /docs/customize/theming/overview
+[theming overview]: ../customize/theming/overview.md
 [Sass]: https://sass-lang.com
 [Sass modules]: https://sass-lang.com/blog/the-module-system-is-launched
 [Built-in Sass modules]: https://sass-lang.com/documentation/modules
diff --git a/src/docs/css-helpers/box-alignment.md b/src/docs/css-helpers/box-alignment.md
index 98fd408c8..8cbe22432 100644
--- a/src/docs/css-helpers/box-alignment.md
+++ b/src/docs/css-helpers/box-alignment.md
@@ -7,7 +7,7 @@ Use the box-alignment classes **on flex or grid containers,** they will not work
 elsewhere.
 
 👉 If you need to quickly create a flex container, there is the
-[`.d-flex`](/docs/css-helpers/display) helper class at your disposal.
+[`.d-flex`](display.md) helper class at your disposal.
 
 📖 Read more about [flexbox] and [grid] layout concepts.
 
@@ -15,7 +15,7 @@ elsewhere.
 
 The classes are named using the format `[alignment]-[value]` for `xs` and
 `[alignment]-[breakpoint]-[value]` for `sm`, `md`, `lg`, `xl`, `x2l`, and
-`x3l` [breakpoints](/docs/foundation/breakpoints).
+`x3l` [breakpoints](../foundation/breakpoints.md).
 
 Where `alignment` is one of:
 
@@ -137,7 +137,7 @@ flexbox), `center`, `end` (`flex-end` for flexbox), `baseline`, and `stretch`.
 ## Responsive Box Alignment
 
 From `sm` up you can set the desired box alignment for individual
-[breakpoints](/docs/foundation/breakpoints).
+[breakpoints](../foundation/breakpoints.md).
 
 ```docoff-react-preview
 <div className="d-flex justify-content-sm-flex-start">
diff --git a/src/docs/css-helpers/colors.md b/src/docs/css-helpers/colors.md
index b456c967a..85b6eb13d 100644
--- a/src/docs/css-helpers/colors.md
+++ b/src/docs/css-helpers/colors.md
@@ -5,9 +5,9 @@ Helpers for text and background.
 ## Text Colors
 
 The text color helpers allow coloring any text with predefined
-[text colors](/docs/foundation/colors#text-colors),
-[feedback colors](/docs/foundation/colors#feedback-colors), and
-[neutral colors](/docs/foundation/colors#neutral-colors).
+[text colors](../foundation/colors.md#text-colors),
+[feedback colors](../foundation/colors.md#feedback-colors), and
+[neutral colors](../foundation/colors.md#neutral-colors).
 
 ```docoff-react-preview
   <docoff-placeholder bordered>
@@ -51,7 +51,7 @@ The text color helpers allow coloring any text with predefined
 ## Background Colors
 
 The background color helpers allow coloring any element with predefined
-[background colors](/docs/foundation/colors#background-colors) (with an
+[background colors](../foundation/colors.md#background-colors) (with an
 exception to background colors for interactive areas that are intended to be
 used only in CSS).
 
diff --git a/src/docs/css-helpers/display.md b/src/docs/css-helpers/display.md
index f752cda0d..1dff18112 100644
--- a/src/docs/css-helpers/display.md
+++ b/src/docs/css-helpers/display.md
@@ -7,7 +7,7 @@ including hiding the content.
 
 The classes are named using the format `d-[value]` for `xs` and
 `d-[breakpoint]-[value]` for `sm`, `md`, `lg`, `xl`, `x2l`, and `x3l`
-[breakpoints](/docs/foundation/breakpoints).
+[breakpoints](../foundation/breakpoints.md).
 
 Where `value` is one of:
 
diff --git a/src/docs/css-helpers/spacing.md b/src/docs/css-helpers/spacing.md
index 49753c4fd..79a8a0a75 100644
--- a/src/docs/css-helpers/spacing.md
+++ b/src/docs/css-helpers/spacing.md
@@ -7,7 +7,7 @@ Responsive spacing helper classes enable to simply add or modify `margin` and
 
 The classes are named using the format `[property][sides]-[size]` for `xs` and
 `[property][sides]-[breakpoint]-[size]` for `sm`, `md`, `lg`, `xl`, `x2l`, and
- `x3l` [breakpoints](/docs/foundation/breakpoints).
+ `x3l` [breakpoints](../foundation/breakpoints.md).
 
 Where `property` is one of:
 
@@ -33,7 +33,7 @@ Where `size` is one of:
 - `7`
 - `auto` for classes that set the `margin` to `auto`
 
-👉 Check the [spacing scale](/docs/foundation/spacing) to see the exact values of
+👉 Check the [spacing scale](../foundation/spacing.md) to see the exact values of
 individual sizes.
 
 ## Examples
diff --git a/src/docs/customize/font.md b/src/docs/customize/font.md
index f8943b922..dbc632193 100644
--- a/src/docs/customize/font.md
+++ b/src/docs/customize/font.md
@@ -16,7 +16,7 @@ You can change it to a custom font by loading the font in your project:
    />
 ```
 
-… and [overriding](/docs/customize/theming/overview) the
+… and [overriding](theming/overview.md) the
 `--rui-font-family-base` CSS custom property:
 
 ```css
diff --git a/src/docs/customize/theming/forms.md b/src/docs/customize/theming/forms.md
index f921e4469..322a99fb7 100644
--- a/src/docs/customize/theming/forms.md
+++ b/src/docs/customize/theming/forms.md
@@ -41,9 +41,9 @@ Options for fields that support horizontal layout.
 ## Box Fields
 
 Options shared by box form controls. This includes
-[TextField](/components/TextField),
-[TextArea](/components/TextArea), and
-[SelectField](/components/SelectField).
+[TextField](../../../components/TextField/README.md),
+[TextArea](../../../components/TextArea/README.md), and
+[SelectField](../../../components/SelectField/README.md).
 
 | Custom Property                                      | Description                                                  |
 |------------------------------------------------------|--------------------------------------------------------------|
@@ -227,8 +227,8 @@ Where:
 - `<PROPERTY>` is one of `height`, `padding-x`, `padding-y`, or `font-size`
 
 👉 Box field sizes are linked to
-[Button sizes](/components/Button/#theming-sizes) so they align nicely when
-placed in row.
+[Button sizes](../../../components/Button/README.md#theming-sizes) so they align
+nicely when placed in row.
 
 Example:
 
@@ -299,8 +299,8 @@ React.createElement(() => {
 ## Check Fields
 
 Options shared by checkable form controls. This includes
-[CheckboxField](/components/CheckboxField), [Radio](/components/Radio),
-and [Toggle](/components/Toggle).
+[CheckboxField](../../../components/CheckboxField/README.md), [Radio](../../../components/Radio/README.md),
+and [Toggle](../../../components/Toggle/README.md).
 
 | Custom Property                                      | Description                                                  |
 |------------------------------------------------------|--------------------------------------------------------------|
@@ -611,10 +611,10 @@ the `renderAsRequired` prop to `true`. This is useful when
 `--rui-FormField--required__label__color` is used to indicate the required state
 of input fields, but you want to bypass it for inputs like feature toggles.
 This applies to
-[CheckboxField](/components/CheckboxField/#theming-the-required-state),
-[Radio](/components/Radio/#theming-the-required-state),
-[SelectField](/components/SelectField/#theming-the-required-state),
-and [Toggle](/components/Toggle/#theming-the-required-state).
+[CheckboxField](../../../components/CheckboxField/README.md#theming-the-required-state),
+[Radio](../../../components/Radio/README.md#theming-the-required-state),
+[SelectField](../../../components/SelectField/README.md#theming-the-required-state),
+and [Toggle](../../../components/Toggle/README.md#theming-the-required-state).
 
 ## Disabled State
 
diff --git a/src/docs/customize/theming/overview.md b/src/docs/customize/theming/overview.md
index db2917a69..bf94b87b6 100644
--- a/src/docs/customize/theming/overview.md
+++ b/src/docs/customize/theming/overview.md
@@ -13,7 +13,7 @@ for two main reasons:
 
 ## Theming Options
 
-[Design tokens](/docs/foundation/design-tokens) define common visual properties
+[Design tokens](../../foundation/design-tokens.md) define common visual properties
 like colors, fonts, borders, shadows, or spacing. [CSS custom properties] are
 the technical representation of the design tokens in React UI.
 
@@ -145,5 +145,5 @@ directly in your stylesheet, or through an intermediate, shareable layer like
 [dtf]: https://design-tokens.github.io/community-group/format/
 [theme constants]: https://github.com/react-ui-org/react-ui/blob/master/src/styles/theme-constants
 [w3c-custom-properties]: https://www.w3.org/TR/css-variables-1/#using-variables
-[BEM]: https://getbem.com
+[BEM]: https://en.bem.info/
 [SUIT CSS]: https://suitcss.github.io
diff --git a/src/docs/customize/translations.md b/src/docs/customize/translations.md
index d87a7e7b8..cb6720794 100644
--- a/src/docs/customize/translations.md
+++ b/src/docs/customize/translations.md
@@ -3,7 +3,7 @@
 Some components may contain texts which improve components' accessibility.
 All texts are in English by default and can be translated to other languages.
 
-Structure of translations can be found in the file [src/translations/en.json].
+Structure of translations can be found in the file [src/translations/en.ts].
 
 To use custom translations, you need to import `TranslationsProvider` first:
 
@@ -52,4 +52,4 @@ ones.
 </TranslationsProvider>
 ```
 
-[src/translations/en.json]: https://github.com/react-ui-org/react-ui/blob/master/src/translations/en.js
+[src/translations/en.ts]: https://github.com/react-ui-org/react-ui/blob/master/src/translations/en.ts
diff --git a/src/docs/foundation/accessibility.md b/src/docs/foundation/accessibility.md
index 17a095492..aac120950 100644
--- a/src/docs/foundation/accessibility.md
+++ b/src/docs/foundation/accessibility.md
@@ -4,7 +4,8 @@ React UI bakes accessibility principles right into its core.
 
 👉 You can adjust all custom properties on this page (and more) in your theme by
 overriding values in the
-[design tokens](/docs/customize/theming/overview#design-tokens) section.
+[design tokens](../customize/theming/overview.md#global-and-semantic-design-tokens)
+section.
 
 ## Touch Friendliness
 
@@ -13,24 +14,24 @@ elements can be easily targeted on touch screens. Recommended dimensions may
 vary from platform to platform, however a commonly used size is 7–10 mm.
 
 Default tap target size in React UI is used by all potentially small interactive
-components like [Alert](/components/Alert) close button,
-[CheckboxField](/components/CheckboxField), or [Toggle](/components/Toggle).
+components like [Alert](../../components/Alert/README.md) close button,
+[CheckboxField](../../components/CheckboxField/README.md), or [Toggle](../../components/Toggle/README.md).
 Tap target size can be adjusted via the `--rui-dimension-tap-target-size`
-custom property (see [Theming](/docs/customize/theming/overview) to learn how).
+custom property (see [Theming](../customize/theming/overview.md) to learn how).
 
 📖 [Read more about touch targets at Norman Nielsen Group.][nn-group]
 
 ### Form Fields and Reserved Space
 
 Note that form fields with potentially small inputs (like
-[CheckboxField](/components/CheckboxField) or
-[Toggle](/components/Toggle)) reserve vertical space corresponding to the
-minimum tap target size. In other words, form fields **box model is taller.**
-The reason behind this behaviour is that in many cases the minimum tap target
-size could overflow its component's box model and tap targets of neighboring
-components could collide. The extra added space prevents this.
-
-However, if placed inside [FormLayout](/components/FormLayout), form
+[CheckboxField](../../components/CheckboxField/README.md) or
+[Toggle](../../components/Toggle/README.md)) reserve vertical space
+corresponding to the minimum tap target size. In other words, form fields **box
+model is taller.** The reason behind this behaviour is that in many cases the
+minimum tap target size could overflow its component's box model and tap targets
+of neighboring components could collide. The extra added space prevents this.
+
+However, if placed inside [FormLayout](../../components/FormLayout/README.md), form
 fields do not add any extra vertical space because it is already provided by
 `FormLayout` row gap. Remember to check that form fields in your `FormLayout`
 are properly spaced and interactive elements do not collide should you decide to
@@ -47,7 +48,7 @@ React UI are **highlighted on focus** so keyboard users can easily tab over
 them and see what control currently has focus.
 
 All interactive elements obtain a blue outline on focus. Appearance of the focus
-highlight can be [adjusted](/docs/customize/theming/overview) with the following
+highlight can be [adjusted](../customize/theming/overview.md) with the following
 custom properties:
 
 - `--rui-border-focus-ring`,
diff --git a/src/docs/foundation/borders.md b/src/docs/foundation/borders.md
index 41933d043..58a4d5752 100644
--- a/src/docs/foundation/borders.md
+++ b/src/docs/foundation/borders.md
@@ -3,8 +3,8 @@
 Borders separate the content from the outer context.
 
 👉 All values on this page can be changed by
-[overriding](/docs/customize/theming/overview) values in your
-[design tokens](/docs/foundation/design-tokens).
+[overriding](../customize/theming/overview.md) values in your
+[design tokens](design-tokens.md).
 
 Available border widths (the list may grow in the future):
 
@@ -18,7 +18,7 @@ Available border styles:
 |--------------|---------------------------|-----------------------------------|
 | focus ring   | `--rui-border-focus-ring` | Focus ring style                  |
 
-👉 Check [Colors](/docs/foundation/colors#border-colors) for available border colors.
+👉 Check [Colors](colors.md#border-colors) for available border colors.
 
-👉 Check [Accessibility](/docs/foundation/accessibility#keyboard-friendliness) for
+👉 Check [Accessibility](accessibility.md#keyboard-friendliness) for
 all focus ring options.
diff --git a/src/docs/foundation/colors.md b/src/docs/foundation/colors.md
index 3fa1358fa..3075146bb 100644
--- a/src/docs/foundation/colors.md
+++ b/src/docs/foundation/colors.md
@@ -5,8 +5,8 @@ information, or signal different states of the UI. **Use colors intentionally**
 — they are not decoration and should always serve a purpose.
 
 👉 All colors on this page can be changed by
-[overriding](/docs/customize/theming/overview) values in your
-[design tokens](/docs/foundation/design-tokens).
+[overriding](../customize/theming/overview.md) values in your
+[design tokens](design-tokens.md).
 
 ## General Guidelines
 
@@ -145,7 +145,7 @@ Colors reserved for backgrounds.
 Backgrounds for the fundamental UI areas and content layering.
 
 👉 Content layers can be separated from background using their
-[shadow counterparts](/docs/foundation/shadows): `background-layer-1` +
+[shadow counterparts](shadows.md): `background-layer-1` +
 `shadow-layer-1` etc.
 
 <div>
@@ -231,20 +231,22 @@ Components can apply colors above using one or more following approaches.
 
 ### Color Collections
 
-Some components ([Alert](/components/Alert), [Badge](/components/Badge),
-[Button](/components/Button), and more) come in more color variants to help you
-better reflect their place in content hierarchy or the meaning of their content.
-In such cases, one or more [Color Collections][collection-colors] are always
-used. There is always a reasonable default color for the component in question
-that can be changed to any of supported collection values through the `color`
-prop.
+Some components ([Alert](../../components/Alert/README.md),
+[Badge](../../components/Badge/README.md),
+[Button](../../components/Button/README.md), and more) come in more color
+variants to help you better reflect their place in content hierarchy or the
+meaning of their content. In such cases, one or more
+[Color Collections][collection-colors] are always used. There is always a
+reasonable default color for the component in question that can be changed to
+any of supported collection values through the `color` prop.
 
 ### Validation States
 
 All form field components that support validation states
-([CheckboxField](/components/CheckboxField),
-[TextField](/components/TextField), [Toggle](/components/Toggle) and more)
-apply selected [feedback colors](#feedback-colors) for individual states:
+([CheckboxField](../../components/CheckboxField/README.md),
+[TextField](../../components/TextField/README.md),
+[Toggle](../../components/Toggle/README.md) and more) apply selected
+[feedback colors](#feedback-colors) for individual states:
 
 - `success` feedback color for **valid** state,
 - `warning` feedback color for **warning** state,
@@ -253,4 +255,4 @@ apply selected [feedback colors](#feedback-colors) for individual states:
 Validation state is always optional. Default styling is applied for the given
 component when its `validationState` prop is not specified.
 
-[collection-colors]: /docs/foundation/collections#colors
+[collection-colors]: collections.md#colors
diff --git a/src/docs/foundation/design-tokens.md b/src/docs/foundation/design-tokens.md
index 07e2f7281..b7d057969 100644
--- a/src/docs/foundation/design-tokens.md
+++ b/src/docs/foundation/design-tokens.md
@@ -6,7 +6,7 @@ tools, and technologies. They help establish a common vocabulary across
 organizations.
 
 👉 Design tokens are your starting point for
-[customization](/docs/customize/theming/overview) of React UI to make it fit your
+[customization](../customize/theming/overview.md) of React UI to make it fit your
 design system needs. React UI uses CSS custom properties as a primary storage
 format for design tokens.
 
diff --git a/src/docs/foundation/shadows.md b/src/docs/foundation/shadows.md
index 27e0422e1..4dce083ce 100644
--- a/src/docs/foundation/shadows.md
+++ b/src/docs/foundation/shadows.md
@@ -4,8 +4,8 @@ Use shadows to add depth to your components and to better separate them from
 background.
 
 👉 All values on this page can be changed by
-[overriding](/docs/customize/theming/overview) values in your
-[design tokens](/docs/foundation/design-tokens).
+[overriding](../customize/theming/overview.md) values in your
+[design tokens](design-tokens.md).
 
 | Shadow     | Usage in CSS              | Purpose                                  |
 |------------|---------------------------|------------------------------------------|
@@ -14,7 +14,7 @@ background.
 | focus ring | `--rui-shadow-focus-ring` | Focus ring to be used instead of outline |
 
 👉 Check how the layer shadows pair nicely with their
-[background color counterparts](/docs/foundation/colors#content-layers).
+[background color counterparts](colors.md#content-layers).
 
-👉 Check [Accessibility](/docs/foundation/accessibility#keyboard-friendliness) for
+👉 Check [Accessibility](accessibility.md#keyboard-friendliness) for
 all focus ring options.
diff --git a/src/docs/foundation/spacing.md b/src/docs/foundation/spacing.md
index 0eda76d2e..813f1754b 100644
--- a/src/docs/foundation/spacing.md
+++ b/src/docs/foundation/spacing.md
@@ -6,7 +6,8 @@ help you keep your UI consistent.
 
 👉 You can adjust all custom properties on this page (and more) in your theme by
 overriding values in the
-[design tokens](/docs/customize/theming/overview#design-tokens) section.
+[design tokens](../customize/theming/overview.md#global-and-semantic-design-tokens)
+section.
 
 | Space | Value    | Usage in CSS              | Usage in SCSS   | Usage in HTML/JSX* |
 |-------|---------:|---------------------------|-----------------|--------------------|
@@ -20,7 +21,7 @@ overriding values in the
 | 7     | 2.5 rem  | `--rui-dimension-space-7` | `spacing.of(7)` | `class="mt-7"`     |
 
 \* For the sake of brevity, usage in HTML only illustrates the top margin
-property. See [Spacing helpers](/docs/css-helpers/spacing) for the full list of
+property. See [Spacing helpers](../css-helpers/spacing.md) for the full list of
 options.
 
 ## Shared Spacings
diff --git a/src/docs/foundation/typography.md b/src/docs/foundation/typography.md
index 50c213664..d13849eb5 100644
--- a/src/docs/foundation/typography.md
+++ b/src/docs/foundation/typography.md
@@ -4,8 +4,8 @@ Typography is the basic means to present information to users. It also serves to
 communicate the hierarchy of a page.
 
 👉 All values on this page can be changed by
-[overriding](/docs/customize/theming/overview) values in your
-[design tokens](/docs/foundation/design-tokens).
+[overriding](../customize/theming/overview.md) values in your
+[design tokens](design-tokens.md).
 
 ## Showcase
 
@@ -63,12 +63,12 @@ React UI uses [native font stack][sm-native-font-stack] for optimum text
 rendering on every device and OS.
 
 👉 You can replace the native font stack with a
-[custom font](/docs/customize/font).
+[custom font](../customize/font.md).
 
 ## Customization
 
 Font size, font weight, and line height values can be
-[customised](/docs/customize/theming/overview) as well:
+[customised](../customize/theming/overview.md) as well:
 
 ```css
 :root {
diff --git a/src/docs/getting-started/usage.md b/src/docs/getting-started/usage.md
index 2f74989ef..f084808be 100644
--- a/src/docs/getting-started/usage.md
+++ b/src/docs/getting-started/usage.md
@@ -99,12 +99,12 @@ React UI is also available on CDN:
 
 👉 Consider using a specific version instead of `latest` in production.
 
-[CSS cascade layers]: /docs/contribute/css#cascade-layers
-[design tokens]: /docs/foundation/design-tokens
-[Theming]: /docs/customize/theming/overview
-[CSS modules]: /docs/contribute/css#css-modules
-[typography]: /docs/css-helpers/typography
-[spacing]: /docs/css-helpers/spacing
-[colors]: /docs/css-helpers/colors
+[CSS cascade layers]: ../contribute/css.md#cascade-layers
+[design tokens]: ../foundation/design-tokens.md
+[Theming]: ../customize/theming/overview.md
+[CSS modules]: ../contribute/css.md#css-modules
+[typography]: ../css-helpers/typography.md
+[spacing]: ../css-helpers/spacing.md
+[colors]: ../css-helpers/colors.md
 [bootstrap-utilities]: https://getbootstrap.com/docs/5.3/utilities/api/
 [controlled components]: https://reactjs.org/docs/forms.html#controlled-components
diff --git a/src/index.md b/src/index.md
index a75cdc6e2..0dde3d737 100644
--- a/src/index.md
+++ b/src/index.md
@@ -28,26 +28,26 @@ React UI consists of four building blocks:
 
 1. **Foundation CSS:** basic themeable CSS layer. **Mandatory ground zero for
    components.**
-   [Learn how to get started quickly.](/docs/getting-started/installation)
+   [Learn how to get started quickly.](docs/getting-started/installation.md)
 
 2. **Components:** reusable and themeable React components and layouts:
-   [alerts](/components/Alert), [buttons](/components/Button/),
-   [cards](/components/Card), and more.
+   [alerts](components/Alert/README.md), [buttons](components/Button/README.md),
+   [cards](components/Card/README.md), and more.
 
 3. **Theme:** a collection of CSS custom properties that define the visual
    appearance of the UI.
-   [Learn how to create a theme.](/docs/customize/theming/overview)
+   [Learn how to create a theme.](docs/customize/theming/overview.md)
 
 4. **Helper CSS classes (optional):** tiny CSS classes with notation
    **inspired by Bootstrap.** They can handle details like
-   [typography](/docs/css-helpers/typography), [spacing](/docs/css-helpers/spacing),
-   [colors](/docs/css-helpers/colors), etc.
+   [typography](docs/css-helpers/typography.md), [spacing](docs/css-helpers/spacing.md),
+   [colors](docs/css-helpers/colors.md), etc.
 
 ## Sponsors
 
 <a href="https://www.racom.eu" target="_blank" rel="noopener noreferrer">
   <img
-    src="/docs/_assets/racom.svg"
+    src="docs/_assets/racom.svg"
     width="190"
     height="30"
     className="mt-5 mb-6"

From 30e7eb4bc07b81cabc8fbdb2da4fe02930d63cce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bed=C5=99ich=20Schindler?= <bedrich.schindler@gmail.com>
Date: Wed, 7 Oct 2026 09:44:57 +0200
Subject: [PATCH 2/2] Bring back Markdown link check (#650)

---
 .claude/agents/code-reviewer.md           |   3 +-
 .claude/rules/docs.md                     |   1 +
 .github/markdown-link-check.json          |  10 -
 .github/workflows/lint.yml                |  21 +-
 .github/workflows/release-management.yml  |  21 +-
 .markdown-link-check-external.json        |  20 +
 .markdown-link-check-internal.json        |   7 +
 package-lock.json                         | 888 ++++++++++++++++++++++
 package.json                              |   9 +-
 src/docs/contribute/testing-guidelines.md |   5 +-
 10 files changed, 966 insertions(+), 19 deletions(-)
 delete mode 100644 .github/markdown-link-check.json
 create mode 100644 .markdown-link-check-external.json
 create mode 100644 .markdown-link-check-internal.json

diff --git a/.claude/agents/code-reviewer.md b/.claude/agents/code-reviewer.md
index ec0934428..82d9ec8a5 100644
--- a/.claude/agents/code-reviewer.md
+++ b/.claude/agents/code-reviewer.md
@@ -87,7 +87,8 @@ rules in section 6 are the easiest to miss — do not skip them.
 Easy-to-miss invariants beyond the generic checks above:
 
 * **Lint gate** ([CLAUDE.md](../../CLAUDE.md#commands)): `npm run lint` =
-  eslint + markdownlint + stylelint. It is not auto-run — remind the author to
+  eslint + markdownlint + stylelint + typecheck + markdown-link-check. It is not
+  auto-run — remind the author to
   run `npm run lint`, `npm run test:jest`, and `npm run test:playwright-ct:all`.
 * **Component layout** ([frontend.md](../rules/frontend.md)): every component
   folder has the `.tsx` + `.types.ts` + `index.ts` barrel + `*.module.scss` + `_settings`/
diff --git a/.claude/rules/docs.md b/.claude/rules/docs.md
index ad4f73553..988dc4e06 100644
--- a/.claude/rules/docs.md
+++ b/.claude/rules/docs.md
@@ -11,6 +11,7 @@ paths:
 ## Commands
 
 * Run `npm run markdownlint` after changes (add `-- --fix` to autofix).
+* Run `npm run markdown-link-check` to check links in all Markdown files.
 * Run `mkdocs build` and `mkdocs serve` to build and serve the documentation
 * To verify a rendered component or the docs previews in a real browser
   (navigate, click, screenshot, inspect the running docs site), drive host
diff --git a/.github/markdown-link-check.json b/.github/markdown-link-check.json
deleted file mode 100644
index 3bbd632ca..000000000
--- a/.github/markdown-link-check.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-  "ignorePatterns": [
-    {
-      "pattern": "^/components/"
-    },
-    {
-      "pattern": "^/docs/"
-    }
-  ]
-}
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index e86dee323..88f771f76 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -22,5 +22,22 @@ jobs:
       - name: Install
         run: npm ci
 
-      - name: Test
-        run: npm run lint
+      - name: ESLint
+        run: npm run eslint
+
+      - name: Markdownlint
+        run: npm run markdownlint
+
+      - name: Markdown link check (internal)
+        run: npm run markdown-link-check:internal
+
+      - name: Markdown link check (external)
+        run: npm run markdown-link-check:external
+        # Report broken links without blocking the pull request, external websites can fail at any time
+        continue-on-error: true
+
+      - name: Stylelint
+        run: npm run stylelint
+
+      - name: Typecheck
+        run: npm run typecheck
diff --git a/.github/workflows/release-management.yml b/.github/workflows/release-management.yml
index ec91cf443..e57565c73 100644
--- a/.github/workflows/release-management.yml
+++ b/.github/workflows/release-management.yml
@@ -28,8 +28,25 @@ jobs:
       - name: Install
         run: npm ci
 
-      - name: Lint
-        run: npm run lint
+      - name: ESLint
+        run: npm run eslint
+
+      - name: Markdownlint
+        run: npm run markdownlint
+
+      - name: Markdown link check (internal)
+        run: npm run markdown-link-check:internal
+
+      - name: Markdown link check (external)
+        run: npm run markdown-link-check:external
+        # Report broken links without blocking the release, external websites can fail at any time
+        continue-on-error: true
+
+      - name: Stylelint
+        run: npm run stylelint
+
+      - name: Typecheck
+        run: npm run typecheck
 
       - name: Test
         run: npm test
diff --git a/.markdown-link-check-external.json b/.markdown-link-check-external.json
new file mode 100644
index 000000000..5d62efc51
--- /dev/null
+++ b/.markdown-link-check-external.json
@@ -0,0 +1,20 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^(?!https?://)"
+    },
+    {
+      "pattern": "^https://stackoverflow\\.com/"
+    },
+    {
+      "pattern": "^https://react\\.dev/reference/react-dom/components/common#common-props$"
+    },
+    {
+      "pattern": "^https://coveralls\\.io/"
+    },
+    {
+      "pattern": "^https://uxdesign\\.cc/"
+    }
+  ],
+  "aliveStatusCodes": [200, 429]
+}
diff --git a/.markdown-link-check-internal.json b/.markdown-link-check-internal.json
new file mode 100644
index 000000000..03c7f419f
--- /dev/null
+++ b/.markdown-link-check-internal.json
@@ -0,0 +1,7 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^(https?|mailto):"
+    }
+  ]
+}
diff --git a/package-lock.json b/package-lock.json
index a2aa333ab..3288a7457 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -42,6 +42,7 @@
         "eslint": "^9.39.5",
         "identity-obj-proxy": "^3.0.0",
         "jest": "^30.5.1",
+        "markdown-link-check": "^3.15.0",
         "markdownlint-cli2": "^0.23.3",
         "mini-css-extract-plugin": "^2.10.2",
         "postcss": "^8.5.28",
@@ -5403,6 +5404,58 @@
         "node": ">= 8"
       }
     },
+    "node_modules/@oozcitak/dom": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/@oozcitak/dom/-/dom-2.0.2.tgz",
+      "integrity": "sha512-GjpKhkSYC3Mj4+lfwEyI1dqnsKTgwGy48ytZEhm4A/xnH/8z9M3ZVXKr/YGQi3uCLs1AEBS+x5T2JPiueEDW8w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oozcitak/infra": "^2.0.2",
+        "@oozcitak/url": "^3.0.0",
+        "@oozcitak/util": "^10.0.0"
+      },
+      "engines": {
+        "node": ">=20.0"
+      }
+    },
+    "node_modules/@oozcitak/infra": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/@oozcitak/infra/-/infra-2.0.2.tgz",
+      "integrity": "sha512-2g+E7hoE2dgCz/APPOEK5s3rMhJvNxSMBrP+U+j1OWsIbtSpWxxlUjq1lU8RIsFJNYv7NMlnVsCuHcUzJW+8vA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oozcitak/util": "^10.0.0"
+      },
+      "engines": {
+        "node": ">=20.0"
+      }
+    },
+    "node_modules/@oozcitak/url": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/@oozcitak/url/-/url-3.0.0.tgz",
+      "integrity": "sha512-ZKfET8Ak1wsLAiLWNfFkZc/BraDccuTJKR6svTYc7sVjbR+Iu0vtXdiDMY4o6jaFl5TW2TlS7jbLl4VovtAJWQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oozcitak/infra": "^2.0.2",
+        "@oozcitak/util": "^10.0.0"
+      },
+      "engines": {
+        "node": ">=20.0"
+      }
+    },
+    "node_modules/@oozcitak/util": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/@oozcitak/util/-/util-10.0.0.tgz",
+      "integrity": "sha512-hAX0pT/73190NLqBPPWSdBVGtbY6VOhWYK3qqHqtXQ1gK7kS2yz4+ivsN07hpJ6I3aeMtKP6J6npsEKOAzuTLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0"
+      }
+    },
     "node_modules/@parcel/watcher": {
       "version": "2.6.0",
       "resolved": "https://registry.npmjs.org/@parcel/watcher/-/watcher-2.6.0.tgz",
@@ -7892,6 +7945,16 @@
         "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
       }
     },
+    "node_modules/agent-base": {
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-9.0.0.tgz",
+      "integrity": "sha512-TQf59BsZnytt8GdJKLPfUZ54g/iaUL2OWDSFCCvMOhsHduDQxO8xC4PNeyIkVcA5KwL2phPSv0douC0fgWzmnA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/ajv": {
       "version": "6.15.0",
       "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
@@ -8235,6 +8298,19 @@
         "node": ">=12.0.0"
       }
     },
+    "node_modules/ast-types": {
+      "version": "0.13.4",
+      "resolved": "https://registry.npmjs.org/ast-types/-/ast-types-0.13.4.tgz",
+      "integrity": "sha512-x1FCFnFifvYDDzTaLII71vG5uvDwgtmDTEVWAxrgeiR8VjMONcCXJx7E+USjDtHlwFmt9MysbqgF9b9Vjr6w+w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/ast-types-flow": {
       "version": "0.0.8",
       "resolved": "https://registry.npmjs.org/ast-types-flow/-/ast-types-flow-0.0.8.tgz",
@@ -8252,6 +8328,13 @@
         "node": ">=8"
       }
     },
+    "node_modules/async": {
+      "version": "3.2.6",
+      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
+      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/async-function": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",
@@ -8510,6 +8593,16 @@
         "node": ">=6.0.0"
       }
     },
+    "node_modules/basic-ftp": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/basic-ftp/-/basic-ftp-6.2.1.tgz",
+      "integrity": "sha512-bK67isD+lKq46AU8vNtjvMaT2ZqAOAmNCbxUHlFBRD4k15NWxyEjmaKtZPlgce58So4BNTjITGQOVTjL9y0ECA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
     "node_modules/batch": {
       "version": "0.6.1",
       "resolved": "https://registry.npmjs.org/batch/-/batch-0.6.1.tgz",
@@ -8567,6 +8660,13 @@
         "multicast-dns": "^7.2.5"
       }
     },
+    "node_modules/boolbase": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+      "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
+      "dev": true,
+      "license": "ISC"
+    },
     "node_modules/brace-expansion": {
       "version": "5.0.9",
       "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.9.tgz",
@@ -8871,6 +8971,60 @@
         "url": "https://github.com/sponsors/wooorm"
       }
     },
+    "node_modules/cheerio": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/cheerio/-/cheerio-1.2.0.tgz",
+      "integrity": "sha512-WDrybc/gKFpTYQutKIK6UvfcuxijIZfMfXaYm8NMsPQxSYvf+13fXUJ4rztGGbJcBQ/GF55gvrZ0Bc0bj/mqvg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cheerio-select": "^2.1.0",
+        "dom-serializer": "^2.0.0",
+        "domhandler": "^5.0.3",
+        "domutils": "^3.2.2",
+        "encoding-sniffer": "^0.2.1",
+        "htmlparser2": "^10.1.0",
+        "parse5": "^7.3.0",
+        "parse5-htmlparser2-tree-adapter": "^7.1.0",
+        "parse5-parser-stream": "^7.1.2",
+        "undici": "^7.19.0",
+        "whatwg-mimetype": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=20.18.1"
+      },
+      "funding": {
+        "url": "https://github.com/cheeriojs/cheerio?sponsor=1"
+      }
+    },
+    "node_modules/cheerio-select": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/cheerio-select/-/cheerio-select-2.1.0.tgz",
+      "integrity": "sha512-9v9kG0LvzrlcungtnJtpGNxY+fzECQKhK4EGJX2vByejiMX84MFNQw4UxPJl3bFbTMw+Dfs37XaIkCwTZfLh4g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0",
+        "css-select": "^5.1.0",
+        "css-what": "^6.1.0",
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3",
+        "domutils": "^3.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
+    "node_modules/cheerio/node_modules/whatwg-mimetype": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+      "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/chokidar": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz",
@@ -9285,6 +9439,23 @@
         "node": ">=10"
       }
     },
+    "node_modules/css-select": {
+      "version": "5.2.2",
+      "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz",
+      "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0",
+        "css-what": "^6.1.0",
+        "domhandler": "^5.0.2",
+        "domutils": "^3.0.1",
+        "nth-check": "^2.0.1"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
     "node_modules/css-tree": {
       "version": "3.2.1",
       "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
@@ -9299,6 +9470,19 @@
         "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
       }
     },
+    "node_modules/css-what": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz",
+      "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">= 6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/fb55"
+      }
+    },
     "node_modules/css.escape": {
       "version": "1.5.1",
       "resolved": "https://registry.npmjs.org/css.escape/-/css.escape-1.5.1.tgz",
@@ -9340,6 +9524,16 @@
       "dev": true,
       "license": "BSD-2-Clause"
     },
+    "node_modules/data-uri-to-buffer": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-8.0.0.tgz",
+      "integrity": "sha512-6UHfyCux51b8PTGDgveqtz1tvphBku5DrMKKJbFAZAJOI2zsjDpDoYE1+QGj7FOMS4BdTFNJsJiR3zEB0xH0yQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/data-view-buffer": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/data-view-buffer/-/data-view-buffer-1.0.2.tgz",
@@ -9537,6 +9731,24 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/degenerator": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/degenerator/-/degenerator-7.0.1.tgz",
+      "integrity": "sha512-ABErK0IefDSyHjlPH7WUEenIAX2rPPnrDcDM+TS3z3+zu9TfyKKi07BQM+8rmxpdE2y1v5fjjdoAS/x4D2U60w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ast-types": "^0.13.4",
+        "escodegen": "^2.1.0",
+        "esprima": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 20"
+      },
+      "peerDependencies": {
+        "quickjs-wasi": "^2.2.0"
+      }
+    },
     "node_modules/depd": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
@@ -9648,6 +9860,78 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/dom-serializer": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz",
+      "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.2",
+        "entities": "^4.2.0"
+      },
+      "funding": {
+        "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+      }
+    },
+    "node_modules/dom-serializer/node_modules/entities": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz",
+      "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/domelementtype": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
+      "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/domhandler": {
+      "version": "5.0.3",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz",
+      "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "domelementtype": "^2.3.0"
+      },
+      "engines": {
+        "node": ">= 4"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domhandler?sponsor=1"
+      }
+    },
+    "node_modules/domutils": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz",
+      "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "dom-serializer": "^2.0.0",
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/domutils?sponsor=1"
+      }
+    },
     "node_modules/dotenv": {
       "version": "17.4.2",
       "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz",
@@ -9754,6 +10038,33 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/encoding-sniffer": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/encoding-sniffer/-/encoding-sniffer-0.2.1.tgz",
+      "integrity": "sha512-5gvq20T6vfpekVtqrYQsSCFZ1wEg5+wW0/QaZMWkFr6BqD3NfKs0rLCx4rrVlSWJeZb5NBJgVLswK/w2MWU+Gw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "iconv-lite": "^0.6.3",
+        "whatwg-encoding": "^3.1.1"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/encoding-sniffer?sponsor=1"
+      }
+    },
+    "node_modules/encoding-sniffer/node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/enhanced-resolve": {
       "version": "5.25.1",
       "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.25.1.tgz",
@@ -10050,6 +10361,28 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/escodegen": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-2.1.0.tgz",
+      "integrity": "sha512-2NlIDTwUWJN0mRPQOdtQBzbUHvdGY2P1VXSyU83Q3xKxM7WHX2Ql8dKq782Q9TgQUNOLEzEYu9bzLNj1q88I5w==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "esprima": "^4.0.1",
+        "estraverse": "^5.2.0",
+        "esutils": "^2.0.2"
+      },
+      "bin": {
+        "escodegen": "bin/escodegen.js",
+        "esgenerate": "bin/esgenerate.js"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "optionalDependencies": {
+        "source-map": "~0.6.1"
+      }
+    },
     "node_modules/eslint": {
       "version": "9.39.5",
       "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.5.tgz",
@@ -11667,6 +12000,21 @@
         "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
       }
     },
+    "node_modules/get-uri": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/get-uri/-/get-uri-8.0.1.tgz",
+      "integrity": "sha512-/5N/P4Lrh0p/mDwlDRi7Y1+P2o/OyzZI3l6Iz1Ov6XXwwm1y3RlZLuo3gVgML99djrEDtV980bBxSuOeHLk8ww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "basic-ftp": "^5.3.1",
+        "data-uri-to-buffer": "8.0.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/glob": {
       "version": "13.0.6",
       "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz",
@@ -12019,6 +12367,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/html-link-extractor": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/html-link-extractor/-/html-link-extractor-1.0.5.tgz",
+      "integrity": "sha512-ADd49pudM157uWHwHQPUSX4ssMsvR/yHIswOR5CUfBdK9g9ZYGMhVSE6KZVHJ6kCkR0gH4htsfzU6zECDNVwyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cheerio": "^1.0.0-rc.10"
+      }
+    },
     "node_modules/html-tags": {
       "version": "5.1.0",
       "resolved": "https://registry.npmjs.org/html-tags/-/html-tags-5.1.0.tgz",
@@ -12032,6 +12390,39 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/htmlparser2": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz",
+      "integrity": "sha512-VTZkM9GWRAtEpveh7MSF6SjjrpNVNNVJfFup7xTY3UpFtm67foy9HDVXneLtFVt4pMz5kZtgNcvCniNFb1hlEQ==",
+      "dev": true,
+      "funding": [
+        "https://github.com/fb55/htmlparser2?sponsor=1",
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fb55"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "domelementtype": "^2.3.0",
+        "domhandler": "^5.0.3",
+        "domutils": "^3.2.2",
+        "entities": "^7.0.1"
+      }
+    },
+    "node_modules/htmlparser2/node_modules/entities": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-7.0.1.tgz",
+      "integrity": "sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
     "node_modules/http-errors": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
@@ -12053,6 +12444,21 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/http-proxy-agent": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-9.1.0.tgz",
+      "integrity": "sha512-2NxoveTT58mjYT4n3RPTEfCZGLMbidoO8XEieXfpSYxu+PQJ1qpx4ypwH6N+uF9twBPIvRRgvkvW5HUTYWENig==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "9.0.0",
+        "debug": "^4.3.4",
+        "proxy-agent-negotiate": "1.1.0"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/http-proxy-middleware": {
       "version": "4.2.0",
       "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-4.2.0.tgz",
@@ -12070,6 +12476,21 @@
         "node": "^22.15.0 || ^24.0.0 || >=26.0.0"
       }
     },
+    "node_modules/https-proxy-agent": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-9.1.0.tgz",
+      "integrity": "sha512-ag87y7cJJ9/3+GxFr8Oy4O5faDsGRGnBGsJj/YjOSsSx/5eadKLYTMPlzuR6obgoCDDm0abAAZitXXQkMOPSpA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "9.0.0",
+        "debug": "^4.3.4",
+        "proxy-agent-negotiate": "1.1.0"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/httpxy": {
       "version": "0.5.5",
       "resolved": "https://registry.npmjs.org/httpxy/-/httpxy-0.5.5.tgz",
@@ -12343,6 +12764,16 @@
         "node": ">=10.13.0"
       }
     },
+    "node_modules/ip-address": {
+      "version": "10.7.2",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.7.2.tgz",
+      "integrity": "sha512-7H/2gFSIitxc0hG3nOI1glS8QLo/EHBFFLk8vEUjXY/xu0AdL8jZ9U1IzO2PUm0d2D/ofQcAifb0g6OBkt8U7w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
     "node_modules/ipaddr.js": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.5.0.tgz",
@@ -12353,6 +12784,19 @@
         "node": ">= 10"
       }
     },
+    "node_modules/is-absolute-url": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/is-absolute-url/-/is-absolute-url-4.0.1.tgz",
+      "integrity": "sha512-/51/TKE88Lmm7Gc4/8btclNXWS+g50wXhYJq8HWIBAGUBnoAdRu1aXeh364t/O7wXDAcTJDP8PNuNKWUDWie+A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-alphabetical": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz",
@@ -12837,6 +13281,22 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/is-relative-url": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/is-relative-url/-/is-relative-url-4.1.1.tgz",
+      "integrity": "sha512-WPsbw9cI2lRbH8j7/14e4dtq/jGIicXOBLlD5cuFhgQCBNgZUVJzU+xBi9pFhTkcTxZJY8l8osSxkhY3xY6emw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-absolute-url": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-set": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/is-set/-/is-set-2.0.3.tgz",
@@ -14911,6 +15371,20 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/link-check": {
+      "version": "5.6.0",
+      "resolved": "https://registry.npmjs.org/link-check/-/link-check-5.6.0.tgz",
+      "integrity": "sha512-oTHNw9+pgFvXqgTM3vWYOMkf4Pv5mywUr2L6EYkiRiVtpGrDXs8wV+kGP3bxBRwnC7gD3b9IRBu1dx/Tm1MFDQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-relative-url": "^4.1.0",
+        "ms": "^2.1.3",
+        "needle": "^3.5.0",
+        "node-email-verifier": "^4.0.0",
+        "proxy-agent": "^8.0.2"
+      }
+    },
     "node_modules/linkify-it": {
       "version": "6.1.0",
       "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-6.1.0.tgz",
@@ -15046,6 +15520,61 @@
       ],
       "license": "PSF-2.0"
     },
+    "node_modules/markdown-link-check": {
+      "version": "3.15.0",
+      "resolved": "https://registry.npmjs.org/markdown-link-check/-/markdown-link-check-3.15.0.tgz",
+      "integrity": "sha512-EorpVYNu1Jpldk3OLrRrH7Hx/ofp1dCSAJeYuvb8MhKR/rIt6S0tgwbQYw66EZgRPu9lPvORfT6SkIe0dwn2Ow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "async": "^3.2.6",
+        "chalk": "^6.0.0",
+        "commander": "^15.0.0",
+        "link-check": "^5.6.0",
+        "markdown-link-extractor": "^4.0.4",
+        "needle": "^3.5.0",
+        "progress": "^2.0.3",
+        "proxy-agent": "^8.0.2",
+        "xmlbuilder2": "^4.0.3"
+      },
+      "bin": {
+        "markdown-link-check": "markdown-link-check"
+      }
+    },
+    "node_modules/markdown-link-check/node_modules/chalk": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-6.0.1.tgz",
+      "integrity": "sha512-/Ce6KNm3vIbWdMlNna6RVIZ/ICQxnJxCicet5LBKK9ZffBkqzDw0xh9EiKSljdRtiIQ1S1z4YgcscUUGzNCWrA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=22"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/markdown-link-check/node_modules/commander": {
+      "version": "15.0.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz",
+      "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=22.12.0"
+      }
+    },
+    "node_modules/markdown-link-extractor": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/markdown-link-extractor/-/markdown-link-extractor-4.0.4.tgz",
+      "integrity": "sha512-Dw9saacqF4u1EjUm3O+f0ZTBM/o7l1IrdHS8z1KSFX2coECIcJTZbltICMKx6QwHBKlzMQXgtWYnIHX71WHZMw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "html-link-extractor": "^1.0.5",
+        "marked": "^18.0.7"
+      }
+    },
     "node_modules/markdownlint": {
       "version": "0.41.1",
       "resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.41.1.tgz",
@@ -15133,6 +15662,19 @@
         "js-yaml": "bin/js-yaml.mjs"
       }
     },
+    "node_modules/marked": {
+      "version": "18.0.14",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-18.0.14.tgz",
+      "integrity": "sha512-mBHK6FBHuBAlhgRe88w9F0O1AbwwXJUcQibUbC/QcdTbVGAD7aWza+xt3N6oT/jCZx3/OMeS+8rnuiHZcQ9s7A==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "marked": "bin/marked.js"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/math-intrinsics": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -16096,6 +16638,36 @@
         "node": ">=18"
       }
     },
+    "node_modules/needle": {
+      "version": "3.5.0",
+      "resolved": "https://registry.npmjs.org/needle/-/needle-3.5.0.tgz",
+      "integrity": "sha512-jaQyPKKk2YokHrEg+vFDYxXIHTCBgiZwSHOoVx/8V3GIBS8/VN6NdVRmg8q1ERtPkMvmOvebsgga4sAj5hls/w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "iconv-lite": "^0.6.3",
+        "sax": "^1.2.4"
+      },
+      "bin": {
+        "needle": "bin/needle"
+      },
+      "engines": {
+        "node": ">= 4.4.x"
+      }
+    },
+    "node_modules/needle/node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/negotiator": {
       "version": "0.6.4",
       "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.4.tgz",
@@ -16106,6 +16678,16 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/netmask": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/netmask/-/netmask-2.1.1.tgz",
+      "integrity": "sha512-eonl3sLUha+S1GzTPxychyhnUzKyeQkZ7jLjKrBagJgPla13F+uQ71HgpFefyHgqrjEbCPkDArxYsjY8/+gLKA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4.0"
+      }
+    },
     "node_modules/node-addon-api": {
       "version": "7.1.1",
       "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz",
@@ -16113,6 +16695,20 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/node-email-verifier": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/node-email-verifier/-/node-email-verifier-4.0.0.tgz",
+      "integrity": "sha512-W3ktpVPscUx43WSTm1Vf797cMQMsGwp0JO08ksRaZG8A8wcRUd/XAihL78FwYl2rfABa1m1nIsBtqOMxY9uekA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3",
+        "validator": "^13.15.20"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
     "node_modules/node-exports-info": {
       "version": "1.6.2",
       "resolved": "https://registry.npmjs.org/node-exports-info/-/node-exports-info-1.6.2.tgz",
@@ -16178,6 +16774,19 @@
         "node": ">=8"
       }
     },
+    "node_modules/nth-check": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
+      "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "boolbase": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/nth-check?sponsor=1"
+      }
+    },
     "node_modules/object-assign": {
       "version": "4.1.1",
       "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
@@ -16480,6 +17089,43 @@
         "node": ">=6"
       }
     },
+    "node_modules/pac-proxy-agent": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/pac-proxy-agent/-/pac-proxy-agent-9.1.0.tgz",
+      "integrity": "sha512-1aU+1mpj3DrQPfo3gh+3Gap3G5x+axnMx1P/y0ZF2ch7kb2meyOCAH8K2k9d27ROsTE7TnAerzxqF9aon2jqnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "9.0.0",
+        "debug": "^4.3.4",
+        "get-uri": "8.0.1",
+        "http-proxy-agent": "9.1.0",
+        "https-proxy-agent": "9.1.0",
+        "pac-resolver": "9.0.1",
+        "quickjs-wasi": "^2.2.0",
+        "socks-proxy-agent": "10.1.0"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/pac-resolver": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/pac-resolver/-/pac-resolver-9.0.1.tgz",
+      "integrity": "sha512-lJbS008tmkj08VhoM8Hzuv/VE5tK9MS0OIQ/7+s0lIF+BYhiQWFYzkSpML7lXs9iBu2jfmzBTLzhe9n6BX+dYw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "degenerator": "7.0.1",
+        "netmask": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 20"
+      },
+      "peerDependencies": {
+        "quickjs-wasi": "^2.2.0"
+      }
+    },
     "node_modules/package-json-from-dist": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
@@ -16539,6 +17185,59 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/parse5": {
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
+      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "entities": "^6.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/parse5-htmlparser2-tree-adapter": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-7.1.0.tgz",
+      "integrity": "sha512-ruw5xyKs6lrpo9x9rCZqZZnIUntICjQAd0Wsmp396Ul9lN/h+ifgVV1x1gZHi8euej6wTfpqX8j+BFQxF0NS/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "domhandler": "^5.0.3",
+        "parse5": "^7.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/parse5-parser-stream": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/parse5-parser-stream/-/parse5-parser-stream-7.1.2.tgz",
+      "integrity": "sha512-JyeQc9iwFLn5TbvvqACIF/VXG6abODeB3Fwmv/TGdLk2LfbWkaySGY72at4+Ty7EkPZj854u4CrICqNk2qIbow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "parse5": "^7.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/parse5/node_modules/entities": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
+      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -16986,6 +17685,16 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
+    "node_modules/progress": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
+      "integrity": "sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/prop-types": {
       "version": "15.8.1",
       "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
@@ -17033,6 +17742,64 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/proxy-agent": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/proxy-agent/-/proxy-agent-8.0.2.tgz",
+      "integrity": "sha512-idLLRewuemWd7GH/BDJzGiB0dWGfT2SQs3jy6NtZtGWU9uPTTSdeC1/cdbqLwgzhfv027daGFuXX426e2Eg20A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "9.0.0",
+        "debug": "^4.3.4",
+        "http-proxy-agent": "9.1.0",
+        "https-proxy-agent": "9.1.0",
+        "lru-cache": "^7.14.1",
+        "pac-proxy-agent": "9.1.0",
+        "proxy-from-env": "^2.0.0",
+        "socks-proxy-agent": "10.1.0"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
+    "node_modules/proxy-agent-negotiate": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-agent-negotiate/-/proxy-agent-negotiate-1.1.0.tgz",
+      "integrity": "sha512-N8IBcM3UgCVzz2L2Lqv8DVntDnnC8/hiV4nEDUPkqq72TPUgYWjQc+bdZlBPZK9LzPAvOY//gAt0S0DApoOXWQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20"
+      },
+      "peerDependencies": {
+        "kerberos": "^2.0.0"
+      },
+      "peerDependenciesMeta": {
+        "kerberos": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/proxy-agent/node_modules/lru-cache": {
+      "version": "7.18.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz",
+      "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/proxy-from-env": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-2.1.0.tgz",
+      "integrity": "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      }
+    },
     "node_modules/punycode": {
       "version": "2.3.1",
       "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
@@ -17148,6 +17915,13 @@
       ],
       "license": "MIT"
     },
+    "node_modules/quickjs-wasi": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/quickjs-wasi/-/quickjs-wasi-2.2.0.tgz",
+      "integrity": "sha512-zQxXmQMrEoD3S+jQdYsloq4qAuaxKFHZj6hHqOYGwB2iQZH+q9e/lf5zQPXCKOk0WJuAjzRFbO4KwHIp2D05Iw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/range-parser": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.3.0.tgz",
@@ -17640,6 +18414,16 @@
         }
       }
     },
+    "node_modules/sax": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz",
+      "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=11.0.0"
+      }
+    },
     "node_modules/scheduler": {
       "version": "0.23.2",
       "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
@@ -18121,6 +18905,17 @@
         "url": "https://github.com/chalk/slice-ansi?sponsor=1"
       }
     },
+    "node_modules/smart-buffer": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/smart-buffer/-/smart-buffer-4.2.0.tgz",
+      "integrity": "sha512-94hK0Hh8rPqQl2xXc3HsaBoOXKV20MToPkcXvwbISWLEs+64sBq5kFgn2kJDHb1Pry9yrP0dxrCI9RRci7RXKg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 6.0.0",
+        "npm": ">= 3.0.0"
+      }
+    },
     "node_modules/smol-toml": {
       "version": "1.8.0",
       "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz",
@@ -18134,6 +18929,36 @@
         "url": "https://github.com/sponsors/cyyynthia"
       }
     },
+    "node_modules/socks": {
+      "version": "2.8.10",
+      "resolved": "https://registry.npmjs.org/socks/-/socks-2.8.10.tgz",
+      "integrity": "sha512-e0VyvkVTwVYViNovRkZ9aodhxVlyoMn7eJhVUPxZ+eK9P/7CBkxvvsBOHqFPEH416726W8tLXXXjKwqgTErrCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ip-address": "^10.1.1",
+        "smart-buffer": "^4.2.0"
+      },
+      "engines": {
+        "node": ">= 10.0.0",
+        "npm": ">= 3.0.0"
+      }
+    },
+    "node_modules/socks-proxy-agent": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/socks-proxy-agent/-/socks-proxy-agent-10.1.0.tgz",
+      "integrity": "sha512-WlMj/67cEJ6MDI1OcsnjuYKDNDoyPCCYZ249kuuXPiMDw9F8PXkVaQ7YWu3siTydfQ/4BEZcvGzu+aYvz7dDCQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "9.0.0",
+        "debug": "^4.3.4",
+        "socks": "^2.8.3"
+      },
+      "engines": {
+        "node": ">= 20"
+      }
+    },
     "node_modules/source-map": {
       "version": "0.6.1",
       "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
@@ -19762,6 +20587,16 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/undici": {
+      "version": "7.30.0",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-7.30.0.tgz",
+      "integrity": "sha512-dkrQXeHSaoamnItlYbmzG0wFYrM0ZwDxCIg0A7aKjTyyhh9svRzCNFEzV+Vm05/yehjCzjDZ31KXfGEjYSztDQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.18.1"
+      }
+    },
     "node_modules/undici-types": {
       "version": "8.9.0",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.9.0.tgz",
@@ -19937,6 +20772,16 @@
         "node": ">=10.12.0"
       }
     },
+    "node_modules/validator": {
+      "version": "13.15.35",
+      "resolved": "https://registry.npmjs.org/validator/-/validator-13.15.35.tgz",
+      "integrity": "sha512-TQ5pAGhd5whStmqWvYF4OjQROlmv9SMFVt37qoCBdqRffuuklWYQlCNnEs2ZaIBD1kZRNnikiZOS1eqgkar0iw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/vary": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
@@ -20192,6 +21037,33 @@
         "npm": ">=5.0.0"
       }
     },
+    "node_modules/whatwg-encoding": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",
+      "integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==",
+      "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "iconv-lite": "0.6.3"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/whatwg-encoding/node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/whatwg-mimetype": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-3.0.0.tgz",
@@ -20491,6 +21363,22 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/xmlbuilder2": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/xmlbuilder2/-/xmlbuilder2-4.0.3.tgz",
+      "integrity": "sha512-bx8Q1STctnNaaDymWnkfQLKofs0mGNN7rLLapJlGuV3VlvegD7Ls4ggMjE3aUSWItCCzU0PEv45lI87iSigiCA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@oozcitak/dom": "^2.0.2",
+        "@oozcitak/infra": "^2.0.2",
+        "@oozcitak/util": "^10.0.0",
+        "js-yaml": "^4.1.1"
+      },
+      "engines": {
+        "node": ">=20.0"
+      }
+    },
     "node_modules/y18n": {
       "version": "5.0.8",
       "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
diff --git a/package.json b/package.json
index 37709fb19..2c81b6e78 100644
--- a/package.json
+++ b/package.json
@@ -65,7 +65,10 @@
     "copy:css": "cp src/docs/_assets/generated/react-ui.css dist && cp src/docs/_assets/generated/react-ui.development.css dist",
     "copy:js": "cp src/docs/_assets/generated/react-ui.js dist && cp src/docs/_assets/generated/react-ui.development.js dist",
     "eslint": "eslint src tests",
-    "lint": "npm run eslint && npm run markdownlint && npm run stylelint && npm run typecheck",
+    "lint": "npm run eslint && npm run markdownlint && npm run stylelint && npm run typecheck && npm run markdown-link-check",
+    "markdown-link-check": "npm run markdown-link-check:internal && npm run markdown-link-check:external",
+    "markdown-link-check:external": "markdown-link-check --config .markdown-link-check-external.json --quiet README.md CLAUDE.md LICENSE.md .claude scripts src",
+    "markdown-link-check:internal": "markdown-link-check --config .markdown-link-check-internal.json --quiet README.md CLAUDE.md LICENSE.md .claude scripts src",
     "markdownlint": "markdownlint-cli2 \"README.md\" \"src/**/*.md\"",
     "postbuild": "npm run copy && npm run build:types",
     "postinstall": "sh scripts/write-lockfile-hash.sh",
@@ -119,6 +122,7 @@
     "eslint": "^9.39.5",
     "identity-obj-proxy": "^3.0.0",
     "jest": "^30.5.1",
+    "markdown-link-check": "^3.15.0",
     "markdownlint-cli2": "^0.23.3",
     "mini-css-extract-plugin": "^2.10.2",
     "postcss": "^8.5.28",
@@ -140,6 +144,7 @@
   "overrides": {
     "babel-preset-current-node-syntax": {
       "@babel/core": "$@babel/core"
-    }
+    },
+    "basic-ftp": "^6.2.1"
   }
 }
diff --git a/src/docs/contribute/testing-guidelines.md b/src/docs/contribute/testing-guidelines.md
index 88c1b3010..f2a87178e 100644
--- a/src/docs/contribute/testing-guidelines.md
+++ b/src/docs/contribute/testing-guidelines.md
@@ -5,6 +5,7 @@ Tools used to test the application:
 * **ESLint** (static code analysis of TypeScript files)
 * **Stylelint** (static code analysis of CSS files)
 * **Markdownlint** (static code analysis of Markdown files)
+* **Markdown link check** (checking links in Markdown files)
 * **Jest** (unit tests)
 * **Playwright** (visual and functional component testing)
 
@@ -19,7 +20,7 @@ You can run all tests with a single command:
 npm run lint && npm test && npm run test:playwright-ct:all
 ```
 
-### Linters (ESLint, Markdownlint, Stylelint)
+### Linters (ESLint, Markdownlint, Markdown link check, Stylelint)
 
 Run linters either all together:
 
@@ -30,7 +31,7 @@ npm run lint
 or run linters individually:
 
 ```bash
-npm run <eslint|markdownlint|stylelint>
+npm run <eslint|markdownlint|markdown-link-check|stylelint>
 ```
 
 ### Jest