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

• 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

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 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

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

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

bunx astro add react

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

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

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

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

bunx astro add vercel

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

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

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

• Crie uma aplicação com Astro e Bun

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