Plugins e integrações do Astro
As integrações abaixo acrescentam recursos ao projeto Astro. Consulte o comando de instalação e a configuração de cada pacote na própria seção. Starlight cria um projeto de documentação; Deno e Tailwind aparecem com as orientações para os pacotes legados.
@astrojs/markdoc
Escreva conteúdo em Markdoc dentro de content collections e mapeie tags para componentes Astro no meio do texto. Confira as extensões shiki e prism.
Instalação
npx astro add markdocA integração @astrojs/markdoc traz o Markdoc para o Astro. Com ela, você escreve conteúdo em .mdoc dentro de content collections e usa componentes Astro como tags no meio do texto.
Registre a integração
Para usar Markdoc, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import markdoc from '@astrojs/markdoc'
export default defineConfig({ integrations: [markdoc()]})Use arquivos .mdoc
Os arquivos .mdoc vivem em content collections e são lidos com getEntry e render:
---import { getEntry, render } from 'astro:content'
const entry = await getEntry('docs', 'guia')const { Content } = await render(entry)---
<h1>{entry.data.title}</h1><Content />Mapeie tags para componentes
Com um markdoc.config.mjs, você liga tags do Markdoc a componentes Astro e estende o conteúdo. A opção extends recebe as extensões shiki() e prism() para destacar código. A opção allowHTML habilita HTML no corpo.
Compatibilidade
A versão 2.1.3 declara como dependência o Astro na faixa ^7.4.0, segundo o registro npm consultado em 6 de novembro de 2026.
@astrojs/mdx
Escreva páginas e posts em .mdx e use componentes Astro ou React no meio do texto, com frontmatter e variáveis lidos no mesmo arquivo do projeto.
Instalação
npx astro add mdxA integração @astrojs/mdx permite escrever páginas e entradas de conteúdo em .mdx. O formato junta Markdown e componentes no mesmo arquivo. Você escreve o texto em Markdown e coloca, no meio dele, um componente Astro, um componente React ou outro de um framework de interface instalado no projeto.
Registre a integração
O astro add faz este registro por você. Na instalação manual, você instala o pacote e registra a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import mdx from '@astrojs/mdx'
export default defineConfig({ integrations: [mdx()]})O que muda no projeto
Com a integração ativa, arquivos .mdx em src/pages viram páginas, do mesmo jeito que os .md. Uma coleção definida em src/content.config.ts também aceita .mdx quando o padrão do loader inclui essa extensão.
A integração herda as opções de Markdown do projeto, como os plugins remark e rehype já configurados. Quando o MDX precisa de uma configuração diferente da usada nos arquivos .md, a opção extendMarkdownConfig desliga essa herança. A página oficial descreve as demais opções.
Confira a versão antes de atualizar
A versão 8.1.3 declara como dependência o Astro na faixa ^7.2.10, segundo o registro npm consultado em 5 de novembro de 2026. Em um projeto com Astro anterior a essa faixa, consulte o guia de atualização do Astro antes de instalar a versão mais recente da integração.
Starlight
Monte um site de documentação com o Starlight, o tema oficial do Astro, com navegação lateral, componentes prontos e páginas em Markdown ou em MDX.
Instalação
npm create astro@latest -- --template starlightO Starlight é o tema de documentação do projeto Astro, publicado pela organização withastro no GitHub. Você escreve as páginas em Markdown ou MDX. O tema monta a navegação e o layout de leitura.
Comece por um projeto novo
Para acrescentar o Starlight a um projeto Astro que já existe, a documentação oficial tem um guia de instalação manual. Siga esse guia, porque a integração precisa de configuração própria no astro.config.mjs.
O que vem pronto
O tema traz componentes como cards e tabs para usar dentro das páginas MDX. Os guias oficiais seguem a ordem configurar, navegar, usar componentes, estender e publicar.
Compatibilidade
A versão 0.42.9 declara como dependência o Astro na faixa ^7.2.10, segundo o registro npm consultado em 5 de novembro de 2026. O Starlight ainda está na série 0.x, então leia as notas de cada versão antes de atualizar.
@astrojs/sitemap
Gere o sitemap a cada build a partir das páginas do projeto, com a opção site preenchida e filtros para tirar do arquivo as páginas fora do índice.
Instalação
npx astro add sitemapA integração @astrojs/sitemap gera o sitemap do site quando você roda o build. Ela lê as páginas do projeto e escreve os arquivos XML na pasta de saída, sem lista mantida à mão.
Preencha o site
O astro add sitemap instala o pacote e registra a integração. Ela exige a opção site no astro.config.mjs, com o endereço público começando por http:// ou https://. Sem ela, o sitemap não tem como montar as URLs absolutas:
import { defineConfig } from 'astro/config'import sitemap from '@astrojs/sitemap'
export default defineConfig({ site: 'https://example.com', integrations: [sitemap()]})Ajuste o que entra no arquivo
A opção filter recebe cada URL e mantém no sitemap só as que passam pela função. Use para tirar páginas de agradecimento, rascunhos de teste ou áreas com noindex. A opção customPages acrescenta URLs que o roteamento do Astro não conhece.
Em sites grandes, entryLimit define quantas URLs cabem em cada arquivo. A opção chunks separa grupos de páginas em arquivos próprios. Para mudar os campos de cada URL no XML, como a data de alteração, a página oficial descreve a opção serialize.
Compatibilidade
O registro npm da versão 3.7.4, consultado em 5 de novembro de 2026, não declara uma faixa de versões do Astro. Confira a página da integração na documentação oficial antes de atualizar um projeto antigo.
@astrojs/alpinejs
Adicione Alpine.js ao projeto Astro e use as diretivas do framework em qualquer componente, sem hidratação manual. Confira a opção entrypoint do projeto.
Instalação
npx astro add alpinejsA integração @astrojs/alpinejs adiciona Alpine.js ao projeto e habilita as diretivas do framework em qualquer componente Astro. O script é carregado em todas as páginas, sem diretiva client.
Registre a integração
Para usar Alpine.js, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import alpinejs from '@astrojs/alpinejs'
export default defineConfig({ integrations: [alpinejs()]})Use as diretivas do Alpine
Depois do registro, use as diretivas do Alpine direto no componente:
<div x-data="{ expanded: false }"> <button @click="expanded = ! expanded">Alternar</button> <p x-show="expanded">Texto que aparece quando o estado está ativo</p></div>Opções da integração
A opção entrypoint aponta um arquivo que recebe a instância do Alpine antes de iniciar, para registrar plugins e diretivas próprias. A integração também expõe Alpine no objeto global window, para autocompletar no TypeScript.
Compatibilidade
O registro npm da versão 1.0.0, consultado em 6 de novembro de 2026, aceita Alpine.js na versão 3 e não declara uma faixa de versões do Astro.
@astrojs/preact
Use componentes Preact em páginas Astro e renderize componentes React sem instalar o React no navegador. Confira as opções compat, babel e devtools.
Instalação
npx astro add preactA integração @astrojs/preact renderiza componentes Preact dentro de páginas Astro e cuida da hidratação no navegador. Com a opção compat, ela também renderiza componentes React sem instalar as bibliotecas maiores do React no navegador.
Registre a integração
Para usar componentes Preact, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import preact from '@astrojs/preact'
export default defineConfig({ integrations: [preact()]})Use um componente Preact
Importe o componente no frontmatter da página e escolha a diretiva conforme o momento da interação:
---import Contador from '../components/Contador.jsx'---
<Contador client:visible />Com client:visible, o JavaScript do componente só carrega quando ele aparece na tela.
Opções da integração
A opção compat ativa a camada preact/compat e deixa o projeto renderizar componentes React junto dos Preact. A opção babel passa configurações extras do Babel ao plugin do Preact. A opção devtools liga o Preact DevTools no desenvolvimento. Quando o projeto usa mais de um framework JSX, as opções include e exclude separam os arquivos de cada um.
Compatibilidade
O registro npm da versão 6.1.2, consultado em 6 de novembro de 2026, aceita Preact 10 e 11 e não declara uma faixa de versões do Astro.
@astrojs/react
Use componentes React em páginas Astro e carregue o JavaScript do React só nas ilhas com diretiva client, deixando o resto da página em HTML estático.
Instalação
npx astro add reactA integração @astrojs/react renderiza componentes React dentro de páginas Astro e cuida da hidratação no navegador. Sem diretiva, o componente sai como HTML estático. Com client:load, client:visible ou outra diretiva client, ele vira uma ilha interativa e carrega o JavaScript do React só para aquele trecho.
Registre a integração
O astro add react instala @astrojs/react com o React e o React DOM. Depois, registra a integração:
import { defineConfig } from 'astro/config'import react from '@astrojs/react'
export default defineConfig({ integrations: [react()]})Use um componente como ilha
Importe o componente no frontmatter da página e escolha a diretiva conforme o momento da interação:
---import Contador from '../components/Contador.jsx'---
<Contador client:visible />Com client:visible, o JavaScript do componente só carrega quando ele aparece na tela. O restante da página continua sem JavaScript.
Mais de um framework JSX
Quando o projeto usa React junto com Preact ou Solid, as opções include e exclude dizem à integração quais arquivos pertencem a cada framework. Para usar o React Compiler, a página oficial descreve a opção compiler.
Compatibilidade
O registro npm da versão 7.1.4, consultado em 5 de novembro de 2026, aceita React 17, 18 e 19 e não declara uma faixa de versões do Astro.
@astrojs/solid-js
Use componentes SolidJS em páginas Astro com hidratação por uma diretiva client e Suspense automático no servidor. Confira as opções include e devtools.
Instalação
npx astro add solidA integração @astrojs/solid-js renderiza componentes SolidJS dentro de páginas Astro e cuida da hidratação no navegador. Recursos assíncronos e componentes lazy ganham um limite de Suspense no topo de forma automática.
Registre a integração
Para usar componentes SolidJS, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import solid from '@astrojs/solid-js'
export default defineConfig({ integrations: [solid()]})Use um componente SolidJS
Importe o componente no frontmatter da página e escolha a diretiva conforme o momento da interação:
---import Contador from '../components/Contador.tsx'---
<Contador client:visible />Com client:visible, o JavaScript do componente só carrega quando ele aparece na tela.
Opções da integração
A opção devtools liga o Solid DevTools no desenvolvimento, com o pacote solid-devtools instalado. Quando o projeto usa mais de um framework JSX, as opções include e exclude separam os arquivos de cada um. Os componentes assíncronos são envolvidos em Suspense e renderizados no servidor.
Compatibilidade
O registro npm da versão 7.1.2, consultado em 6 de novembro de 2026, aceita SolidJS na faixa ^1.9.13 e não declara uma faixa de versões do Astro.
@astrojs/svelte
Use componentes Svelte 5 em páginas Astro e hidrate o que for interativo com uma diretiva client. Confira os preprocessadores e o svelte.config.js.
Instalação
npx astro add svelteA integração @astrojs/svelte renderiza componentes Svelte 5 dentro de páginas Astro e cuida da hidratação no navegador. Com uma diretiva client, o componente vira uma ilha interativa. Para Svelte 3 e 4, instale @astrojs/svelte@5.
Registre a integração
Para usar componentes Svelte, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import svelte from '@astrojs/svelte'
export default defineConfig({ integrations: [svelte()]})Use um componente Svelte
Importe o componente no frontmatter da página e escolha a diretiva conforme o momento da interação:
---import Contador from '../components/Contador.svelte'---
<Contador client:visible />Com client:visible, o JavaScript do componente só carrega quando ele aparece na tela.
Opções e preprocessadores
A integração é alimentada pelo @sveltejs/vite-plugin-svelte. As opções passadas ao svelte() valem também no svelte.config.js. As do astro.config.mjs têm precedência. Para SCSS ou Stylus nos arquivos .svelte, crie um svelte.config.js com vitePreprocess.
Compatibilidade
A versão 9.1.2 declara como dependência o Astro na faixa ^7.0.0, o Svelte na faixa ^5.43.6 e o TypeScript na faixa ^5.3.3 || ^6.0.0, segundo o registro npm consultado em 6 de novembro de 2026.
@astrojs/vue
Use componentes Vue 3 em páginas Astro e hidrate apenas as partes interativas com diretiva client. Confira as opções appEntrypoint, jsx e devtools.
Instalação
npx astro add vueA integração @astrojs/vue renderiza componentes Vue 3 dentro de páginas Astro e cuida da hidratação no navegador. Sem diretiva, o componente sai como HTML estático. Com client:load, client:visible ou outra diretiva client, ele vira uma ilha interativa e carrega o JavaScript do Vue só para aquele trecho.
Registre a integração
Para usar componentes Vue, registre a integração no astro.config.mjs:
import { defineConfig } from 'astro/config'import vue from '@astrojs/vue'
export default defineConfig({ integrations: [vue()]})Use um componente Vue
Importe o componente no frontmatter da página e escolha a diretiva conforme o momento da interação:
---import Contador from '../components/Contador.vue'---
<Contador client:visible />Com client:visible, o JavaScript do componente só carrega quando ele aparece na tela. O restante da página continua sem JavaScript.
Opções da integração
A integração é alimentada pelo @vitejs/plugin-vue. A opção appEntrypoint aponta um arquivo que recebe a instância do app Vue antes da renderização, para registrar plugins com app.use. A opção jsx habilita componentes Vue JSX. A opção devtools liga o Vue DevTools no desenvolvimento.
Compatibilidade
A versão 7.1.2 declara como dependência o Astro na faixa ^7.0.0 e o Vue na faixa ^3.5.24, segundo o registro npm consultado em 6 de novembro de 2026.
@astrojs/tailwind
Mantenha o Tailwind 3 em projetos Astro com a integração antiga e consulte a orientação oficial para usar Tailwind 4 pelo Vite. Veja a configuração.
Instalação
npm install tailwindcss@3 @astrojs/tailwindO @astrojs/tailwind integra o Tailwind CSS 3 ao Astro. A documentação marca essa integração como descontinuada e recomenda @tailwindcss/vite para Tailwind 4. Use a configuração abaixo ao manter um projeto com Tailwind 3.
Registre a integração antiga
Com o Tailwind 3 instalado, adicione a integração ao astro.config.mjs:
import { defineConfig } from 'astro/config'import tailwind from '@astrojs/tailwind'
export default defineConfig({ integrations: [tailwind()]})Indique os arquivos com classes
O guia de estilos exige um arquivo de configuração do Tailwind 3. No tailwind.config.mjs, o campo content indica os arquivos que o Tailwind examina para gerar o CSS:
export default { content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'], theme: { extend: {} }, plugins: []}Assim, uma classe como text-xl escrita em um componente Astro entra no CSS gerado. Se a extensão do componente ficar fora de content, suas classes podem faltar no resultado.
Tailwind 4 usa o plugin do Vite
A partir do Astro 5.2, o comando automático para adicionar Tailwind instala o plugin do Vite. Ele não instala esta integração antiga. Para manter Tailwind 3, o guia de estilos do Astro documenta a instalação manual indicada na ficha.
A versão 6.0.2 declara compatibilidade com Astro 3, 4 ou 5 e exige Tailwind CSS ^3.0.24. A documentação de migração orienta remover @astrojs/tailwind ao adotar Tailwind 4.
astro-icon
Coloque ícones SVG locais e conjuntos do Iconify nas páginas do Astro com um único componente Icon, inserido direto no HTML e sem requisição extra.
Instalação
npx astro add astro-iconO astro-icon é uma integração da comunidade, mantida fora do repositório oficial do Astro. Ela oferece um componente Icon que insere o SVG direto no HTML da página.
Registre a integração
O astro add astro-icon registra a integração:
import { defineConfig } from 'astro/config'import icon from 'astro-icon'
export default defineConfig({ integrations: [icon()]})Use um SVG local
Coloque o arquivo em src/icons/ e chame o componente pelo nome do arquivo, sem a extensão:
---import { Icon } from 'astro-icon/components'---
<Icon name="rocket" />O site da Promovaweb usa esse mesmo padrão, com os ícones guardados em src/icons/.
Use um conjunto do Iconify
Para usar um conjunto do Iconify, instale o pacote correspondente. O exemplo do README instala o Material Design Icons:
npm i -D @iconify-json/mdiCompatibilidade
O registro npm da versão 1.2.0, consultado em 5 de novembro de 2026, não declara uma faixa de versões do Astro. O site da Promovaweb roda essa integração com o Astro 7.3.5, versão instalada em 5 de novembro de 2026.
@astrojs/cloudflare
Publique na Cloudflare as rotas que o Astro renderiza a cada requisição, com o adapter oficial, as sessões em Workers KV e o preview local do build.
Instalação
npx astro add cloudflareO @astrojs/cloudflare é um adapter. Ele prepara o build do Astro para rodar na Cloudflare quando o projeto tem rotas renderizadas sob demanda, aquelas que geram o HTML a cada requisição. Um site só com páginas estáticas não precisa de adapter para ser publicado.
Registre o adapter
O astro add cloudflare instala o pacote e registra o adapter no astro.config.mjs:
import { defineConfig } from 'astro/config'import cloudflare from '@astrojs/cloudflare'
export default defineConfig({ adapter: cloudflare()})O que o adapter liga
Com o adapter, as sessões do Astro guardam o estado em Workers KV. A opção sessionKVBindingName aponta o binding usado. A opção imageService escolhe como as imagens são processadas. A documentação oficial cobre também compatibilidade com Node.js, imports de módulos da Cloudflare e preview local do build.
Confira a versão do Astro e do Wrangler
A versão 14.4.6 declara como dependência o Astro na faixa ^7.4.0 e o Wrangler na faixa ^4.125.0, segundo o registro npm consultado em 5 de novembro de 2026. Um projeto com Astro 7.3 ou anterior precisa atualizar o Astro antes de instalar essa versão do adapter.
@astrojs/deno
Consulte a configuração do antigo adapter Deno para Astro 3 e veja a orientação oficial de migração para o adapter mantido pela Deno. Confira as opções.
Instalação
npx astro add denoO @astrojs/deno é o antigo adapter do Astro para executar páginas no Deno. A documentação atual orienta migrar para @deno/astro-adapter, mantido pela Deno, ou escolher outro adapter. A configuração abaixo documenta o pacote npm antigo para manutenção de projetos existentes.
Registro no projeto antigo
O README da versão 5.0.1 registra o adapter no astro.config.mjs com renderização no servidor:
import { defineConfig } from 'astro/config'import deno from '@astrojs/deno'
export default defineConfig({ output: 'server', adapter: deno()})Execute o módulo gerado
O build gera dist/server/entry.mjs. O comando documentado inicia o servidor com as permissões de rede, leitura e variáveis de ambiente:
deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjsA opção start: false desativa a inicialização automática. Nesse modo, você precisa criar o servidor Deno e chamar a função handle exportada pelo módulo gerado.
Porta e migração
As opções port e hostname configuram o servidor iniciado pelo adapter. Os valores padrão são 8085 e 0.0.0.0. Elas não alteram um servidor criado com start: false.
O registro npm da versão 5.0.1 declara a faixa ^3.1.4 do Astro. Para projetos atuais, consulte a orientação de migração da documentação oficial e as instruções do adapter mantido pela Deno.
@astrojs/netlify
Publique rotas Astro sob demanda na Netlify com o adapter oficial e ajuste o processamento de imagens e o middleware na borda. Confira as opções.
Instalação
npx astro add netlifyO @astrojs/netlify prepara as rotas renderizadas sob demanda do Astro para a Netlify. O adapter também integra o serviço de imagens da plataforma, inclusive em projetos com páginas estáticas.
Registre o adapter
A configuração no astro.config.mjs usa a propriedade adapter. Com output: 'server', as páginas são renderizadas sob demanda por padrão:
import { defineConfig } from 'astro/config'import netlify from '@astrojs/netlify'
export default defineConfig({ output: 'server', adapter: netlify()})Execute o middleware na borda
Para executar o middleware também nas páginas pré-renderizadas, configure o modo edge na chamada do adapter:
adapter: netlify({ middlewareMode: 'edge' })Nesse modo, a Netlify executa o middleware nas requisições a páginas e arquivos estáticos. Isso inclui as rotas renderizadas sob demanda.
Ajuste imagens e sessões
O adapter usa a Netlify Image CDN por padrão. Você pode desativar o serviço com imageCDN: false para usar o processamento de imagens configurado no Astro.
As sessões usam o Netlify Blobs como armazenamento padrão. A documentação também descreve staticHeaders para gravar na configuração da Netlify os cabeçalhos das páginas pré-renderizadas.
@astrojs/node
Execute páginas Astro sob demanda em Node.js com um servidor próprio ou como middleware do Express e ajuste a porta de execução. Veja a configuração.
Instalação
npx astro add nodeO @astrojs/node gera um servidor Node.js para as rotas renderizadas sob demanda do Astro. Você pode executar o build como servidor próprio ou integrá-lo a um servidor existente, como o Express.
Registre o adapter
No astro.config.mjs, o modo standalone gera um servidor que inicia ao executar o módulo de entrada:
import { defineConfig } from 'astro/config'import node from '@astrojs/node'
export default defineConfig({ output: 'server', adapter: node({ mode: 'standalone' })})Inicie o build em Node.js
Depois de gerar o build, execute o módulo de entrada. As variáveis HOST e PORT configuram o endereço de escuta:
HOST=0.0.0.0 PORT=4321 node ./dist/server/entry.mjsNo modo standalone, o servidor também serve os arquivos de dist/client/. O modo middleware exporta uma função handler para outro servidor HTTP. Nesse caso, o servidor escolhido precisa servir os arquivos estáticos.
Ajuste o tamanho das requisições
A opção bodySizeLimit define o tamanho máximo do corpo da requisição em bytes. A opção experimentalDisableStreaming desativa o streaming de HTML, mas a documentação desaconselha essa alteração na maioria dos casos. Use-a somente se a hospedagem exigir HTML sem streaming para o cache.
@astrojs/vercel
Publique as páginas Astro sob demanda na Vercel com o adapter oficial e configure o serviço de imagens e o cache das rotas. Confira as opções disponíveis.
Instalação
npx astro add vercelO @astrojs/vercel prepara o build do Astro para publicar rotas renderizadas sob demanda na Vercel. Você também pode usá-lo em um site estático que precise do serviço de imagens da plataforma.
Registre o adapter
No astro.config.mjs, a propriedade adapter recebe a função importada. O exemplo usa renderização no servidor como padrão:
import { defineConfig } from 'astro/config'import vercel from '@astrojs/vercel'
export default defineConfig({ output: 'server', adapter: vercel()})Ative o serviço de imagens
A opção imageService direciona o processamento em produção para a Vercel Image Optimization. Para ativá-la, ajuste a chamada do adapter:
adapter: vercel({ imageService: true })O processamento local usa o serviço indicado em devImageService, cujo padrão é sharp. A opção imagesConfig configura parâmetros como as larguras disponíveis.
Configure o cache das rotas
A opção isr ativa o cache das páginas renderizadas sob demanda. Você pode definir a validade com expiration e retirar rotas do cache com exclude. As requisições atendidas por esse mecanismo não incluem os parâmetros de busca da URL.
O maxDuration ajusta a duração máxima das funções em segundos, dentro dos limites do plano da Vercel. Consulte a documentação do adapter para configurar esses valores.
@astrojs/partytown
Execute scripts de terceiros em web workers com o Partytown no Astro e configure o encaminhamento das chamadas feitas pela página. Confira as opções.
Instalação
npx astro add partytownO @astrojs/partytown ativa o Partytown nas páginas do Astro para executar scripts de terceiros em web workers. Você marca os scripts que devem sair da thread principal, como os usados para anúncios ou análise de visitas.
Registre a integração
No astro.config.mjs, adicione a função à lista integrations:
import { defineConfig } from 'astro/config'import partytown from '@astrojs/partytown'
export default defineConfig({ integrations: [partytown()]})Marque o script de terceiros
O atributo type="text/partytown" identifica o script que o Partytown deve executar. Em uma página Astro, o exemplo fica assim:
<script type="text/partytown" src="/analytics.js"></script>O caminho /analytics.js representa o script de análise do projeto. Na aba Network das ferramentas do navegador, confira a interceptação pelo proxy do Partytown.
Encaminhe chamadas da página
Scripts que expõem funções globais podem precisar de encaminhamento para o web worker. A opção config.forward aceita os nomes dessas chamadas:
partytown({ config: { forward: ['dataLayer.push'] }})A opção config.debug ativa os logs no console. O modo de depuração fica ativo por padrão durante o desenvolvimento e o preview. A documentação também descreve config.resolveUrl para scripts que precisam de um proxy.