Renovate Bot
0b6adbb151
This PR contains the following updates: | Package | Change | Age | Adoption | Passing | Confidence | |---|---|---|---|---|---| | [@astrojs/mdx](https://docs.astro.build/en/guides/integrations-guide/mdx/) ([source](https://github.com/withastro/astro/tree/HEAD/packages/integrations/mdx)) | [`4.3.3` -> `4.3.4`](https://renovatebot.com/diffs/npm/@astrojs%2fmdx/4.3.3/4.3.4) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | | [@astrojs/node](https://docs.astro.build/en/guides/integrations-guide/node/) ([source](https://github.com/withastro/astro/tree/HEAD/packages/integrations/node)) | [`9.3.3` -> `9.4.3`](https://renovatebot.com/diffs/npm/@astrojs%2fnode/9.3.3/9.4.3) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | | [astro](https://astro.build) ([source](https://github.com/withastro/astro/tree/HEAD/packages/astro)) | [`5.12.8` -> `5.13.3`](https://renovatebot.com/diffs/npm/astro/5.12.8/5.13.3) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | --- ### Release Notes <details> <summary>withastro/astro (@​astrojs/mdx)</summary> ### [`v4.3.4`](https://github.com/withastro/astro/blob/HEAD/packages/integrations/mdx/CHANGELOG.md#434) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/mdx@4.3.3...@astrojs/mdx@4.3.4) ##### Patch Changes - Updated dependencies \[]: - [@​astrojs/markdown-remark](https://github.com/astrojs/markdown-remark)@​6.3.6 </details> <details> <summary>withastro/astro (@​astrojs/node)</summary> ### [`v9.4.3`](https://github.com/withastro/astro/blob/HEAD/packages/integrations/node/CHANGELOG.md#943) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/node@9.4.2...@astrojs/node@9.4.3) ##### Patch Changes - [#​14240](https://github.com/withastro/astro/pull/14240) [`77b18fb`](77b18fb1f8) Thanks [@​delucis](https://github.com/delucis)! - Increases the minimum supported version of Astro to 5.7.0 ### [`v9.4.2`](https://github.com/withastro/astro/blob/HEAD/packages/integrations/node/CHANGELOG.md#942) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/node@9.4.1...@astrojs/node@9.4.2) ##### Patch Changes - Updated dependencies \[[`4d16de7`](4d16de7f95)]: - [@​astrojs/internal-helpers](https://github.com/astrojs/internal-helpers)@​0.7.2 ### [`v9.4.1`](https://github.com/withastro/astro/blob/HEAD/packages/integrations/node/CHANGELOG.md#941) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/node@9.4.0...@astrojs/node@9.4.1) ##### Patch Changes - [`5fc3c59`](5fc3c599ca) Thanks [@​ematipico](https://github.com/ematipico)! - Fixes a routing bug in standalone mode with `trailingSlash` set to `"always"`. ### [`v9.4.0`](https://github.com/withastro/astro/blob/HEAD/packages/integrations/node/CHANGELOG.md#940) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/node@9.3.3...@astrojs/node@9.4.0) ##### Minor Changes - [#​14188](https://github.com/withastro/astro/pull/14188) [`e3422aa`](e3422aa423) Thanks [@​ascorbic](https://github.com/ascorbic)! - Adds support for specifying a host to load prerendered error pages By default, if a user defines a custom error page that is prerendered, Astro will load it from the same host as the one that the request is made to. This change allows users to specify a different host for loading prerendered error pages. This can be useful in scenarios such as where the server is running behind a reverse proxy or when prerendered pages are hosted on a different domain. To use this feature, set the `experimentalErrorPageHost` adapter option in your Astro configuration to the desired host URL. For example, if your server is running on localhost and served via a proxy, you can ensure the prerendered error pages are fetched via the localhost URL: ```js import { defineConfig } from 'astro/config'; import node from '@​astrojs/node'; export default defineConfig({ adapter: node({ // If your server is running on localhost and served via a proxy, set the host like this to ensure prerendered error pages are fetched via the localhost URL experimentalErrorPageHost: 'http://localhost:4321', }), }); ``` For more information on enabling and using this experimental feature, see the [`@astrojs/node` adapter docs](https://docs.astro.build/en/guides/integrations-guide/node/#experimentalerrorpagehost). </details> <details> <summary>withastro/astro (astro)</summary> ### [`v5.13.3`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5133) [Compare Source](https://github.com/withastro/astro/compare/astro@5.13.2...astro@5.13.3) ##### Patch Changes - [#​14239](https://github.com/withastro/astro/pull/14239) [`d7d93e1`](d7d93e19fb) Thanks [@​wtchnm](https://github.com/wtchnm)! - Fixes a bug where the types for the live content collections were not being generated correctly in dev mode - [#​14221](https://github.com/withastro/astro/pull/14221) [`eadc9dd`](eadc9dd277) Thanks [@​delucis](https://github.com/delucis)! - Fixes JSON schema support for content collections using the `file()` loader - [#​14229](https://github.com/withastro/astro/pull/14229) [`1a9107a`](1a9107a404) Thanks [@​jonmichaeldarby](https://github.com/jonmichaeldarby)! - Ensures `Astro.currentLocale` returns the correct locale during SSG for pages that use a locale param (such as `[locale].astro` or `[locale]/index.astro`, which produce `[locale].html`) ### [`v5.13.2`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5132) [Compare Source](https://github.com/withastro/astro/compare/astro@5.13.1...astro@5.13.2) ##### Patch Changes - [`4d16de7`](4d16de7f95) Thanks [@​ematipico](https://github.com/ematipico)! - Improves the detection of remote paths in the `_image` endpoint. Now `href` parameters that start with `//` are considered remote paths. - Updated dependencies \[[`4d16de7`](4d16de7f95)]: - [@​astrojs/internal-helpers](https://github.com/astrojs/internal-helpers)@​0.7.2 - [@​astrojs/markdown-remark](https://github.com/astrojs/markdown-remark)@​6.3.6 ### [`v5.13.1`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5131) [Compare Source](https://github.com/withastro/astro/compare/astro@5.13.0...astro@5.13.1) ##### Patch Changes - [#​14225](https://github.com/withastro/astro/pull/14225) [`f2490ab`](f2490aba42) Thanks [@​delucis](https://github.com/delucis)! - Fixes the `experimental.chromeDevtoolsWorkspace` feature. ### [`v5.13.0`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5130) [Compare Source](https://github.com/withastro/astro/compare/astro@5.12.9...astro@5.13.0) ##### Minor Changes - [#​14173](https://github.com/withastro/astro/pull/14173) [`39911b8`](39911b823d) Thanks [@​florian-lefebvre](https://github.com/florian-lefebvre)! - Adds an experimental flag `staticImportMetaEnv` to disable the replacement of `import.meta.env` values with `process.env` calls and their coercion of environment variable values. This supersedes the `rawEnvValues` experimental flag, which is now removed. Astro allows you to configure a [type-safe schema for your environment variables](https://docs.astro.build/en/guides/environment-variables/#type-safe-environment-variables), and converts variables imported via `astro:env` into the expected type. This is the recommended way to use environment variables in Astro, as it allows you to easily see and manage whether your variables are public or secret, available on the client or only on the server at build time, and the data type of your values. However, you can still access environment variables through `process.env` and `import.meta.env` directly when needed. This was the only way to use environment variables in Astro before `astro:env` was added in Astro 5.0, and Astro's default handling of `import.meta.env` includes some logic that was only needed for earlier versions of Astro. The `experimental.staticImportMetaEnv` flag updates the behavior of `import.meta.env` to align with [Vite's handling of environment variables](https://vite.dev/guide/env-and-mode.html#env-variables) and for better ease of use with Astro's current implementations and features. **This will become the default behavior in Astro 6.0**, and this early preview is introduced as an experimental feature. Currently, non-public `import.meta.env` environment variables are replaced by a reference to `process.env`. Additionally, Astro may also convert the value type of your environment variables used through `import.meta.env`, which can prevent access to some values such as the strings `"true"` (which is converted to a boolean value), and `"1"` (which is converted to a number). The `experimental.staticImportMetaEnv` flag simplifies Astro's default behavior, making it easier to understand and use. Astro will no longer replace any `import.meta.env` environment variables with a `process.env` call, nor will it coerce values. To enable this feature, add the experimental flag in your Astro config and remove `rawEnvValues` if it was enabled: ```diff // astro.config.mjs import { defineConfig } from "astro/config"; export default defineConfig({ + experimental: { + staticImportMetaEnv: true - rawEnvValues: false + } }); ``` ##### Updating your project If you were relying on Astro's default coercion, you may need to update your project code to apply it manually: ```diff // src/components/MyComponent.astro - const enabled: boolean = import.meta.env.ENABLED; + const enabled: boolean = import.meta.env.ENABLED === "true"; ``` If you were relying on the transformation into `process.env` calls, you may need to update your project code to apply it manually: ```diff // src/components/MyComponent.astro - const enabled: boolean = import.meta.env.DB_PASSWORD; + const enabled: boolean = process.env.DB_PASSWORD; ``` You may also need to update types: ```diff // src/env.d.ts interface ImportMetaEnv { readonly PUBLIC_POKEAPI: string; - readonly DB_PASSWORD: string; - readonly ENABLED: boolean; + readonly ENABLED: string; } interface ImportMeta { readonly env: ImportMetaEnv; } + namespace NodeJS { + interface ProcessEnv { + DB_PASSWORD: string; + } + } ``` See the [experimental static `import.meta.env` documentation](https://docs.astro.build/en/reference/experimental-flags/static-import-meta-env/) for more information about this feature. You can learn more about using environment variables in Astro, including `astro:env`, in the [environment variables documentation](https://docs.astro.build/en/guides/environment-variables/). - [#​14122](https://github.com/withastro/astro/pull/14122) [`41ed3ac`](41ed3ac54a) Thanks [@​ascorbic](https://github.com/ascorbic)! - Adds experimental support for automatic [Chrome DevTools workspace folders](https://developer.chrome.com/docs/devtools/workspaces) This feature allows you to edit files directly in the browser and have those changes reflected in your local file system via a connected workspace folder. This allows you to apply edits such as CSS tweaks without leaving your browser tab! With this feature enabled, the Astro dev server will automatically configure a Chrome DevTools workspace for your project. Your project will then appear as a workspace source, ready to connect. Then, changes that you make in the "Sources" panel are automatically saved to your project source code. To enable this feature, add the experimental flag `chromeDevtoolsWorkspace` to your Astro config: ```js // astro.config.mjs import { defineConfig } from 'astro/config'; export default defineConfig({ experimental: { chromeDevtoolsWorkspace: true, }, }); ``` See the [experimental Chrome DevTools workspace feature documentation](https://docs.astro.build/en/reference/experimental-flags/chrome-devtools-workspace/) for more information. ### [`v5.12.9`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5129) [Compare Source](https://github.com/withastro/astro/compare/astro@5.12.8...astro@5.12.9) ##### Patch Changes - [#​14020](https://github.com/withastro/astro/pull/14020) [`9518975`](9518975539) Thanks [@​jp-knj](https://github.com/jp-knj) and [@​asieradzk](https://github.com/asieradzk)! - Prevent double-prefixed redirect paths when using fallback and redirectToDefaultLocale together Fixes an issue where i18n fallback routes would generate double-prefixed paths (e.g., `/es/es/test/item1/`) when `fallback` and `redirectToDefaultLocale` configurations were used together. The fix adds proper checks to prevent double prefixing in route generation. - [#​14199](https://github.com/withastro/astro/pull/14199) [`3e4cb8e`](3e4cb8e52a) Thanks [@​ascorbic](https://github.com/ascorbic)! - Fixes a bug that prevented HMR from working with inline styles </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox. 👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0MS4xLjMiLCJ1cGRhdGVkSW5WZXIiOiI0MS4zNS4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJhdXRvbWVyZ2UiLCJkZXBlbmRlbmN5Il19--> Reviewed-on: #4 Co-authored-by: Renovate Bot <renovate-bot@alexlebens.net> Co-committed-by: Renovate Bot <renovate-bot@alexlebens.net>
Starlight Starter Kit: Basics
pnpm create astro@latest -- --template starlight
🧑🚀 Seasoned astronaut? Delete this file. Have fun!
🚀 Project Structure
Inside of your Astro + Starlight project, you'll see the following folders and files:
.
├── public/
├── src/
│ ├── assets/
│ ├── content/
│ │ └── docs/
│ └── content.config.ts
├── astro.config.mjs
├── package.json
└── tsconfig.json
Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.
Images can be added to src/assets/ and embedded in Markdown with a relative link.
Static assets, like favicons, can be placed in the public/ directory.
🧞 Commands
All commands are run from the root of the project, from a terminal:
| Command | Action |
|---|---|
pnpm install |
Installs dependencies |
pnpm dev |
Starts local dev server at localhost:4321 |
pnpm build |
Build your production site to ./dist/ |
pnpm preview |
Preview your build locally, before deploying |
pnpm astro ... |
Run CLI commands like astro add, astro check |
pnpm astro -- --help |
Get help using the Astro CLI |
👀 Want to learn more?
Check out Starlight’s docs, read the Astro documentation, or jump into the Astro Discord server.