Skip to main content

Preview Translation Feature

Preview Translation lets app operators review saved (unpublished) content inside the Flutter app while end users continue to see the published copy. This capability matches the behavior of other WOVN SDKs and is limited to devices running Debug Mode for Flutter v1.

End users vs. app operators

Prerequisites​

  1. Enable Debug Mode by following the steps in WOVN Debug Mode Feature. Preview mode only works when Debug Mode (App Operator Mode) is active on the device.
  2. Ensure the SDK has already been installed through the CLI (wovnflutter folder + wovn.yaml).

Enable Preview Translation​

  1. Open the wovn.yaml file that the installer placed in your Flutter project (typically listed under the assets section of pubspec.yaml).

  2. Add or update the translation_preview_mode flag:

    TOKEN: YOUR_TOKEN
    LOG_LEVEL: 1000
    translation_preview_mode: true

  3. Save the file, run flutter pub get if prompted, and restart your Debug Mode build.

  4. In the WOVN dashboard, edit your content and click Save (not Publish). The Debug Mode device will now render the saved translations.

Saved vs. published data

Expected Behavior​

  • Debug Mode devices render saved translations immediately after you click Save in the dashboard.
  • Production users (no Debug Mode) continue to see the latest published translations.
  • Switching translation_preview_mode back to false or exiting Debug Mode reverts the device to published content only.

Troubleshooting​

  • Preview does not activate: Confirm the device is still in Debug Mode (see 004_debug_mode.md) and that you restarted the app after editing wovn.yaml.
  • Saved text missing: Saved translations can take up to a minute to sync. Try reloading the screen or relaunching the app after clicking Save in the dashboard.
  • End users see saved data: Verify Debug Mode is disabled in release builds and that translation_preview_mode remains false in the production wovn.yaml.