Skip to content

Satellite Sites

Fernando Lucchesi edited this page Dec 2, 2022 · 27 revisions

How to add a new satellite

  1. Create a new dataset with the name of the satellite (country) at sanity.io

  2. Configure languages allowed by the new dataset in the file satellitesConfig.js

    • If needed, add a new language to the languages array.
    • Add a new entry to the datasets array - the first value will be set as the default language.
  3. Add the dataset name to the file satellites.json in the repository root

    • This triggers the creation of a docker image for both the web app and the sanity studio during the pipeline.
    • The array is read by the files .github/workflows/studio.yaml and .github/workflows/web.yaml and used as a matrix strategy for the job.
  4. Create a google tag manager container for the new satellite.

    • Create a history change trigger inside the container
  5. Add the necessary radix configuration to the radixconfig.yaml file, in order to run the docker image as an app in radix.

    • Add the configuration for the web instance. Find examples in the file.
    • Add the configuration for the studio instance. Find examples in the file.
  6. White list features in the file FeatureFlags.js

  7. Push changes to main and wait for GitHub actions to run

  8. Go to manage.sanity.io and enable CORS in the API tab to the new satellite studio

  9. Cookiebot configuration

    • Log in to the Cookiebot console, under Domains tab, add the new satellite site url.
    • To add a translation to the Cookiebot dialog and the Cookie declaration component, go to the Content tab, add the language variant and fill in the relevant translation text.
    • Verify that the correct language code is set for the data-culture attribute in the script tag of Cookiebot script.
  10. Add roles

    • Add roles to Sanity.io
    • Add roles to Microsoft Azure