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
Examples
See our demo here See our React Native demo here
Requirements
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.
How FBT works
FBT works by transforming your <fbt> 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.
Full documentation
https://facebook.github.io/fbt
Join the fbt community
See the CONTRIBUTING file for how to help out.
Change log
See CHANGELOG.
List of npm modules published from this repo:
- fbt (client-side)
- See package.json
- babel-plugin-fbt (build-time / server-side)
- See package.json
- @fbtjs/default-collection-transform (build-time)
- See package.json
- babel-plugin-fbt-runtime (server-side)
- See package.json
- fb-babel-plugin-utils (server-side, used by
babel-plugin-fbt-runtime)- See package.json
How to release a new npm version
# Go to the module's folder (where package.json is located)
cd fbt-runtime/
# or
# cd packages/babel-plugin-fbt/
# cd packages/babel-plugin-runtime/
# publishes to npm and push new git tag to Github
yarn publish_to_npm_latest
License
FBT is MIT licensed, as found in the LICENSE file.