{"id":47663767,"url":"https://github.com/usefluenti/fluenti","last_synced_at":"2026-04-02T11:48:08.627Z","repository":{"id":344820112,"uuid":"1182159309","full_name":"usefluenti/fluenti","owner":"usefluenti","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-01T03:59:36.000Z","size":4874,"stargazers_count":4,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-01T04:48:52.797Z","etag":null,"topics":["ai-translation","compiler","developer-tools","i18n","internationalization","l10n","localization","nextjs","nuxt","react","solidjs","translation","vite","vue"],"latest_commit_sha":null,"homepage":"https://fluenti.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usefluenti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-15T05:45:37.000Z","updated_at":"2026-04-01T03:59:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/usefluenti/fluenti","commit_stats":null,"previous_names":["usefluenti/fluenti"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/usefluenti/fluenti","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usefluenti%2Ffluenti","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usefluenti%2Ffluenti/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usefluenti%2Ffluenti/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usefluenti%2Ffluenti/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usefluenti","download_url":"https://codeload.github.com/usefluenti/fluenti/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usefluenti%2Ffluenti/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31305809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T09:48:21.550Z","status":"ssl_error","status_checked_at":"2026-04-02T09:48:19.196Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-translation","compiler","developer-tools","i18n","internationalization","l10n","localization","nextjs","nuxt","react","solidjs","translation","vite","vue"],"created_at":"2026-04-02T11:48:07.931Z","updated_at":"2026-04-02T11:48:08.610Z","avatar_url":"https://github.com/usefluenti.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/usefluenti/brand/main/logo-icon.svg\" width=\"140\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eFluenti\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  Framework-agnostic, compile-time i18n — one codebase for Vue, React, Solid, and any framework.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@fluenti/core\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@fluenti/core?color=4f46e5\u0026label=\" alt=\"npm version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@fluenti/core\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/@fluenti/core?color=6366f1\u0026label=\" alt=\"npm downloads\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/usefluenti/fluenti/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/usefluenti/fluenti/ci.yml?label=CI\" alt=\"CI\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/usefluenti/fluenti/actions/workflows/e2e.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/usefluenti/fluenti/e2e.yml?label=E2E\" alt=\"E2E\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/tests-3388%20unit%20%2B%20144%20e2e-4caf50\" alt=\"tests\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/coverage-97%25-4caf50\" alt=\"coverage\" /\u003e\n  \u003ca href=\"https://github.com/usefluenti/fluenti/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/usefluenti/fluenti?color=4338ca\u0026label=\" alt=\"license\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e~2 KB\u003c/strong\u003e core runtime\u0026ensp;·\u0026ensp;\u003cstrong\u003e5-10x faster\u003c/strong\u003e than runtime i18n\u0026ensp;·\u0026ensp;\u003cstrong\u003eFramework-agnostic\u003c/strong\u003e — Vue, React, Solid, Next.js, Nuxt, and more\n\u003c/p\u003e\n\n## Why compile-time?\n\nTraditional i18n libraries parse messages at runtime — adding bundle weight and slowing every render. Compile-time i18n resolves translations at build time, shipping plain strings and pre-compiled functions. Source text is used as the message key — no more maintaining separate ID maps.\n\n|  | Compile-time (Fluenti) | Runtime (react-i18next, vue-i18n, next-intl) |\n|--|:--|:--|\n| **Runtime size** | ~2 KB gzipped | 12–14 KB gzipped |\n| **Message parsing** | Build time (zero at runtime) | Every render |\n| **Speed** | 5-10x faster; 40x on complex ICU | Baseline |\n| **Code splitting** | Per-locale, automatic | Manual or none |\n| **Multi-framework** | One codebase, consistent API | One framework each |\n| **Natural keys** | Source text = key | Separate ID maps |\n\n## Features\n\n- **Framework-agnostic core** — `@fluenti/core` works with any framework; first-class integrations for Vue, React, Solid, Next.js, Nuxt, React Router, TanStack Start, and SolidStart\n- **Compile-time transforms** — messages compiled at build time, zero runtime parsing overhead\n- **ICU MessageFormat** — plurals, selects, nested arguments, custom formatters\n- **Vue `v-t` directive** — compile-time template transform, not a runtime directive\n- **`\u003cTrans\u003e`, `\u003cPlural\u003e`, `\u003cSelect\u003e` components** — consistent API across Vue, React, and Solid\n- **Code splitting** — lazy-load translations per locale (`dynamic`, `static`, or off)\n- **SSR-safe** — locale detection via cookie, query, path, or headers; hydration script helper\n- **PO + JSON catalogs** — gettext-compatible workflow with JSON alternative\n- **Date / number formatting** — thin wrappers around `Intl` APIs with built-in presets\n- **Plugin system** — extend extract/compile pipeline with custom hooks\n- **`msg` descriptors** — lazy message constants for use outside components\n\n## Quick Start\n\n**Vue**\n\n```vue\n\u003cscript setup\u003e\nimport { t } from '@fluenti/vue'\nconst count = 3\n\u003c/script\u003e\n\n\u003ctemplate\u003e\n  \u003ch1 v-t\u003eHello, world!\u003c/h1\u003e\n  \u003cp\u003e{{ t`You have ${count} items` }}\u003c/p\u003e\n\u003c/template\u003e\n```\n\n**React**\n\n```tsx\nimport { t } from '@fluenti/react'\n\nfunction App() {\n  const count = 3\n  return (\n    \u003c\u003e\n      \u003ch1\u003e{t`Hello, world!`}\u003c/h1\u003e\n      \u003cp\u003e{t`You have ${count} items`}\u003c/p\u003e\n    \u003c/\u003e\n  )\n}\n```\n\n**Solid**\n\n```tsx\nimport { t } from '@fluenti/solid'\n\nfunction App() {\n  const count = 3\n  return (\n    \u003c\u003e\n      \u003ch1\u003e{t`Hello, world!`}\u003c/h1\u003e\n      \u003cp\u003e{t`You have ${count} items`}\u003c/p\u003e\n    \u003c/\u003e\n  )\n}\n```\n\nSame API. Same message catalogs. Different frameworks.\n\n## Workflow\n\n```bash\n# 1. Extract messages from source files\nfluenti extract --format po\n\n# 2. Translate — edit locales/ja.po, locales/zh-CN.po\n\n# 3. Compile catalogs to optimized JS modules\nfluenti compile\n```\n\nThe Vite plugin loads compiled catalogs automatically — no manual wiring needed.\n\n## Install\n\n```bash\n# Vue\npnpm add @fluenti/core @fluenti/vue @fluenti/vite-plugin\n\n# React\npnpm add @fluenti/core @fluenti/react @fluenti/vite-plugin\n\n# SolidJS\npnpm add @fluenti/core @fluenti/solid @fluenti/vite-plugin\n\n# Next.js\npnpm add @fluenti/core @fluenti/react @fluenti/next\n\n# Nuxt\npnpm add @fluenti/nuxt @fluenti/core @fluenti/vue\n\n# CLI (message extraction \u0026 compilation)\npnpm add -D @fluenti/cli\n\n# vue-i18n migration bridge (optional)\npnpm add @fluenti/vue-i18n-compat\n```\n\n## Packages\n\n| Package | Description |\n|---------|-------------|\n| [`@fluenti/core`](packages/core) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/core?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/core) | Framework-agnostic core — ICU parser, compiler, interpolation, formatters. Extend to any framework. |\n| [`@fluenti/vue`](packages/vue) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/vue?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/vue) | Vue 3 — `v-t` directive, `\u003cTrans\u003e`, `useI18n()` composable |\n| [`@fluenti/react`](packages/react) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/react?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/react) | React — `I18nProvider`, `\u003cTrans\u003e`, `\u003cPlural\u003e`, `\u003cSelect\u003e`, `useI18n()` hook |\n| [`@fluenti/solid`](packages/solid) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/solid?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/solid) | SolidJS — `\u003cTrans\u003e`, `I18nProvider`, `useI18n()` |\n| [`@fluenti/next`](packages/next-plugin) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/next?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/next) | Next.js — `withFluenti()`, RSC support, streaming SSR |\n| [`@fluenti/nuxt`](packages/nuxt) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/nuxt?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/nuxt) | Nuxt — locale-prefixed routing, SEO helpers, auto locale detection |\n| [`@fluenti/cli`](packages/cli) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/cli?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/cli) | Message extraction (Vue SFC, TSX), PO/JSON compilation, AI translation |\n| [`@fluenti/vite-plugin`](packages/vite-plugin) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/vite-plugin?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/vite-plugin) | Vite build-time transforms, virtual modules, code splitting |\n| [`@fluenti/vue-i18n-compat`](packages/vue-i18n-compat) \u003cbr\u003e [![npm](https://img.shields.io/npm/v/@fluenti/vue-i18n-compat?color=4f46e5\u0026label=)](https://www.npmjs.com/package/@fluenti/vue-i18n-compat) | Progressive migration bridge between vue-i18n and Fluenti |\n\n## Documentation\n\nFull documentation — guides, API reference, and examples — is available at **[fluenti.dev](https://fluenti.dev)**.\n\n- [Getting Started](https://fluenti.dev/start/introduction/)\n- [Vue Quick Start](https://fluenti.dev/start/quick-start-vue/)\n- [React Quick Start](https://fluenti.dev/start/quick-start-react/)\n- [SolidJS Quick Start](https://fluenti.dev/start/quick-start-solid/)\n- [Next.js Quick Start](https://fluenti.dev/start/quick-start-nextjs/)\n- [Nuxt Quick Start](https://fluenti.dev/start/quick-start-nuxt/)\n- [Code Splitting](https://fluenti.dev/advanced/code-splitting/)\n- [SSR Guide](https://fluenti.dev/advanced/ssr-hydration/)\n- [Framework Comparison](https://fluenti.dev/advanced/framework-comparison/)\n- [vue-i18n Migration](https://fluenti.dev/frameworks/vue/migration-from-vue-i18n/)\n\n## License\n\n[MIT](LICENSE) - Fluenti Contributors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusefluenti%2Ffluenti","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusefluenti%2Ffluenti","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusefluenti%2Ffluenti/lists"}