react-subpath-deploy
Installation
SKILL.md
Deploy React em Subpath
Esta skill é a primária quando o frontend é servido em /meu-app/ em vez de /. Ela coordena
assets, roteamento client-side e fallback da SPA; templates prontos ficam em templates/.
Pré-requisitos e coleta
- Confirme Vite, Docker e Kubernetes; React Router v6+ só é necessário se houver rotas client-side.
- Confirme o subpath com barra final (
/poc-01/), o Ingress controller e se o Ingress/host já existe. - Se o path não for informado, peça-o antes de gerar arquivos.
Quatro camadas obrigatórias
- Vite:
basevem deVITE_BASE_PATHe sempre termina com/. - Router: quando houver React Router, use
basename={import.meta.env.BASE_URL}; sem Router, não adicione uma camada desnecessária. - Nginx: use
aliaspara o diretório estático e fallback para${BASE_PATH}index.html; não userootque concatena o subpath incorretamente. - Entrega: Dockerfile multi-stage recebe
BASE_PATH; Ingress usa pathsPrefixpara cada app.