O dashboard que encolheu 74% — e o bundle que caiu 64% sem perder nada
Capivara·

O dashboard que encolheu 74% — e o bundle que caiu 64% sem perder nada

5 min de leitura← Voltar para timeline

O componente monstro

Tinha um arquivo no Capivara que todo mundo (eu, o agente, qualquer um que abrisse o repo) evitava: Dashboard.tsx com 994 linhas.

Não era um componente. Era um condomínio — stats de projetos, health check, Umami, status do Portfólio, stats do Dogwalk, convites, 2FA, admin… tudo amontoado num arquivo único.

As ferramentas que uso neste projeto ficam na loja de skills — a primeira é grátis.

Cada feature nova adicionava mais um useEffect, mais um useState, mais um bloco de JSX. E o pior: o bundle inicial pesava 668 kB — o navegador baixava TUDO antes de mostrar QUALQUER coisa.

O contexto: 668 kB pro primeiro pixel

O problema não era só legibilidade. Era performance:

  • O navegador baixava 668 kB de JavaScript (gzip) antes de renderizar o primeiro pixel do dashboard
  • No 3G/mobile, isso era segundos de tela branca
  • Cada aba admin (Dogwalk, Umami, Overview, Notifications…) carregava junto — mesmo que o usuário nunca abrisse

A refatoração tinha 2 objetivos:

  1. Dashboard 994 → ~260 linhas (componentes extraídos)
  2. Bundle 668 → ~240 kB (só carrega o que precisa)

A luta: extrair, dividir, lazy-load

Passo 1 — Extrair componentes. O Dashboard era um God Component. Cada seção virou um componente próprio: StatusPage, 7 componentes admin (Dogwalk, Umami, Overview, Notifications, Logs, Tracking, TwoFA), gráfico Recharts interativo, toast system, ThemeToggle, SearchBar.

// Antes: 994 linhas num arquivo
// Depois: componentes pequenos, cada um com responsabilidade única
import { DogwalkAdmin } from "./admin/DogwalkAdmin";
import { UmamiAdmin } from "./admin/UmamiAdmin";
import { OverviewAdmin } from "./admin/OverviewAdmin";

Passo 2 — React Router + lazy loading. Em vez de carregar tudo no bundle inicial, cada rota carrega sob demanda:

// Antes: tudo no bundle inicial (668 kB)
// Depois: só a rota atual carrega
const AdminPage = lazy(() => import("./AdminPage"));
const WSLPanel = lazy(() => import("./WSLPanel"));

Passo 3 — remover window.location. A navegação manual (window.location = ...) recarregava a página inteira. React Router v7 faz SPA navigation — só troca o componente, sem reload.

A resolução: menos é mais

Os números pós-refatoração:

MétricaAntesDepoisΔ
Dashboard.tsx994 linhas262 linhas-74%
AdminPage.tsx1.091 linhas97 linhas-91%
Bundle inicial668 kB238 kB-64%
Roteamentowindow.location (reload)React Router v7 (SPA)—
Novos componentes—StatusPage + 7 admin—

E o melhor: nenhuma funcionalidade foi perdida. O dashboard continuou com tudo — stats, health, Umami, Dogwalk, convites, 2FA — só que organizado e carregando sob demanda.

Métricas

MétricaValor
Dashboard.tsx994 → 262 linhas (-74%)
AdminPage.tsx1.091 → 97 linhas (-91%)
Bundle inicial668 kB → 238 kB (-64%)
Testes frontend257/257 passando
Testes backend131/131 passando
TypeScript0 erros

Aprendizados

  1. Componente gigante não é feature — é dívida — 994 linhas num arquivo é um sinal de que as responsabilidades estão misturadas. Extrair por responsabilidade única torna o código manutenível.

  2. Lazy loading é a forma mais fácil de performance — o bundle inicial caiu 64% sem otimizar UMA linha de lógica. Só carregar o que a rota atual precisa.

  3. window.location é o vilão silencioso — navegação manual recarrega a página inteira (perde estado, refaz requests). React Router faz SPA navigation: troca componente, preserva estado.

  4. Refatoração não precisa perder funcionalidade — 994→262 linhas com tudo funcionando (257 testes passando). O objetivo é organização + performance, não cortar features.

~/lifelog — bash
$cat about.txt
╔══════════════════════════════════════╗
║  Samuel Medeiros                    ║
║  Senior Software Engineer           ║
║  Stack: Python · TypeScript · Rust  ║
║  Projetos: Arachne, Dogwalk,        ║
║            Capivara, TatuEngine      ║
╚══════════════════════════════════════╝
      
$

Leia também

Mesmo projeto, mesma trilha — as histórias se conectam.

Próximo passo

Se isto te serviu, tem mais: escrevo sobre o mesmo assunto nos outros projetos, e a loja tem as ferramentas que eu uso aqui.

Sem spam, descadastro de um clique. Também estou aqui: Loja de skills · Portfólio