Por que shaders são tão difíceis de publicar
Shaders ainda são a parte mais difícil de colocar no ar em um time web comum. O WebGPU entrega o hardware, mas logo em seguida devolve adaptadores, layouts de bind group e descritores de pipeline antes que um único pixel se mova na tela. A Vercel pagou esse custo internamente ao construir os shaders do vercel.com — e agora abriu o código do resultado.
vgpu é uma biblioteca TypeScript que trata arquivos .wgsl como módulos importáveis, expõe um único contexto Gpu e roda o mesmo shader em um canvas do navegador, em Node.js headless e em testes de snapshot de CI. A licença é MIT e o pacote está no npm — pnpm add vgpu é todo o caminho de instalação. Não há conta, cota ou cobrança de inferência: é uma biblioteca, não um serviço hospedado.
Um contexto, sem estado global oculto
O init() adquire o adaptador e o dispositivo e devolve um único handle Gpu. Todo o resto se pendura nele. O quick start do navegador, segundo o README, tem quatro linhas: criar a superfície, compilar o efeito, apontar os uniforms pelo nome e desenhar. Frames são explícitos — passes, clears e draws são chamadas, nunca estado implícito de cena.
WGSL como sistema de módulos
O grande diferencial está no ferramental de shader. Arquivos .wgsl importam e exportam como módulos TypeScript. A vgpu resolve o grafo de módulos, reflete os bindings, remove declarações não usadas e emite o código do shader compactado em tempo de build. Isso elimina as declarações de binding escritas à mão que costumam divergir do shader real. Segundo o README, um efeito de tela cheia completo sai com 25 KB gzipados, e o orçamento é reforçado no CI.
Três runtimes, uma API
O pacote expõe subpaths para vgpu, vgpu/node, vgpu/mock, vgpu/scene, vgpu/client e vgpu/core. O caminho de Node usa o Dawn para renderizar fora da tela, o que torna o render de CI prático — o CI compila o shader, renderiza um frame headless e compara o snapshot. O adaptador mock é determinístico e existe para testes que não devem tocar em GPU alguma.
O lado “agent-first”
A Vercel chama a ferramenta de biblioteca “agent-first”, e o empacotamento sustenta isso. O pacote publica um binário vgpu, então npx vgpu docs, npx vgpu examples e npx vgpu check funcionam sem instalação global. Há ainda agents.md, llms.txt e um servidor MCP somente leitura em vgpu.sh/api/mcp — sinais claros de que a Vercel quer que agentes de IA consigam descobrir e usar a biblioteca sem fricção.
Para times que querem efeitos visuais no navegador com o mesmo código rodando em teste e em produção, a vgpu é uma peça relevante no ecossistema aberto de WebGPU.
Descubra mais sobre noticiAI
Assine para receber nossas notícias mais recentes por e-mail.
