@tabnews/temp_name

TabNews Config

Ferramenta para configurar um ambiente de desenvolvimento e testes com as mesmas configurações utilizadas no TabNews, incluindo:

• CLI do TabNews
• Variáveis de ambiente com dotenv-expand
• Test Runner Vitest
• Contêineres Docker
  • Banco de dados PostgreSQL
  • Servidor de email MailCatcher

Requisitos

• Node.js
• Docker e Docker Compose

Instalação

Para adicionar ao projeto, execute o comando:

npm i -D @tabnews/config

Para utilizar a CLI, instale globalmente com o comando:

npm i -g @tabnews/config

Utilização

Scripts NPM

Adicione scripts no package.json do projeto, por exemplo:

{
  "scripts": {
    "dev": "tn --verbose",
    "build": "tn build --seed",
    "start": "tn start",
    "test": "tn test run",
    "test:watch": "tn test"
  }
}

CLI

Para iniciar os serviços utilizando as variáveis de ambiente de desenvolvimento, execute o seguinte comando (lembre-se de instalar globalmente a CLI):

tn

Todos os demais comandos podem ser consultados com:

tn --help

Alguns comandos possuem subcomandos, que também podem ser consultados através da CLI, por exemplo:

tn migration -h

Variáveis de ambiente

De acordo com o comando em execução, as variáveis de ambiente correspondentes serão carregadas a partir dos seguintes arquivos, se existirem:

• Sempre carregadas:

  • .env (variáveis padrão)
  • .env.local (variáveis locais)

• Carregadas de acordo com o comando em execução:

  • .env.development (variáveis de desenvolvimento)
  • .env.development.local (variáveis de desenvolvimento locais)
  • .env.test (variáveis de teste)
  • .env.test.local (variáveis de teste locais)
  • .env.production (variáveis de produção)
  • .env.production.local (variáveis de produção locais)

A CLI aceita o parâmetro --env-mode (ou -e) para especificar um ambiente diferente do padrão para o comando, por exemplo, para subir o servidor de desenvolvimento com variáveis de ambiente de teste, mas sem executar os testes, execute:

tn --env-mode test

Exemplo de variáveis utilizadas no TabNews

POSTGRES_USER=user
POSTGRES_PASSWORD=password
POSTGRES_DB=tabnews
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DATA_DIR=pgdata

NEXT_PUBLIC_WEBSERVER_HOST=localhost
NEXT_PUBLIC_WEBSERVER_PORT=3000

EMAIL_SMTP_HOST=localhost
EMAIL_SMTP_PORT=1025
EMAIL_HTTP_HOST=localhost
EMAIL_HTTP_PORT=1080