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.envou 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.tsedocker/40-runtime-env.sh. index.htmlcarregaruntime-env.jsantes 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
envsubstcom 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.