aymericzip/intlayer-skills / skills/intlayer-vanilla
intlayer-vanilla
VerifiedIntegrates Intlayer internationalization with plain JavaScript / TypeScript (no UI framework). Use when the user asks to "setup Vanilla JS i18n", translate a static HTML page, use "useIntlayer" without a framework, or switch locale in a vanilla application.
| File | Kind | Size |
|---|---|---|
| LICENCE.md | markdown | 10.7 KB |
| SKILL.md | skill md | 3.0 KB |
| references/compiler.md | markdown | 14.6 KB |
| references/concept_collections.md | markdown | 5.6 KB |
| references/concept_variants.md | markdown | 20.9 KB |
| references/environment_vanilla.md | markdown | 28.4 KB |
| references/environment_vite-and-vanilla.md | markdown | 39.7 KB |
| references/formatters.md | markdown | 17.3 KB |
| references/packages_intlayer_exports.md | markdown | 12.4 KB |
SKILL.md
View on GitHub---
name: intlayer-vanilla
description: Integrates Intlayer internationalization with plain JavaScript / TypeScript (no UI framework). Use when the user asks to "setup Vanilla JS i18n", translate a static HTML page, use "useIntlayer" without a framework, or switch locale in a vanilla application.
metadata:
author: Intlayer
url: https://intlayer.org
license: Apache-2.0
mcp-server: "@intlayer/mcp"
category: productivity
tags: [i18n, vanilla, javascript, vite]
documentation: https://intlayer.org/doc
support: contact@intlayer.org
---
# Intlayer Vanilla JS Usage
## Core Philosophy
Intlayer promotes **Component-Level Content Declaration**. Instead of a massive global translation file, content is declared in `*.content.ts` files adjacent to the scripts that use them.
`vanilla-intlayer` mirrors the `react-intlayer` API without depending on a UI framework: a pub/sub singleton plus callback-based helpers.
### Declare Content
**File:** `src/app.content.ts`
```typescript
import { t, type Dictionary } from "intlayer";
const content = {
key: "app",
content: {
title: t({
en: "Welcome",
fr: "Bienvenue",
es: "Hola",
}),
},
} satisfies Dictionary;
export default content;
```
## Setup
- [Vite and Vanilla JS](references/environment_vite-and-vanilla.md) (bundled app)
- [Vanilla JS](references/environment_vanilla.md) (no bundler, standalone script generated by `intlayer standalone`)
Call `installIntlayer()` **before** any content is rendered.
## useIntlayer
`useIntlayer(key, locale?)` returns the content directly. Chain `.onChange()` to re-render when the locale changes.
```typescript
import { useIntlayer } from "vanilla-intlayer";
const title = document.querySelector("h1")!;
const content = useIntlayer("app").onChange((newContent) => {
title.textContent = String(newContent.title);
});
title.textContent = String(content.title);
// Native attributes: use `.value`
// image.alt = content.title.value;
```
> Without a bundler, read the same helpers from the globals of the standalone bundle: `window.VanillaIntlayer` and `window.Intlayer`.
## useLocale
```typescript
import { useLocale } from "vanilla-intlayer";
const { locale, availableLocales, setLocale, subscribe } = useLocale();
const unsubscribe = subscribe((newLocale) => {
document.documentElement.lang = newLocale;
});
setLocale("fr");
```
## 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](https://intlayer.org/doc)
### Environments
- [Vite and Vanilla JS](references/environment_vite-and-vanilla.md)
- [Vanilla JS](references/environment_vanilla.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)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |