// stack.lumi
Frontend

React

Biblioteca base para interfaces web modernas.

// o que é

React e uma biblioteca para construir interfaces componentizadas, escalaveis e interativas. Na Lumi Data, React e usado para dashboards, plataformas internas, SaaS e produtos digitais com experiencia rica.

A arquitetura baseada em componentes do React, introduzida pelo Facebook em 2013, formaliza o princípio de composição sobre herança descrito por Gamma et al. (1994) em "Design Patterns": unidades de UI reutilizáveis com responsabilidade única que se combinam para formar interfaces complexas. O virtual DOM — uma representação em memória da árvore de componentes — minimiza operações custosas de manipulação do DOM real por meio de reconciliação eficiente (diffing), reduzindo o número de refluxos e repinturas do navegador. O fluxo de dados unidirecional (de pai para filho via props) elimina a categoria de bugs causados por sincronização bidirecional, simplificando o raciocínio sobre estado em aplicações com muitos componentes. Osmani (2023) enquadra padrões como Container/Presenter, Compound Components e Render Props como adaptações modernas dos design patterns clássicos para o ecossistema React, permitindo escalar codebases sem sacrificar coesão.

Como a Lumi enxerga:A Lumi combina React com arquitetura frontend, acessibilidade, testes e performance para entregar interface bonita, rapida e sustentavel.
// na prática

Como empresas usam React

01

Produto SaaS B2B com múltiplas equipes de produto

Times utilizam React com um design system compartilhado (Storybook + componentes publicados via npm privado) para garantir consistência visual e acelerar o desenvolvimento de novas telas. O fluxo unidirecional combinado com estado global via Zustand ou Redux Toolkit evita discrepâncias entre o que diferentes times renderizam para o mesmo dado de negócio.

02

Portal operacional interno de grande empresa

React sustenta dashboards com centenas de tabelas, filtros e visualizações de dados em tempo real. A separação entre componentes de apresentação e containers de lógica permite que o time de UX itere no visual sem tocar nas integrações com APIs, acelerando ciclos de feedback com stakeholders.

03

Startup construindo MVP de produto digital

O ecossistema maduro do React — incluindo React Query para fetching, React Hook Form para formulários e Radix UI para componentes acessíveis — elimina a necessidade de construir infraestrutura de UI do zero. O time foca em diferenciação de produto enquanto usa soluções battle-tested para problemas comuns de interface.

// decisão técnica

Quando usar — e quando não usar

Use quando
  • O produto tem ciclo de vida longo e vai evoluir continuamente — o modelo de componentes facilita refatoração incremental sem rewrites completos
  • O time já domina o ecossistema JavaScript/TypeScript e quer aproveitar o mercado de talentos mais amplo para React
  • A aplicação exige um design system compartilhado entre múltiplos produtos ou squads, e componentes precisam ser publicados e versionados independentemente
  • A UI tem estado complexo — formulários multi-etapa, filtros interativos, tabelas com edição inline — onde o modelo declarativo do React simplifica o raciocínio sobre o que está na tela
  • A equipe usa Next.js e precisa do mesmo modelo mental no lado cliente e servidor, aproveitando Server Components para reduzir bundle
Evite quando
  • A entrega é um site institucional ou landing page com conteúdo estático: o overhead de hidratação do React prejudica Core Web Vitals (especialmente INP e LCP) sem trazer benefício de interatividade
  • O time tem perfil majoritariamente backend sem experiência em JavaScript moderno — a curva de aprendizado do ecossistema React (bundlers, hooks, gerenciamento de estado) vai dominar o tempo do projeto
  • A aplicação é um widget isolado embutido em uma página existente de terceiros: Svelte ou Web Components entregam a mesma funcionalidade com bundle drasticamente menor
  • O orçamento de performance é crítico em dispositivos de baixo custo (mercado popular brasileiro) e a aplicação não justifica o custo de runtime do React — Svelte compila para código vanilla mais eficiente
// visão lumi

React é nossa escolha padrão para produtos digitais que precisam escalar — não porque é a mais simples, mas porque é a que melhor equilibra produtividade do time, maturidade do ecossistema e capacidade de evolução. Não toleramos React como sinônimo de "criar projeto com CRA e sair adicionando dependências": cada projeto começa com TypeScript, ESLint, testes com Testing Library e uma estratégia clara de gerenciamento de estado antes de escrever a primeira tela. Monitoramos Core Web Vitals desde o primeiro deploy em staging porque performance não é um ajuste final — é uma decisão de arquitetura que começa na escolha de como buscar dados e renderizar componentes. Quando o requisito é um site estático ou uma landing page, recusamos React e recomendamos a ferramenta certa para o trabalho.

Lumi escolhe quando

  • Produto digital com roadmap de 12+ meses e time multidisciplinar que vai crescer e rotar membros
  • Dashboard ou sistema operacional com estado complexo, múltiplos filtros e atualizações em tempo real
  • Projeto que vai evoluir para design system compartilhado entre produtos ou squads distintos
  • Frontend que precisa de Server Components (via Next.js) para reduzir JavaScript no cliente sem abrir mão da interatividade onde ela existe

Lumi não recomenda quando

  • Sites institucionais, landing pages e portfólios onde Astro ou HTML estático entrega melhor LCP sem necessidade de runtime JavaScript
  • Projetos com prazo curtíssimo e time sem experiência React prévia — a produtividade inicial cai antes de subir, e o cliente paga pela curva de aprendizado
  • Embeds e widgets isolados em plataformas de terceiros onde o tamanho do bundle React impacta diretamente a performance da página hospedeira
// aplicações

Onde essa tecnologia gera valor

01

Portais e dashboards

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

02

Sistemas operacionais internos

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

03

Produtos SaaS

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

04

Design systems

A Lumi conecta essa aplicação ao objetivo de negócio, definindo arquitetura, dados, segurança e indicadores de sucesso antes da implementação.

// fundamentos

Referências acadêmicas e técnicas

Meta Open Source. (2013). React: A JavaScript Library for Building User Interfaces. reactjs.org.

Anúncio original do React pelo Facebook, descrevendo o modelo de componentes, o virtual DOM e o fluxo unidirecional de dados como fundamentos da biblioteca.

Gamma, E., Helm, R., Johnson, R., & Vlissides, J. (1994). Design Patterns: Elements of Reusable Object-Oriented Software. Addison-Wesley.

Obra fundacional dos design patterns que formaliza o princípio de composição sobre herança — base conceitual da arquitetura de componentes do React.

Google. (2020). Web Vitals: Essential metrics for a healthy site. web.dev/vitals.

Define os Core Web Vitals (LCP, INP, CLS) como métricas de experiência do usuário baseadas em dados reais de campo, criando o critério de performance que guia decisões de arquitetura frontend.

Osmani, A. (2023). JavaScript Design Patterns (2nd ed.). O'Reilly Media.

Adapta padrões clássicos de engenharia de software ao ecossistema JavaScript e React moderno, incluindo Container/Presenter, Compound Components e Hooks como padrões de composição.

Abramov, D., & Clark, A. (2018). React Hooks RFC. GitHub / reactjs/rfcs.

RFC que introduziu os Hooks como mecanismo oficial de composição de lógica stateful em componentes funcionais, substituindo class components e habilitando custom hooks como padrão de reutilização.

// tecnologias relacionadas

Frontend

// próximo passo

Quer saber se esse stack faz sentido para você?

A Lumi avalia contexto, dados, equipe, custo e maturidade para recomendar a tecnologia certa e entregar com responsabilidade.