Local install instructions

[SachaG]

Clone locally

https://github.com/Devographics/Monorepo/

https://github.com/Devographics/surveys/

https://github.com/Devographics/locale-en-US/

https://github.com/Devographics/locale-ja-JP/ or any other locales repos (optional)

https://github.com/Devographics/entities/

Example File Structure

- dev
  - devographics
     - monorepo
     - surveys
     - locales
          - locale-en-US
          - locale-ja-JP
     - entities

pnpm i

pnpm i in the root of the monorepo directory.

API

All other apps needs the API to be running locally.

1. Env variables

• As of Feb 2026, every app needs its own .env file. Maybe add a root common .env file eventually?
• Change every Users/foo/... local filesystem path to match your own local filesystem.

2. Run API

pnpm run dev

GraphiQL

We can also run GraphiQL to make sure the API is working.

• Go to monorepo/graphiql
• create .env file (see below)
• pnpm run dev

Sample .env file:

REACT_APP_API_URL=http://localhost:4020/graphql
SKIP_PREFLIGHT_CHECK=true
PORT=4030

Sample GraphQL query to check that everything is working:

{
  translation(key: "general.js2025.survey_intro", localeId: en_US) {
    key
    t
    tHtml
    tClean
    context
    isFallback
    aliasFor
  }
}