API REST com Bun, Elysia, Postgres e Prisma: Guia Moderno e Prático

Bun puro: rápido, mas insuficiente

Começar uma API com Bun puro é tentador pela performance e simplicidade. Só que, logo nos primeiros endpoints CRUD para um blog, surgem problemas: dependência apenas do Bun, ausência de banco de dados, rotas pesadas e sem validação. Parece profissional, mas não passa de MVP frágil.

O salto de maturidade: Elysia, Postgres e Prisma

Adicionar Elysia para orquestrar as rotas, Postgres como banco principal e Prisma como ORM transforma a API. O código fica limpo, validado, rápido e pronto para crescer conforme a demanda. Nada de reinventar a roda: aqui você resolve problemas de verdade.

Por que Elysia e não outra?

Elysia explodiu em adoção porque une produtividade extrema e performance com Bun. Você poderia optar por Hono ou Fastify ou até Express, mas para Bun, Elysia é o ponto de partida favorito da comunidade.

Por que Prisma no Bun?

Prisma elimina o pesadelo de query manual e mapeamento de tipos. Ele está amadurecendo no Bun, entrega velocidade, DX e adoção transversal entre times Node/JS, além de trazer Vue de validação, migrations e scripts automáticos — tudo configurável, sem fricção.

Setup: criando o projeto com Bun Create

O ponto de partida: bun create elysia bun-elysia-prisma . Simples, coerente — você já começa com servidor pronto, dependências e scripts de dev out of the box. O comando instala o Elysia, prepara scripts e expõe o server rodando em localhost:3000 em segundos.

Prisma: inicializando e configurando o ORM

Instale o Prisma: <code>bun add prisma</code> . Em seguida, rode <code>bunx prisma init</code> : gera o diretório prisma/ e o arquivo .env , onde mora a config do banco.

Banco de dados Postgres local — sem complicação

Crie seu banco com Docker: <code>docker run --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=12345678 -d postgres</code> . Basta ajustar usuário, senha e database no .env conforme o container criado.

Modelando com Prisma: seu esquema e migrations

Desenhe o schema <code>prisma/schema.prisma</code> criando o modelo Post com id, title, content, createdAt e updatedAt. Rode <code>bunx prisma migrate dev --name create-post-model</code> para gerar a primeira migration e criar a tabela real rapidamente.

Populate seu banco: seeds de dados reais

Crie o diretório scripts/ e um seed.js . Use o Prisma Client para popular o banco com posts de teste. Utilize o método upsert , assim você evita duplicatas e garante dados enquanto desenvolve e testa a API.

Testando requests: automatização e produtividade

Em vez de digitar <code>curl</code> a cada chamada, use um arquivo request-tester.http . Centralize suas requisições e repita execuções com um clique — economize tempo e tenha histórico das APIs testadas.

Arquitetura organizada: rotas modulares

Mantenha as rotas agrupadas em routes/posts/index.ts . Importe e prefixe todas com /posts usando Elysia. Traz clareza: cada rota explícita, cada função documentada, cada handler isolado.

Handlers desacoplados: manipulação limpa

Os handlers não tocam o server, só o banco: isolando responsabilidades, facilitando manutenção e reaproveitamento de lógica. Exportando funções como getPosts , getPostById , updatePost , cada uma executa só o necessário — máxima previsibilidade, mínima gambiarra.

Endpoints CRUD completos: GET, POST, PATCH, DELETE

Você prova maturidade do backend quando suas rotas CRUD funcionam de ponta a ponta: GET all, GET by id, POST para criar, PATCH para atualizar, DELETE para remover. E tudo versionado sob /api/posts, já preparado para produção.

Prefixos e versionamento: facilidade desde o começo

Configure o prefix /api no server — e todas as rotas de posts sob /api/posts . Evite conflitos e mantenha a expansão do projeto organizada. Com isso, testes, integrações externas e manutenção futura ficam dezenas de vezes mais simples.

Ganhe ritmo: testando e validando de verdade

Com banco real, seeds, rotas modulares e handlers limpos, seus endpoints podem ser testados com requests automatizados. Cada chamada retorna dados do banco, cada alteração já reflete no banco — sem state falso, sem cenário fake.

Checklist final: entregando qualidade — evite erros clássicos!

A API está pronta para uso e expansão, mas revise: 1) Banco versionado com migrations e scripts de seed; 2) Rotas modularizadas e validadas; 3) Handlers protegidos por capturas de erro; 4) Testes de requests automáticos e documentados; 5) Secrets seguros e variáveis de ambiente separadas.

Você no comando: apenda e escale com consciência

Criando APIs com Bun, Elysia, Prisma e Postgres, você salta níveis no back-end moderno. Escape do caos do código improvisado. Aprofunde seus testes. Documente cada passo. Siga evoluindo. E volte neste artigo sempre que precisar de clareza.

BÔNUS: Acesse o vídeo completo e vá além

Quer cada passo detalhado com código real e explicações visuais? Assista ao guia em vídeo no canal: <a href="https://www.youtube.com/@DevDoido">Veja no YouTube</a> . Tire dúvidas, deixe comentários, peça temas — a comunidade cresce com sua dúvida e sua experiência.

Perguntas frequentes

Se você atacar «O salto de maturidade: Elysia, Postgres e Prisma» primeiro, o que muda em 48h?

Do texto: Adicionar Elysia para orquestrar as rotas, Postgres como banco principal e Prisma como ORM transforma a API. O código fica limpo, validado, rápido e pronto para crescer conforme a demanda. Nada de reinventar a roda: aqui você resolve problemas de verdade.

Como amarrar «Por que Elysia e não outra?» a uma métrica única?

Elysia explodiu em adoção porque une produtividade extrema e performance com Bun. Você poderia optar por Hono ou Fastify ou até Express, mas para Bun, Elysia é o ponto de partida favorito da comunidade. Em «Por que Elysia e não outra?», trate como experimento com dono e prazo — não como lista de intenções.

Qual erro de execução «Por que Prisma no Bun?» tenta evitar?

Comece pelo mecanismo: Prisma elimina o pesadelo de query manual e mapeamento de tipos. Ele está amadurecendo no Bun, entrega velocidade, DX e adoção transversal entre times Node/JS, além de trazer Vue de validação, migrations e scripts automáticos — tudo configurável, sem fricção.

Como explicar «Setup: criando o projeto com Bun Create» sem virar checklist motivacional?

Critério do material: O ponto de partida: bun create elysia bun-elysia-prisma . Simples, coerente — você já começa com servidor pronto, dependências e scripts de dev out of the box. O comando instala o Elysia, prepara scripts e expõe o server rodando em localhost:3000 em segundos. Se precisar de segundo sinal: Entrou no projeto novo e não viu scripts dev e start ? Ajuste seu package.json — eles poupam seu tempo para cada mudança small do código.

Continue explorando