Repolode
Enviar
sdorra

sdorra/content-collections

Ferramenta TypeScript que transforma arquivos locais Markdown, MDX, JSON e YAML em coleções de dados com tipos seguros para aplicações web.

Ver no GitHubSite
Estrelas
1,203
Forks
53
Issues abertas
54
Último commit
há 13 horas

O que é?

Content Collections carrega arquivos de um diretório e os transforma em coleções de dados tipadas que sua aplicação pode importar diretamente. Em vez de escrever código para buscar e analisar arquivos de conteúdo, você define coleções em um arquivo de configuração com um schema, e o conteúdo é analisado e validado durante o build.

O schema valida cada entrada, então campos incorretos ou ausentes são identificados no build. As entradas podem ser transformadas antes de chegarem à aplicação, por exemplo, para renderizar Markdown, combinar coleções ou buscar dados em um servidor. Durante o desenvolvimento, as alterações no conteúdo atualizam as coleções sem reiniciar o servidor nem atualizar o navegador.

Há adapters para Next.js, Remix (Vite), SvelteKit, Solid Start, Qwik e Vite, além de uma CLI para outros frameworks.

Recursos principais

  • 01Define coleções tipadas em um arquivo de configuração com um schema.
  • 02Valida o conteúdo durante o build para que os erros sejam identificados cedo.
  • 03Atualiza as coleções automaticamente quando o conteúdo muda durante o desenvolvimento.
  • 04Permite transformar entradas antes que cheguem à aplicação.
  • 05Oferece adapters para vários frameworks e uma CLI para os demais.

Casos de uso

  • Criar um blog ou site de documentação a partir de arquivos Markdown ou MDX em um projeto Next.js ou SvelteKit.
  • Carregar dados estruturados em YAML ou JSON como objetos tipados em uma aplicação Vite.
  • Validar um diretório de conteúdo para que entradas malformadas façam o build falhar.

Início rápido

  1. 1

    Escolha um adaptador para o framework e siga o guia de instalação nos links do README

  2. 2

    Crie um arquivo content-collections.ts na raiz do projeto e defina suas coleções

  3. 3

    Escreva conteúdo Markdown no diretório da coleção e, em seguida, importe a coleção gerada no app

Em coleções

Geradores de sites estáticos e ferramentas de documentação

Tópicos

#content#typescript#markdown#mdx#type-safety#static-site#content-management#collections#content-layer#json

Perguntas frequentes

O que é content-collections?
Ferramenta TypeScript que transforma arquivos locais Markdown, MDX, JSON e YAML em coleções de dados com tipos seguros para aplicações web. Content Collections carrega arquivos de um diretório e os transforma em coleções de dados tipadas que sua aplicação pode importar diretamente. Em vez de escrever código para buscar e analisar arquivos de conteúdo, você define coleções em um arquivo de configuração com um schema, e o conteúdo é analisado e validado durante o build.
content-collections é gratuito? Qual é a licença?
content-collections é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
content-collections ainda é mantido?
Manutenção ativa. O último commit de content-collections foi em 6 de nov. de 2026.
Para que posso usar content-collections?
Criar um blog ou site de documentação a partir de arquivos Markdown ou MDX em um projeto Next.js ou SvelteKit. Carregar dados estruturados em YAML ou JSON como objetos tipados em uma aplicação Vite. Validar um diretório de conteúdo para que entradas malformadas façam o build falhar.
Como instalar content-collections?
Escolha um adaptador para o framework e siga o guia de instalação nos links do README Crie um arquivo content-collections.ts na raiz do projeto e defina suas coleções Escreva conteúdo Markdown no diretório da coleção e, em seguida, importe a coleção gerada no app
Onde consigo content-collections?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/sdorra/content-collections

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados