Este guia coloca a plataforma rodando na sua máquina. O tempo total costuma ficar abaixo de dez minutos, sendo a maior parte o download das cartas.

Pré requisitos

• Node.js 20 ou superior.
• PostgreSQL 17 em execução localmente. No macOS, via Homebrew: brew services start postgresql@17.

Passos

1. Instalar dependências

npm install

2. Preparar o banco

Crie o banco (caso ainda não exista) e aplique as migrações:

createdb mtg_web
npx prisma migrate dev

3. Importar as cartas

Baixa o dump oracle_cards da Scryfall e popula o banco. São cerca de 176 MB e algumas dezenas de milhares de cartas.

npm run import:cards

4. Calcular as tags de efeito

Este passo lê o texto de regras de cada carta e grava as tags de efeito que alimentam a busca por alternativas.

npm run tag:cards

5. Publicar o conteúdo inicial

Cria os posts de Atualizações e Blog que aparecem na página inicial.

npm run seed:posts

6. Subir o servidor

npm run dev

Abra http://localhost:3000.

Variáveis de ambiente

O arquivo .env precisa de duas chaves:

DATABASE_URL="postgresql://USUARIO@localhost:5432/mtg_web"
AUTH_SECRET="uma_string_aleatoria"

O AUTH_SECRET pode ser gerado com openssl rand -base64 32.

Mantendo as cartas atualizadas

A Scryfall publica um novo dump diariamente, com cartas novas e mudanças de legalidade. Para atualizar, rode na ordem:

npm run import:cards
npm run tag:cards

O primeiro substitui a tabela de cartas e o segundo recalcula as tags de efeito.