Workspace Crates
Start with the high-level crates. A typical application needs the facade crate, one runtime manager, and optionally the language-enum helper.
[dependencies]
es-fluent = "0.16"
es-fluent-manager-embedded = "0.16"
es-fluent-lang = "0.16"
Install the CLI separately:
cargo install es-fluent-cli --locked
Swap es-fluent-manager-embedded for es-fluent-manager-dioxus in Dioxus
apps by enabling client, ssr, or both surfaces as needed. Use
es-fluent-manager-bevy in Bevy apps.
Crates You Usually Use
| Crate | Use it for | Covered in this book |
|---|---|---|
es-fluent | Derives, traits, and the public localization facade | Getting Started, Deriving Messages, Namespaces & File Splitting |
es-fluent-manager-embedded | Embedded-runtime apps, CLIs, TUIs, desktop apps | Runtime Managers |
es-fluent-manager-dioxus | Dioxus apps using provider/hook-based client locale state or request-scoped SSR | Runtime Managers |
es-fluent-manager-bevy | Bevy integration, reactive localized UI, asset loading | Runtime Managers |
es-fluent-lang | Type-safe locale enum generation and localized language names | Language Enum |
es-fluent-cli | Generating, checking, cleaning, syncing, formatting, and inspecting FTL files | CLI Tooling |
Public Support Crates
| Crate | Role |
|---|---|
es-fluent-derive | Proc-macro implementation re-exported by es-fluent |
es-fluent-lang-macro | Implementation crate behind #[es_fluent_language] |
es-fluent-build | Build-script helper for locale asset rebuild tracking |
es-fluent-manager-core | Shared runtime traits, module registration, fallback logic |
es-fluent-manager-macros | Compile-time module registration and BevyFluentText derive |
Internal Workspace Crates
| Crate | Responsibility |
|---|---|
es-fluent-shared | Runtime-safe metadata, naming, namespace, and path helpers |
es-fluent-derive-core | Build-time option parsing and validation for derives |
es-fluent-toml | i18n.toml parsing, path resolution, and locale discovery |
es-fluent-generate | FTL AST generation, merging, cleaning, and formatting |
es-fluent-cli-helpers | Runtime logic executed inside the generated runner binary |
es-fluent-runner | Shared runner protocol types and .es-fluent/metadata path helpers |
xtask | Repository maintenance tasks such as rebuilding the book and language-name data |