Using YAML files
YAML files are meant to be used by humans. You can write your translations inside a YAML file and run yarn glotstack get-translations --yaml -- note the --yaml option. You can also use
# en-US.yaml
---
Common:
  Beta:
    context: A label indicating the feature is in beta
    value: Beta

Home:
  hero-title:
    context: Homepage hero title; It's catchy to captivate new viewers {{something, no-parse}}.
    value:
      AI-driven, real-time translation and hyper-localization built for modern
      software teams.
  hero-subtitle:
    context: Homepage hero subtitle
    value:
      Go global instantly with <Purple>AI-powered localization</Purple>. Your product is ready
      for the world  Glotstack makes sure it speaks the right language.
  pro-tip:
    context: A development tip for developers who do server side rendering
    value: |
      <Tip>When to use fetch or import?</Tip><Spacer></Spacer>
      <Fetch>fetch()</Fetch> pulls files from staticly hosted files that you host anywhere like a CDN - this also helps keep
      bundle sizes small if you have a limited bundle size, like on Cloudflare Workers. <Fetch>fetch()</Fetch> is almost always better
      unless your environment cannot support dynamic import syntax, then the <Require>require()</Require> method is your best bet for a 
      little more boilerplate.

      For smaller applications or react-native, we recommend you use <Require>require()</Require> to build the assets into 
      your hosted bundles.

You'll still need to generate JSON files
Run the glotstack script to translate your source YAML file to a JSON file
# looks for {sourceLocale}.yaml outputs {sourceLocale}.json
yarn glotstack yaml-to-json
We recommend adding it as a package entrypoint
© 2026 Glotstack.ai. All rights reserved.
Glotstack is a developer-first localization workflow for React: manage translations in YAML/JSON, keep locales in sync, and ship new languages faster with AI-assisted tooling