Preparando o Banco de Variáveis e Docker

Com o projeto baixado, o próximo passo é conectar o serviço de banco de dados (PostgreSQL). Para facilitar o desenvolvimento local, o seu Boilerplate SaaS já conta com um orquestrador pronto do Docker Compose.

1. Variáveis de Ambiente

O projeto possui dois arquivos de ambiente cruciais separados pelas apps (api e web).

Na raiz da sua pasta apps/api:

1. Copie o arquivo apps/api/.env.example
2. Cole e renomeie para .env

E para o Frontend:

1. Copie o arquivo apps/web/.env.example
2. Cole e renomeie para .env

Os valores contidos nos arquivos de exemplo já apontam para portas de banco de dados e APIs locais prontas para funcionar de imediato. Não é necessário mudar as URLs principais durante a fase de desenvolvimento, mas você precisará adicionar certas senhas (ex: Resend) caso vá usar integrações reais.

2. Inicializando o Docker

Para levantar o seu banco de dados (que receberá a configuração do Prisma no próximo passo) você deverá rodar o Docker Compose em qualquer janela do terminal na raiz do seu monorepo.

(Certifique-se de que você tem o Docker Desktop rodando na sua máquina se utilizar Mac/Windows)

# Na raiz do seu projeto (mesmo local do package.json main)
docker compose up -d

O argumento -d roda de forma invisível. Se abrir o seu aplicativo do Docker Desktop, você verá o contêiner do PostgreSQL rodando saudavelmente.

Com Banco de Dados no ar, vamos para a estrutura das tabelas usando o Prisma.