Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/facebook/fbt
A JavaScript Internationalization Framework
https://github.com/facebook/fbt
framework i18n internationalization javascript
Last synced: 24 days ago
JSON representation
A JavaScript Internationalization Framework
- Host: GitHub
- URL: https://github.com/facebook/fbt
- Owner: facebook
- License: mit
- Created: 2018-08-01T17:39:49.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-25T05:38:44.000Z (about 2 months ago)
- Last Synced: 2024-11-02T21:02:30.558Z (about 1 month ago)
- Topics: framework, i18n, internationalization, javascript
- Language: JavaScript
- Homepage: https://facebook.github.io/fbt
- Size: 14.3 MB
- Stars: 3,895
- Watchers: 45
- Forks: 178
- Open Issues: 57
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-react-native - fbt ★3202 - A JavaScript Internationalization Framework (Components / Internationalization)
- awesome-list - fbt
- awesome-i18n - facebook/fbt - internationalization framework for JavaScript designed to be not just powerful and flexible, but also simple and intuitive (📦 Libraries / JavaScript / TypeScript)
- awesome-repositories - facebook/fbt - A JavaScript Internationalization Framework (JavaScript)
- awesome-github-star - fbt
README
FBT is an internationalization framework for JavaScript designed to be not just **powerful** and **flexible**, but also **simple** and **intuitive**.
It helps with the following:
* Organizing your source text for translation
* Composing grammatically correct translatable UI
* Eliminating verbose boilerplate for generating UI
## Online Resources
* [Official Website](https://facebook.github.io/fbt)
* [Documentation](https://facebook.github.io/fbt/docs/getting_started_on_web)
## Examples
* [See our demo here](demo-app/src/example/Example.react.js)
* [See our React Native demo here](https://github.com/facebook/fbt/tree/rn-demo-app)
## Requirements
* [Node.js](https://nodejs.org/)
* [Yarn](https://yarnpkg.com/)
* [Babel](https://babeljs.io/)
## Building the fbt library
```
git clone [email protected]:facebook/fbt.git
cd fbt
yarn install
```
**NOTE:** if you make changes to the fbt runtime that you'd like to
test in the demo-app, be sure to run this command to rebuild the JS code:
```
yarn build-runtime
```
## Using fbt
See how to use the source directly with Babel and Webpack in [our demo-app](demo-app#babelwebpackreact-oss-fbt-demo).
## How FBT works
FBT works by transforming your `` and `fbt(...)` constructs via
Babel plugins. These plugins serve to extract strings from source and
lookup translated payloads generated at build-time. FBT creates tables
of all possible variations for the given fbt phrase and accesses this
at runtime.
## Join the fbt community
* [Website](https://facebook.github.io/fbt)
* [Facebook group](https://www.facebook.com/groups/498204277369868)
* [Discord #fbt channel in reactiflux](https://discord.gg/cQvXZr5)
* [Twitter](https://twitter.com/fbt_js)
See the [CONTRIBUTING](CONTRIBUTING.md) file for how to help out.
## Change log
See [CHANGELOG](CHANGELOG.md).
## List of npm modules published from this repo:
- [babel-plugin-fbt](https://www.npmjs.com/package/babel-plugin-fbt) (build-time / server-side)
- See [package.json](packages/babel-plugin-fbt/package.json)
- [babel-plugin-fbt-runtime](https://www.npmjs.com/package/babel-plugin-fbt-runtime) (server-side)
- See [package.json](packages/babel-plugin-fbt-runtime/package.json)
- [@fbtjs/default-collection-transform](https://www.npmjs.com/package/@fbtjs/default-collection-transform) (build-time)
- See [package.json](packages/default-collection-transform/package.json)
- [fb-babel-plugin-utils](https://www.npmjs.com/package/fb-babel-plugin-utils) (server-side, used by `babel-plugin-fbt-runtime`)
- See [package.json](packages/fb-babel-plugin-utils/package.json)
- [fbt](https://www.npmjs.com/package/fbt) (client-side)
- See [package.json](packages/fbt/package.json)
- [fb-tiger-hash](https://www.npmjs.com/package/fb-tiger-hash) (build-time)
- See [package.json](packages/fb-tiger-hash/package.json)
- [gulp-rewrite-flowtyped-modules](https://www.npmjs.com/package/gulp-rewrite-flowtyped-modules) (build-time)
- See [package.json](packages/gulp-rewrite-flowtyped-modules/package.json)
- [gulp-strip-docblock-pragmas](https://www.npmjs.com/package/gulp-strip-docblock-pragmas) (build-time)
- See [package.json](packages/gulp-strip-docblock-pragmas/package.json)
- [react-native-fbt](https://www.npmjs.com/package/react-native-fbt) (build-time)
- See [package.json](packages/react-native-fbt/package.json)
## License
FBT is MIT licensed, as found in the [LICENSE](LICENSE) file.