Use Bun com Astro

Bun é um completo ambiente de execução e kit de ferramentas JavaScript. Veja a documentação oficial Bun para mais informações.

Cuidado

Usar Bun com Astro pode revelar alguns casos extremos. Algumas integrações podem não funcionar como esperado. Consulte a documentação oficial Bun para trabalhar com Astro para detalhes.

Se você tiver problemas usando Bun, por favor abra uma issue diretamente no GitHub de Bun.

Pré-requisitos

Seção intitulada Pré-requisitos

• Bun instalado localmente na sua máquina. Veja as instruções de instalação na documentação oficial Bun.

Criar um novo projeto Astro com Bun

Seção intitulada Criar um novo projeto Astro com Bun

Crie um novo projeto Astro com Bun usando o seguinte comando create-astro:

bunx create-astro@latest my-astro-project-using-bun

Dica

Você também pode criar um novo projeto Astro a partir de qualquer repositório Astro existente no GitHub usando a marcação --template:

bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal

Instalar dependências

Seção intitulada Instalar dependências

Se você está iniciando um novo projeto com bunx create-astro, a CLI usará automaticamente o Bun para instalar as dependências, e você pode pular esta etapa.

Caso contrário, será necessário instalar suas dependências com Bun:

bun install

Adicionar Tipos

Seção intitulada Adicionar Tipos

Bun publica o pacote @types/bun, que contém os tipos de tempo de execução para Bun.

Instale @types/bun usando o seguinte comando:

bun add -d @types/bun

Usar integrações do Astro

Seção intitulada Usar integrações do Astro

Você pode usar qualquer uma das integrações oficiais do Astro com o comando astro add:

bunx astro add react

Executar Astro com Bun

Seção intitulada Executar Astro com Bun

Nota

Use a marcação --bun na CLI antes de cada comando astro para usar o próprio ambiente de execução Bun em vez do Node.

Executar o servidor de desenvolvimento

Seção intitulada Executar o servidor de desenvolvimento

Para executar o servidor de desenvolvimento usando o Bun como ambiente de execução, use o seguinte comando:

bunx --bun astro dev

Construir seu site com Bun

Seção intitulada Construir seu site com Bun

Para construir seu site usando o Bun como ambiente de execução, use o seguinte comando:

bunx --bun astro build

Astro gerará o seu site no diretório dist/. Em seguida, você pode servir seu site usando o comando preview:

bunx --bun astro preview

Adicionar SSR com Bun

Seção intitulada Adicionar SSR com Bun

Como Bun possui compatibilidade com a API Node.js, você pode usar qualquer adaptador Astro para renderização no lado do servidor em seu projeto Astro:

bunx astro add vercel

Testando no Bun

Seção intitulada Testando no Bun

Bun vem com um executor de testes integrado, rápido e compatível com Jest, através do comando bun test. Se você quiser usá-lo, leia a documentação bun test.

No entanto, também é possível usar Cypress ou Playwright para uma abordagem moderna de testes para aplicativos web.

Cypress

Seção intitulada Cypress

Cypress é uma ferramenta de testes front-end que tem a missão de “tornar a experiência de teste agradável e gerar felicidade para os desenvolvedores”. Isso permite que você escreva testes de ponta a ponta para o seu site Astro.

Instale Cypress com o seguinte comando:

bun add cypress --dev

Para o restante da configuração e para iniciar seu primeiro teste, siga o processo completo do Cypress no Guia de Testes Astro.

Playwright

Seção intitulada Playwright

Playwright é um framework de testes de ponta a ponta que permite testar seu código Astro em todos os motores de renderização modernos, incluindo Chromium, WebKit e Firefox.

Instale o Playwright usando o seguinte comando:

bun create playwright

Para criar seu primeiro teste Playwright, siga as instruções no Guia de Testes Astro.

Recursos Oficiais

Seção intitulada Recursos Oficiais

• Crie uma aplicação com Astro e Bun

Recursos da Comunidade

Seção intitulada Recursos da Comunidade

Usando Bun com Astro? Adicione sua postagem ou vídeo nesta página!

• Construindo um site Cloudflare Pages com Bun - postagem de blog