{"id":26261875,"url":"https://github.com/nfdz/excel_for_flutter_localizations","last_synced_at":"2026-05-08T05:44:22.601Z","repository":{"id":281515262,"uuid":"944644695","full_name":"nfdz/excel_for_flutter_localizations","owner":"nfdz","description":"A Dart package that allows you to use a Excel as a localization platform alongside the standard Flutter library.","archived":false,"fork":false,"pushed_at":"2025-03-09T16:27:12.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T16:33:06.119Z","etag":null,"topics":["dart","excel","flutter","intl","localization-tool","localizations"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/excel_for_flutter_localizations","language":"Dart","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/nfdz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T17:59:27.000Z","updated_at":"2025-03-09T16:27:15.000Z","dependencies_parsed_at":"2025-03-09T16:43:09.503Z","dependency_job_id":null,"html_url":"https://github.com/nfdz/excel_for_flutter_localizations","commit_stats":null,"previous_names":["nfdz/excel_for_flutter_localizations"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfdz%2Fexcel_for_flutter_localizations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfdz%2Fexcel_for_flutter_localizations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfdz%2Fexcel_for_flutter_localizations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfdz%2Fexcel_for_flutter_localizations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nfdz","download_url":"https://codeload.github.com/nfdz/excel_for_flutter_localizations/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243500787,"owners_count":20300775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["dart","excel","flutter","intl","localization-tool","localizations"],"created_at":"2025-03-14T00:16:29.110Z","updated_at":"2025-12-30T05:56:08.357Z","avatar_url":"https://github.com/nfdz.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003e\n  Excel for flutter_localizations\n\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/nfdz/excel_for_flutter_localizations/actions\"\u003e\n    \u003cimg alt=\"Build Status\" src=\"https://github.com/nfdz/excel_for_flutter_localizations/workflows/build/badge.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pub.dartlang.org/packages/excel_for_flutter_localizations\"\u003e\n    \u003cimg alt=\"Pub Package\" src=\"https://img.shields.io/pub/v/excel_for_flutter_localizations.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg alt=\"MIT License\" src=\"https://img.shields.io/badge/License-MIT-blue.svg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Overview\n\nA Dart package that allows you to use a Excel as a localization platform alongside the standard Flutter library [flutter_localizations](https://docs.flutter.dev/ui/accessibility-and-internationalization/internationalization).\n\nThe idea is to **keep it simple** until you perhaps need to use a more professional platform. In that case, the change will be immediate, without code migrations or problems.\n\n### Breakdown of the Rules\n\n- The source of truth is the ARB file declared as template (`template-arb-file`) → *This file will never be modified by this tool*\n- When a translation entry is in the Excel and in the ARB file of its language → *The one in Excel will be used*\n- When a translation entry is not present in the ARB template file → *It will be deleted from Excel and all other ARBs*\n- When a translation entry is not present in Excel but is present in the translated ARBs → *The present translations will be used for the ARBs and for the Excel*\n- When a translation entry has changed its text in the reference language (`template-arb-file`) → *This translation will be updated in the Excel*\n  - Be careful because the rest of the languages ​​will continue to use the value they have in Excel. To update the translations, the idea is to go through the Excel.\n\n#### New and Fuzzy Translations\n\nThe first column of the Excel will have an `X` when:\n- The translation entry is new.\n- The translation entry has changed in the reference language (`template-arb-file`).\n\n#### Disabled Columns\n\nThere is a greyish background colour in the cells that should not be modified under any circumstances in the Excel file. The reason is that they will not produce any change in the ARBs and may be misleading. They are: `context`, `key`, `reference translation`.\n\n## Install\n\n```bash\ndart pub global activate excel_for_flutter_localizations\n```\n\n## Usage\n\n```bash\ndart pub global run excel_for_flutter_localizations [ARGS]\n```\n\n#### Arguments\n\n| Mandatory | Argument                     |  Description                                                                           |\n|-----------|------------------------------|----------------------------------------------------------------------------------------|\n| Yes       | -a, --arb-dir                | Path to the ARB files directory, eg: lib/l10n         |\n| Yes       | -e, --excel-file             | Path to the Excel file, eg: translations.xlsx                |\n| Yes       | -t, --template-arb-file      | ARB template file, eg: app_en.arb            |\n| No        | -v, --verbose                | Print verbose output            |\n\n#### Most Common Scenario\n\nUsing the same naming conventions as Flutter documentation.\n\n```bash\ndart pub global run excel_for_flutter_localizations -a lib/l10n -e translations.xlsx -t app_en.arb\n```\n\n## Example\n\n```bash\ncd example\ndart ../bin/excel_for_flutter_localizations.dart -a l10n -e example.xlsx -t app_en.arb --verbose\n```\n\n### Screenshot\n\n![Example Excel](https://github.com/user-attachments/assets/e6a70c6f-8902-4b18-8af8-64d7f32cf154)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfdz%2Fexcel_for_flutter_localizations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnfdz%2Fexcel_for_flutter_localizations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfdz%2Fexcel_for_flutter_localizations/lists"}