Blazor I18n/Localization Text
A class library for localizing text in Blazor applications using JSON/CSV files and static typing.
What is Blazor I18n/Localization Text?
Toolbelt.Blazor.I18nText is a class library that provides localization capabilities for Blazor applications. It allows developers to manage translated text using JSON or CSV files, which are compiled into strongly-typed C# classes for use in Blazor components. The library solves the problem of integrating internationalization into Blazor apps without relying on .resx files or the standard IStringLocalizer approach.
Blazor developers building multi-language web applications who prefer a file-based, statically-typed localization workflow over traditional .NET resource files.
Developers choose Toolbelt.Blazor.I18nText for its simplicity, strong typing with IntelliSense support, compatibility with all Blazor render modes, and ability to work on static hosts without requiring ASP.NET Core.
Overview
The class library that provides the ability to localize texts on your Blazor app!
Use Cases
Best For
- Localizing Blazor WebAssembly apps hosted on static file servers
- Building Blazor component libraries with built-in localization support
- Teams preferring JSON/CSV translation files over .resx resources
- Projects requiring IntelliSense and compile-time checks for translation keys
- Applications using mixed render modes (SSR, Server, WebAssembly, Auto)
- Developers wanting to avoid satellite assemblies and complex localization setups
Not Ideal For
- Applications requiring plural form support for different languages
- Projects deeply integrated with ASP.NET Core's IStringLocalizer for full-stack consistency
- Teams needing to localize validation messages using DataAnnotation attributes without custom code
Pros & Cons
Pros
Generates strongly-typed C# classes from JSON/CSV files, enabling IntelliSense and compile-time safety for translation keys, as shown in the README's GIF demonstrations.
Supports all Blazor render modes (SSR, Server, WebAssembly, Auto), ensuring seamless integration across different hosting scenarios, per the README's feature list.
Uses simple JSON or CSV files for translations, eliminating the need for .resx files and complex tooling, making it accessible with any text editor.
Works on static web hosts for Blazor WebAssembly without requiring an ASP.NET Core server, as highlighted in the README for broader deployment options.
Cons
Lacks support for plural forms, placeholder-based text formatting, and integration with ASP.NET Core localization, limiting its use in complex internationalization scenarios, as admitted in the Limitations section.
Requires additional setup with RequestLocalization middleware for SSR areas, adding complexity and potential for errors in Blazor apps with server-side rendering.
Involves a JavaScript file with version query string issues that necessitate environment variable or MSBuild property adjustments, as detailed in the README's configuration notes.
Frequently Asked Questions
Related Projects
FluxorFluxor is a zero boilerplate Flux/Redux library for Microsoft .NET and Blazor.
Blazored.LocalStorageA library to provide access to local storage in Blazor applications
bUnit - a testing library for Blazor componentsbUnit is a testing library for Blazor components that make tests look, feel, and runs like regular unit tests. bUnit makes it easy to render and control a component under test’s life-cycle, pass parameter and inject services into it, trigger event handlers, and verify the rendered markup from the component using a built-in semantic HTML comparer.
Blazor-StateA Blazor State management library by TimeWarp.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.