Getting Started

Introduction

pico-intl is a small, zero-dependency internationalization toolkit for JavaScript and TypeScript. The core is framework-independent, and the supported adapters are verified through a shared behavioral contract.

ts
import { createI18n } from '@pico-intl-dev/core';

const i18n = createI18n({
  base: 'en',
  locale: 'en',
  messages: {
    hello: 'Hello, {{name}}',
  },
});

i18n.t('hello', { name: 'Ana' });

Key points

  • Plain JSON catalogs stay portable across frameworks.
  • Core has zero runtime dependencies; adapters are opt-in and contract-tested.
  • Stable v1.0.6 covers the documented runtime, framework adapter contract, file-based CLI workflows, and optional full ICU resolver.

Next step

Copy the example into a small fixture, run the validation commands, and keep framework-specific routing, hydration, or SSR behavior covered by your app tests.