Início Rápido

Passo 0 — Máquina nova (do zero)

Se você ainda não tem nada instalado, comece por aqui. O projeto usa Node.js 24 (LTS) e pnpm 12 (fixado em pnpm@12.3.1 no package.json).

# 1. Instalar o Node.js 24 (LTS)
#    No Debian/Ubuntu o node do apt é antigo demais — use o NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
#    Alternativa: nvm (https://github.com/nvm-sh/nvm) → nvm install 24

# 2. Instalar o pnpm 12
sudo npm install -g corepack
corepack enable                 # usa a versão fixada (pnpm@12.3.1)
#    Alternativa: sudo npm install -g pnpm@12.3.1

# 3. Clonar o repositório e instalar as dependências
git clone https://github.com/barateza/neemias.git && cd neemias
pnpm install --frozen-lockfile

Pronto — agora siga o fluxo abaixo.

Rodar o Neemias

# 1. Instalar dependências (idempotente — pode rodar de novo)
pnpm install

# 2. Iniciar o backend (Worker + D1 local)
pnpm dev:worker          # http://localhost:8788

# 3. Aplicar migrations e popular dados demo
pnpm db:migrate:local
pnpm db:seed

# 4. Iniciar o frontend
echo 'VITE_BACKEND_URL=http://localhost:8788' > app/.env
pnpm dev                 # http://localhost:5173

# 5. Entrar com as credenciais demo
#    admin@neemias.local / senha123

Testes E2E (Playwright): instale o Chromium com pnpm --dir app exec playwright install --with-deps chromium.

Comandos principais

Comando	Ação
pnpm dev	Servidor de desenvolvimento do frontend
pnpm dev:worker	Servidor de desenvolvimento do Worker
pnpm dev:fullstack	Frontend + Worker em paralelo
pnpm build:app	Build do frontend para produção
pnpm test	Testes (pnpm -r test)
pnpm docs:dev	Servidor de documentação VitePress

Veja a estrutura do repositório para entender a organização do monorepo.