Skip to main content

Project configuration

caution

The Tolgee CLI is currently experimental and subject to bugs. Breaking changes may happen before stable release!

Help us reach stable version faster by reporting any bug you encounter on the issue tracker. Feedback is also greatly appreciated!

Rather than specifying project details every single time you run a command, you can set them once and forget about it by creating a .tolgeerc file. It will be parsed as a JSON file.

tip

We use cosmiconfig to parse the Toglee configuration file, which means you aren't limited to naming it .tolgeerc. You can use any of the following:

  • .tolgeerc
  • .tolgeerc.[json|yaml|yml|js|cjs]
  • .config/tolgeerc
  • .config/tolgeerc.[json|yaml|yml|js|cjs]
  • tolgee.config.[js|cjs]

You can also store your config in package.json, under the tolgee key.

List of properties

projectId

Integer. ID of the project on the Tolgee server.

delimiter

Single char, or null. Structure delimiter used.

By default, Tolgee interprets . in string keys as nested structures. You can use another delimiter, or disable this behavior by specifying null.

extractor

String. Path to the custom extractor to use, relative to the .tolgeerc file.

By default, Tolgee uses its own internal extractor which looks for use of the Tolgee SDK.

apiUrl

String. URL to the Tolgee instance you're using. If you're using Tolgee Cloud, you can ignore this.