🎨 Kitunga Web

Biblioteca de componentes UI da Sinangu — usada pelos projectos Masolo.

📋 Visão Geral

O Kitunga Web é a biblioteca de componentes partilhados usada nos frontends da Sinangu. Inclui inputs, botões, cartões, estados vazios e outros elementos reutilizáveis construídos com React, TypeScript, Next.js e CSS Modules.

🛠️ Stack Tecnológica

• React >= 18
• Next.js 16 com App Router
• TypeScript
• CSS Modules

🚀 Início Rápido

Pré-requisitos

• Node.js >= 18.0.0
• pnpm >= 8.0.0

Instalação

pnpm install

Scripts disponíveis

# Modo desenvolvimento (documentação + playground de componentes)
pnpm dev

# Build de produção do site de documentação
pnpm build

# Build da biblioteca para publicação
pnpm build:lib

# Publicar a biblioteca no npm
pnpm publish:lib

# Lint
pnpm lint

⚙️ Gestão com PM2

O kitunga-web corre em modo de desenvolvimento na porta 3005 (definida em .env.local) e é gerido pelo PM2 através do ecosystem.config.cjs.

Comandos úteis

# Iniciar o processo (modo dev com hot reload)
pm2 start ecosystem.config.cjs

# Parar o processo
pm2 stop kitunga-web

# Remover o processo do PM2
pm2 delete kitunga-web

# Reiniciar com a configuração actual
pm2 reload ecosystem.config.cjs

# Ver logs em tempo real
pm2 logs kitunga-web

# Listar processos
pm2 list

# Guardar a lista de processos para reiniciar após reboot
pm2 save

# Limpar logs antigos
pm2 flush

Modo desenvolvimento (hot reload)

Por omissão, o PM2 corre pnpm dev.

pm2 start ecosystem.config.cjs

Modo produção

1. Gera o build do site:

   pnpm build

2. No ecosystem.config.cjs, muda args de 'dev' para 'start':

   args: 'start'

3. Actualiza o PM2:

   pm2 reload ecosystem.config.cjs

📦 Publicação da biblioteca

Antes de consumir as alterações noutros projectos (como o masolo-messenger-web), é necessário gerar e publicar a biblioteca:

pnpm build:lib
pnpm publish:lib

Depois actualiza a versão no package.json do projecto consumidor e corre pnpm install.

📄 Licença

Sinangu — Todos os direitos reservados.