react-runtime-config

Installation
SKILL.md

Runtime Config React / 12-Factor

Use esta skill quando a configuração deve mudar no start do container, não no build. O objetivo é uma imagem imutável compartilhada entre dev, homologação e produção.

Regras não negociáveis

  • URLs de backend e configurações que variam entre ambientes não podem vir de import.meta.env ou ficar hard-coded no bundle; flags de build invariantes são a exceção.
  • Toda variável dinâmica passa por public/runtime-env.template.js, src/config/runtimeConfig.ts e docker/40-runtime-env.sh.
  • index.html carrega runtime-env.js antes do bundle; nunca exponha o template gerado.
  • window.RUNTIME_ENV é a fonte única e deve ser lida por um módulo tipado, com defaults seguros apenas para desenvolvimento local.
  • O entrypoint deve usar envsubst com allowlist, validar variáveis obrigatórias e falhar cedo.
  • O Dockerfile usa build multi-stage Node -> Nginx; a imagem final contém somente o artefato e o runtime necessário.
  • Não versione secrets nem valores reais no template, no código ou na documentação de exemplo.
Installs
5
GitHub Stars
7
First Seen
Aug 11, 2026