🧾 Visão Geral

📌 Nome do Projeto

projeto-monday – Integração com monday.com

🎯 Objetivo

Este projeto foi desenvolvido com o objetivo de demonstrar uma integração personalizada com a plataforma monday.com, sem o uso do scaffolding automático (monday-cli, atualmente depreciado).

A aplicação foi construída do zero utilizando React com Vite e integra o SDK oficial da monday para consumo de dados contextuais e comunicação entre a aplicação e a plataforma via iframe.

Este projeto serve como base para aplicações futuras mais robustas, como dashboards customizados, widgets e automações específicas dentro do ecossistema da monday.

👨‍💻 Desenvolvedor Responsável

• Rogério Vidal
  GitHub: @rogeregrge

🛠️ Tecnologias Utilizadas

• Frontend: React + Vite
• Tunelamento local: ngrok
• Ambiente de produção: Vercel (projeto-monday.vercel.app)
• Integração com monday:
  • SDK oficial monday-sdk-js
  • API GraphQL

📦 Estrutura do Projeto

/src
  /components     → Componentes reutilizáveis React
  /views          → Telas (ex: MainView, SettingsView)
  /utils          → Funções auxiliares para integração
  index.tsx       → Ponto de entrada da aplicação

🔗 Funcionalidades Implementadas

• Leitura do contexto atual (boardId, itemId) via SDK
• Queries de dados via GraphQL da monday
• Comunicação com o iframe de embed
• Configuração feita manualmente no ambiente de desenvolvedor da monday
• Publicação em ambiente de produção utilizando a Vercel

📚 Próximos Passos

• Adicionar escrita de dados nos boards
• Criar formulários dinâmicos baseados no schema da monday