Advanced

Migration Guide

Moving to pico-intl from another library? Here are side-by-side comparisons and CLI helpers to automate the heavy lifting.

npx pico-intl import --from i18next --input ./src/locales
npx pico-intl export --to react-intl --output ./translations

Key points

• Start by importing catalogs, not rewriting every component at once.
• Move simple interpolation, plural, and select messages first.
• Manually review rich text and complex ICU messages.

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.