Canonical: https://thehedgeling.com/docs/quickstart
Language: en-US

[← All docs](https://thehedgeling.com/docs)

Documentation

# Quick start

Go from hardcoded strings to a translated app in minutes. No `t()` calls to write, no keys to manage — extract, translate, ship.

## React + Vite

- ### 1Install

Requires Node.js 20+ and a Hedgeling seat token, which every plan includes. See the React + Vite guide for registry setup, configuration, and troubleshooting.

$ npm install @hedgeling/i18n

- ### 2Configure extraction

.hedgeling/extract.config.json

{ "sourceLocale": "en-US", "locales": \["fr-FR", "de-DE"\], "scanRoots": \["src"\] }

- ### 3Add the build plugin

vite.config.ts

Not on Vite? The same plugin is built on unplugin and ships entry points for webpack, Rollup, Rspack, and esbuild — import from @hedgeling/i18n/webpack, /rollup, /rspack, or /esbuild instead.

import { hedgelingI18n } from "@hedgeling/i18n/vite";

export default defineConfig({ plugins: \[react(), hedgelingI18n()\] });

- ### 4Wrap your app

main.tsx

import { HedgelingProvider } from "@hedgeling/i18n/runtime";

<HedgelingProvider><App /></HedgelingProvider>

- ### 5Extract and translate

The --no-mt pass generates artifacts without machine translation. Configure a provider and review scope and cost before running translate without this flag.

$ npx hedgeling extract --write

$ npx hedgeling translate --no-mt

## Other setups

### Vue, Svelte & SvelteKit

The same bundler plugin auto-wraps Vue SFCs and Svelte 4/5 components (runes included). Point it at your Vite, webpack, Rollup, Rspack, or esbuild build and run the same extract and translate commands.

### Angular

Angular keeps its own path: an ng generate schematic wraps templates, and translations are delivered by the runtime injector.

### Any site, no build step

Drop the DOM injector script into any page — it translates rendered content by matching it against your bundle, with a MutationObserver for dynamic content. No code changes, no rebuild.

Full framework guides, the configuration reference, and the diagnostics catalog ship with the package — deeper docs are coming to this site.