README.md

2026-1 MeasureSoftGram Frontend

Frontend repository of MeasureSoftGram application in 2026.1.

Badges

🚧 Work in Progress 🚧

Requirements

Local development (without Docker)

• Node.js 20.x
• corepack enabled
• pnpm 10.x

Development with Docker

• Docker
• Docker Compose v.2

---

Environment configuration

Create the .env file at the root of the project:

cp .env.example .env

Make sure to set the URL for your backend API.

Running with Docker (recommended)

O compose do Front sobe somente o serviço front. Backend (Service + Postgres) é responsabilidade do compose do repositório 2026.1-MeasureSoftGram-Service — suba lá primeiro.

1) Subir o Service (em outro terminal, no repo do Service)

cd ../2026.1-MeasureSoftGram-Service
cp -R env-vars-example env-vars   # primeiro setup
docker compose up -d

API disponível em http://localhost:8080.

2) Subir o Front

docker compose up --build

Aplicação disponível em http://localhost:3000.

No container do Front, SERVICE_URL aponta para http://host.docker.internal:8080 para acessar o Service rodando no host. No browser, NEXT_PUBLIC_API_URL segue como http://localhost:8080.

3) Parar containers

docker compose down

4) Scripts Úteis

• Rodar linter:

make lint

• Rodar testes:

make test

• Rodar testes no modo CI:

make ci-test

• Build de Produção

make build
make start

• Comandos personalizados

make pnpm SCRIPT=<script> [ARGS="..."]

permite executar qualquer script do package.json dentro do container, passando argumentos adicionais se desejado.

Exemplo:

make pnpm SCRIPT=build

ou

make pnpm SCRIPT=test ARGS="src/pages"

Rodar localmente (sem Docker)

Primeiramente garanta que está utilizando a versão 20 do Node. Ferramentas para gerenciamento de versões Node como nvm e n podem ser úteis.

1) Ativar pnpm

corepack enable
corepack prepare pnpm@10.15.0 --activate
pnpm -v

2) Instalar dependências

pnpm install

3) Subir o projeto

pnpm dev

Aplicação disponível em: http://localhost:3000

4) Scripts úteis

• Rodar linter:

pnpm lint

• Rodar testes:

pnpm test

• Rodar testes no modo CI:

pnpm run ci:test

• Build de produção:

pnpm build
pnpm start

Troubleshooting

Erro de versão do Node com pnpm

Se aparecer algo como: This version of pnpm requires at least Node.js v18.12

Garanta que você está usando Node 20:

node -v
v20.20.2

Erro de permissão no .next (EACCES)

Se aparecer erro ao rodar pnpm dev:

sudo chown -R $USER:$USER .next node_modules .pnpm-store
chmod -R u+rwX .next
rm -rf .next
pnpm dev

Evite rodar comandos de node/pnpm com sudo dentro do projeto.

Governança e contribuição

• Licença: este projeto é distribuído sob a GNU AGPL-3.0.
• Código de conduta: consulte CODE_OF_CONDUCT.md antes de interagir com a comunidade.
• Como contribuir: veja CONTRIBUTING.md para padrões de branch, PR e revisão.