Optimizing Bolt's Build For Different Languages
NOTE: add note about compiling Bolt for just one specific language at a time vs compiling for multiple languages
Step 1. Add a
lang prop to your
This should be an array of the two-character language codes you want to compile optimized builds for.
Note: currently this only includes
jaalthouh more language-specific builds could be added in the future.
Only Compile Japanese-optimized Build
lang: ['ja'], // ex. only compile the ja-optimized build
Compile Japanese and English optimized Builds (Japanese set as the default)
lang: ['ja', 'en'], // ja + en in the same build; ja used by default on docs site
Compile Japanese and English optimized Builds (English set as the default)
lang: ['en', 'ja'], // en + ja in the same build; en used by default on docs site
Only Compile Japanese Optimized Build (Deprecated String Lang Method)
lang: 'ja', // only ja (old to-be-removed single-lang build)
Note: not defining a lang prop will automatically configure the build to internally use the
Step 2. Disable the
This will get updated in the future but for now, you'll likely need to manually disable the build tools cache for a clean initial build
// switch `enableCache` in the `.boltrc` to false enableCache: false,
Step 3. Enably i18n (If Doing Local Development)
If you are running Bolt locally in dev mode, make sure the
i18n CLI flag is set to true.
This can be done by either by running
npm run start:lang in the docs site folder for local Bolt development OR
./node_modules/.bin/bolt start --i18n for everyone else.