Skip to content

Pré-requisitos

Tudo que você precisa instalar antes de rodar o fast_deliv localmente.

Node.js 20+

O frontend usa Next.js 16 com React 19, que requerem Node.js 20 ou superior.

# Verificar versão instalada
node --version   # deve ser >= 20.0.0
npm --version    # deve ser >= 10.0.0

Instalação via nvm (recomendado):

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reiniciar shell e instalar Node 20 LTS
nvm install 20
nvm use 20
nvm alias default 20

Instalação direta (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

Python 3.12

O backend requer Python 3.12 exatamente (especificado em pyproject.toml com requires-python = ">=3.12").

# Verificar versão instalada
python3 --version   # deve ser >= 3.12.0

Instalação via pyenv (recomendado):

# Instalar pyenv
curl https://pyenv.run | bash

# Adicionar ao shell (~/.bashrc ou ~/.zshrc)
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# Instalar Python 3.12
pyenv install 3.12.9
pyenv global 3.12.9

Ubuntu/Debian (deadsnakes PPA):

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev

uv (Gerenciador de Pacotes Python)

uv é o gerenciador de pacotes ultrarapido do backend — substitui pip, venv e pip-tools.

# Instalar uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Verificar instalação
uv --version   # deve ser >= 0.4

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Git 2.40+

git --version   # deve ser >= 2.40

Ubuntu/Debian:

sudo apt install git

Ferramentas Opcionais (Recomendadas)

Bruno (API Client)

Alternativa ao Postman para testar endpoints localmente.

# Download em https://www.usebruno.com/
# Ou via snap:
sudo snap install bruno

Supabase CLI

Útil para rodar migrations e inspecionar o banco localmente.

npm install -g supabase
supabase --version

Docker (para testes locais do Supabase)

# https://docs.docker.com/engine/install/
sudo apt install docker.io docker-compose

Checklist de Verificação

Antes de prosseguir para Environment Setup, confirme:

  • [ ] node --version mostra v20.x.x ou superior
  • [ ] npm --version mostra 10.x.x ou superior
  • [ ] python3 --version mostra 3.12.x
  • [ ] uv --version mostra versão instalada
  • [ ] git --version mostra versão instalada
  • [ ] Conta no Supabase criada
  • [ ] Conta no ASAAS Sandbox criada
  • [ ] API Key do OpenRouteService obtida