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

  1. Vite: base vem de VITE_BASE_PATH e sempre termina com /.
  2. Router: quando houver React Router, use basename={import.meta.env.BASE_URL}; sem Router, não adicione uma camada desnecessária.
  3. Nginx: use alias para o diretório estático e fallback para ${BASE_PATH}index.html; não use root que concatena o subpath incorretamente.
  4. Entrega: Dockerfile multi-stage recebe BASE_PATH; Ingress usa paths Prefix para cada app.
Installs
5
GitHub Stars
7
First Seen
Aug 11, 2026