Código aberto

Este site é software livre, sob licença MIT. O código está no GitHub e você pode rodar na sua máquina, modificar e hospedar a sua própria instância — inclusive com as suas chaves de API.

Nada do que você avalia é enviado para um servidor. O card existe enquanto está sendo feito e vira a imagem que você leva embora; o seu catálogo fica guardado no seu navegador, neste aparelho.

Rodar na sua máquina

Precisa de Node.js 22 ou mais novo.

git clone https://github.com/fmssec/eu-avaliei.git
cd eu-avaliei
npm install
npm run dev

Abre em http://localhost:3000 e funciona sem nenhuma chave de API — a busca traz livros pela Open Library, que é aberta.

Com Docker

docker compose up --build

Instala tudo dentro da imagem, sem precisar de Node na sua máquina.

Ligar filmes, séries e jogos

Copie .env.example para .env.local e preencha o que quiser usar. Cada fonte é independente: sem a chave, aquela categoria simplesmente não aparece na busca.

LivrosOpen Library — não precisa de chave

Filmes e sériesTMDB — TMDB_API_KEY e MEDIA_PROVIDER=tmdb

JogosIGDB — TWITCH_CLIENT_ID e TWITCH_CLIENT_SECRET, de um app registrado na Twitch

Hospedar a sua instância

O repositório traz um render.yaml: no Render, escolha New → Blueprint e aponte para o seu fork. Ele cria o serviço configurado, restando só digitar as chaves. Qualquer plataforma que rode um container Docker também serve.

As instruções completas, com as ressalvas de cada plataforma, estão no README.

Sobre os dados

Os metadados vêm do TMDB, da Open Library e do IGDB. Capas e pôsteres são obra dos estúdios e editoras, não das APIs — por isso dá para anexar a sua própria imagem, e por isso nenhuma arte de terceiro está versionada no repositório.

Este site usa o TMDB e as APIs do TMDB, mas não é endossado, certificado ou aprovado pelo TMDB.