name: lovable-vps-disaster-recovery

description: Restaurar projeto Lovable (React + Vite) em VPS quando o código fonte é perdido por rsync ou wipe

Lovable + VPS Disaster Recovery

Contexto

Projeto Lovable (vite_react_shadcn_ts) rodando em VPS via Docker/nginx. O código fonte pode ser perdido por rsync ou wipe, deixando só o dist/ compilado.

Workflow de Restauração Completa

1. Diagnóstico

`bash

Ver o que existe

ls /var/www/comercialrs/

ls /tmp/comercialrs/comercialrs-main/src/ # backup parcial pode existir

Se dist/ está incompleto (< 10KB index.html), precisa rebuild

wc -c /var/www/comercialrs/dist/index.html

`

2. Encontrar backup

`bash

find / -path /proc -prune -o -path /sys -prune -o -name "OnboardingTutorial.tsx" -print 2>/dev/null

Backup comum: /tmp/comercialrs/comercialrs-main/

`

3. Restaurar fonte + configs

`bash

Copiar src do backup

cp -r /tmp/comercialrs/comercialrs-main/src /var/www/comercialrs/src

Copiar configs essenciais

cp /tmp/comercialrs/comercialrs-main/{package.json,package-lock.json,vite.config.ts,tailwind.config.ts,tsconfig.json,components.json,postcss.config.js,index.html,eslint.config.js} /var/www/comercialrs/

Copiar .env (CRÍTICO - sem ele o build não Embeds variáveis)

cp /tmp/comercialrs/comercialrs-main/.env /var/www/comercialrs/.env

Copiar public se existir

cp -r /tmp/comercialrs/comercialrs-main/public /var/www/comercialrs/public 2>/dev/null && echo "Public copied"

`

4. Instalar dependências e rebuildar

`bash

cd /var/www/comercialrs

npm install

npm run build

Verificar novo hash dos assets em dist/index.html

`

5. Verificar se nginx serve do lugar certo

`bash

Geralmente nginx serve de /var/www/comercialrs/dist

Mas pode ser /var/www/rochasales/dist (site principal)

grep -A5 "comercialrs" /etc/nginx/sites-enabled/

cat /etc/nginx/sites-enabled/comercialrs.rochasalesseguros.com.br | grep "root"

`

6. Testar

`bash

curl -s -o /dev/null -w "%{http_code}" https://comercialrs.rochasalesseguros.com.br/

Deve retornar 200

`

Vite Build Produces Empty dist/ (index.html missing)

Problem: Running npm run build or vite build directly on VPS produces a dist/ folder with JS assets but NO index.html. The build appears to succeed (no error) but dist/index.html is missing.

Root Cause: The Lovable/TanStack Start project uses @lovable.dev/vite-tanstack-config (via lovable-tagger in vite.config.ts) which wraps Vite's HTML entry handling. When running vite build outside the Lovable CI pipeline, the custom plugin fails to inject/process the HTML entry, resulting in no dist/index.html.

Fix: Explicitly set both main and index entry points in rollupOptions.input:

`typescript

// vite.config.ts

import { defineConfig } from "vite";

import react from "@vitejs/plugin-react-swc";

import path from "path";

export default defineConfig({

plugins: [react()],

resolve: {

alias: { "@": path.resolve(__dirname, "./src") },

},

build: {

rollupOptions: {

input: {

main: "./src/main.tsx",

index: "./index.html",

}

}

},

});

`

Then build with:

`bash

cd /var/www/comercialrs

rm -rf dist

node ./node_modules/vite/bin/vite.js build

`

Verification: After build, check dist/index.html exists and contains