intl-party

Type-safe internationalization for React and Next.js with zero-config setup, automatic type generation, clean URLs, hot-reloading translations, and first-class App Router support. Built to make i18n feel like a party, not a chore.

STATUS

ACTIVE

STACK

TypeScriptReactNext.jsICU MessageFormat

REPOSITORY

github.com/RodrigoEspinosa/intl-party

LINK

www.npmjs.com/org/intl-party

1. STEP 01

   Install

   bash

   npm install @intl-party/nextjs

2. STEP 02

   Initialize

   Scaffolds config, middleware, message files, and example components.

   bash

   npx intl-party nextjs --init

3. STEP 03

   Use it

   Type-safe translations in any server or client component.

   tsx

   import { useTranslations } from '@intl-party/nextjs';
   
   export default function HomePage() {
     const t = useTranslations('common');
   
     return (
       <div>
         <h1>{t('welcome')}</h1>
         <p>{t('description', { name: 'John' })}</p>
       </div>
     );
   }

Configure

// intl-party.config.ts
export default {
  locales: ['en', 'es', 'fr'],
  defaultLocale: 'en',
  messages: './messages',
  // localePrefix: 'never', // clean URLs, no /en/
};

• Scaffold i18n in a Next.js project

  npx intl-party nextjs --init

• Generate TypeScript types from translation files

  npx intl-party generate --types

• Watch translation files and regenerate types

  npx intl-party generate --types --watch

• Find missing translations across locales

  npx intl-party check --missing

• Validate translation format (ICU, interpolation)

  npx intl-party validate

• @intl-party/nextjsNext.js integration. The main package — start here.
• @intl-party/coreCore internationalization library. Framework-agnostic.
• @intl-party/reactReact hooks and components for any React app.
• @intl-party/cliCommand-line tools for type generation and validation.