intlayer-astro · diff
git:20260528.1d463bc to git:20260923.e86be10
38 added, 4 removed. Audit A to A.
---
name: intlayer-astro
description: Integrates Intlayer internationalization with Astro applications. Use when the user asks to "setup Astro i18n", use "getIntlayer" in Astro components, or manage server-side content in Astro.
metadata:
author: Intlayer
url: https://intlayer.org
license: Apache-2.0
mcp-server: "@intlayer/mcp"
category: productivity
tags: [i18n]
documentation: https://intlayer.org/doc
support: contact@intlayer.org
---
# Intlayer Astro Usage
## Setup
- [Astro](references/environment_astro.md)
+ The `intlayer()` integration in `astro.config.ts` builds the dictionaries and adds a middleware that resolves the locale of every request into `Astro.locals.intlayer`.
+
## Server-side (Astro Components)
```astro
---
- import { getIntlayer } from "astro-intlayer";
- const content = await getIntlayer("my-dictionary-key");
+ import { useIntlayer, useLocale } from "astro-intlayer";
+
+ // Locale resolved by the middleware (e.g. /es/about -> 'es')
+ const { locale } = useLocale();
+ const content = useIntlayer("my-dictionary-key");
---
<h1>{content.title}</h1>
```
- [Astro Documentation](references/environment_astro.md)
+ ## Framework Islands
+ Islands use their framework package (`react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `lit-intlayer`) and receive the server-detected locale as a prop.
+
+ ## Compiler
+
+ The [Intlayer Compiler](references/compiler.md) can extract all your content keys from your components, using one CLI command (`npx intlayer extract`) or automatically at app build.
+
## References
- [Website](https://intlayer.org)
- - [Doc](references/concept_cli.md)
+ - [Doc](https://intlayer.org/doc)
+ ### Environments
+
- [Astro](references/environment_astro.md)
+ - [Astro and React](references/environment_astro_react.md)
+ - [Astro and Vue](references/environment_astro_vue.md)
+ - [Astro and Svelte](references/environment_astro_svelte.md)
+ - [Astro and Solid](references/environment_astro_solid.md)
+ - [Astro and Preact](references/environment_astro_preact.md)
+ - [Astro and Lit](references/environment_astro_lit.md)
+
+ ### Concepts
+
+ - [Variants](references/concept_variants.md)
+ - [Collections](references/concept_collections.md)
+ - [Compiler](references/compiler.md)
+ - [Formatters (number, currency, date, …)](references/formatters.md)
+
+ ### Packages
+
- [Intlayer Exports](references/packages_intlayer_exports.md)
- [Astro Intlayer Exports](references/packages_astro-intlayer_exports.md)
+ - [astro-intlayer intlayer](references/packages_astro-intlayer_intlayer.md)
+ - [astro-intlayer onRequest](references/packages_astro-intlayer_onRequest.md)
+ - [astro-intlayer useDictionary](references/packages_astro-intlayer_useDictionary.md)
+ - [astro-intlayer useIntlayer](references/packages_astro-intlayer_useIntlayer.md)
+ - [astro-intlayer useLocale](references/packages_astro-intlayer_useLocale.md)