DevMap

Sistema desktop offline para gerenciar projetos, APIs, repositórios e bancos de dados de forma centralizada.

---

📌 Sobre o Projeto

DevMap é uma aplicação desktop totalmente offline, construída com Electron, que centraliza o gerenciamento de tudo que um desenvolvedor precisa acompanhar no dia a dia:

• ✅ Projetos — crie e gerencie projetos com status, responsável e datas
• 🔌 APIs / Endpoints — documente as rotas de cada projeto (método, rota, controller)
• 🗄️ Bancos de Dados — registre conexões e configurações de banco por projeto
• 🐙 Repositórios — vincule repositórios GitHub com stack e observações
• 📋 Tasks — acompanhe tarefas internas por projeto

Toda a informação fica armazenada localmente em um banco SQLite, sem depender de nenhum serviço externo.

---

🧱 Stack

🖥️ Frontend

Tecnologia	Uso
React 19	Interface do usuário
TypeScript	Tipagem estática
Vite	Bundler e dev server
React Router DOM v7	Roteamento
Axios	Requisições HTTP
CSS Vanilla	Estilização com variáveis de design próprias

⚙️ Backend

Tecnologia	Uso
Express 5	API REST local
TypeScript	Tipagem estática
better-sqlite3	Banco de dados SQLite local
ts-node-dev	Hot reload em desenvolvimento

🖱️ Desktop

Tecnologia	Uso
Electron	Empacotamento desktop (Windows, macOS, Linux)

---

📁 Estrutura do Projeto

devmap/
├── electron/          # Configuração do Electron (main process)
├── frontend/          # Aplicação React (Vite + TypeScript)
│   └── src/
│       ├── components/    # Componentes reutilizáveis (Modal, Cards, Form, Icons)
│       ├── models/        # Interfaces TypeScript
│       ├── pages/         # Páginas da aplicação
│       ├── services/      # Camada de acesso à API
│       └── styles/        # CSS global e por componente
├── backend/           # API Express (TypeScript)
│   └── src/
│       ├── controllers/   # Lógica de cada rota
│       ├── database/      # Conexão e migrations SQLite
│       ├── models/        # Interfaces do banco
│       └── routes/        # Definição de rotas
└── devmap.db          # Banco de dados SQLite (gerado automaticamente)

---

🚀 Como rodar localmente

Pré-requisitos

• Node.js v18+
• npm

1. Clone o repositório

git clone https://github.com/lukinhasc-dev/devmap.git
cd devmap

2. Instale as dependências

# Raiz (Electron)
npm install

# Backend
cd backend && npm install

# Frontend
cd ../frontend && npm install

3. Inicie o backend

cd backend
npm run dev

A API sobe em http://localhost:3000

4. Inicie o frontend

cd frontend
npm run dev

O Vite sobe em http://localhost:5173

5. (Opcional) Inicie o Electron

# Na raiz do projeto
npm start

---

📥 Download

🚧 Em breve!

O DevMap será disponibilizado como um instalador nativo — sem necessidade de clonar o repositório, instalar Node.js ou configurar nada manualmente.

Basta baixar o executável para o seu sistema operacional e começar a usar:

Plataforma	Formato
Windows	.exe (instalador)
macOS	.dmg
Linux	.AppImage

Fique de olho nas Releases do GitHub para acompanhar quando estiver disponível.

---

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

---

Feito com ☕ por Lukinhas