1

Criei uma biblioteca para inspecionar Storage e interceptar requisições direto na tela do React (Overlay DevTools)

Fala pessoal!

Durante o desenvolvimento de aplicações em React e Next.js, sempre achei um pouco repetitivo ter que ficar alternando entre a aplicação e a aba Application/Network do DevTools do navegador só para checar um localStorage, editar um cookie de teste ou simular um delay de rede.

Para resolver isso de forma simples e integrada, desenvolvi a @kickd0wn/react-dev-companion, uma biblioteca zero-dependency que adiciona um overlay discreto de DevTools direto na interface da aplicação em ambiente de desenvolvimento.

Acabei de lançar a versão v0.2.0 e queria compartilhar o projeto com a comunidade para ouvir o feedback de vocês!

🚀 O que ela faz?
Storage Inspector: Permite visualizar, editar inline, deletar e fazer import/export de JSON do localStorage, sessionStorage e cookies sem precisar abrir as ferramentas do navegador.

Network Interceptor: Filtra requisições por URL ou método HTTP (GET, POST, etc.), mostra métricas de duração (ms), permite copiar qualquer request como cURL e simula modos Offline ou rede lenta (Slow 3G / Fast 3G).

DX & Produtividade: Atalho global no teclado (Ctrl + Shift + D / Cmd + Shift + D) para abrir/fechar o painel a qualquer momento e suporte a temas escuros.

📦 Como testar no seu projeto
Basta instalar o pacote:

   npm install @kickd0wn/react-dev-companion

E importar no seu componente raiz (ex: App.tsx ou layout.tsx):

import { DevCompanion } from '@kickd0wn/react-dev-companion';

export default function App() {
  return (
    <div>
      {process.env.NODE_ENV === 'development' && <DevCompanion />}
      {/* Seu app aqui */}
    </div>
  );
}

🔗 Links úteis
GitHub: https://github.com/Kickz1nn/react-dev-companion

NPM: https://www.npmjs.com/package/@kickd0wn/react-dev-companion

O projeto é 100% open-source! Se tiverem sugestões de novas features, críticas sobre a arquitetura ou quiserem contribuir, fiquem à vontade para comentar aqui ou abrir uma issue no repositório.

O que acharam da ideia?

Carregando publicação patrocinada...
1

Olhei o dist/index.js da 0.2.0 e abriria duas issues:

  1. O external do vite.config.ts tem react e react-dom, mas não react/jsx-runtime, então o runtime JSX foi embutido no pacote. E é o do React 19 (Symbol.for("react.transitional.element"), __CLIENT_INTERNALS_...). Como o peer aceita react >=17, no 17 ou 18 o componente quebra já na renderização. Pôr 'react/jsx-runtime' no external resolve no 18 (no 17, o webpack 5 nem acha esse import num pacote ESM).

  2. Falta o 'use client' no bundle. Importar direto no layout.tsx, como no post, dá erro no App Router, e a solução do README (diretiva no próprio RootLayout) impede o export const metadata nesse arquivo. Dá pra emitir a diretiva com um banner no output; até lá, um dev-companion.tsx com 'use client' que só reexporta o componente resolve.

Fora isso, só o fetch é interceptado: o axios usa XHR no browser por padrão, então essas chamadas nem aparecem no painel nem sentem o Offline/Slow 3G.

1

Fala, mano! Valeu mesmo por esse seu feedback. Foi uma análise cirúrgica e com certeza um cometário valioso. Muito obrigado por ter tirado um tempo para inspecionar o dist/index.js!

Sobre os pontos que você levantou:

  1. react/jsx-runtime e compatibilidade (React 17/18):
    Ponto cego total da minha parte no vite.config.ts. Como desenvolvi e testei no React 19, o runtime embutido passou batido e acabou quebrando a renderização em versões anteriores. Já vou incluir react/jsx-runtime no external do Rollup na próxima versão para respeitar o peerDependencies.

  2. Diretiva 'use client' (Next.js App Router):
    Excelente sacada. Ter que colocar 'use client' no layout.tsx e perder o export const metadata é uma péssima DX. Vou injetar o banner 'use client'; via Vite no topo do bundle final para que a lib rode como Client Component nativo sem infectar o arquivo que a consome.

  3. Intercepção de XMLHttpRequest (Axios):
    Perfeito! Hoje estou fazendo monkey patch apenas do window.fetch. Como o Axios usa XMLHttpRequest no browser por padrão, ele acaba passando direto. Já entrou para o roadmap da v0.3.0 interceptar XHR também para cobrir o Axios e outras libs.

Mais uma vez, valeu demais pelas observações! Vou subir as correções dos pontos 1 e 2 na patch release v0.2.1 muito em breve.