https://github.com/saidone75/simple-mindmaps
Una web app leggera e immediata per creare mappe mentali in pochi click
https://github.com/saidone75/simple-mindmaps
mind-map mindmap mindmaps
Last synced: 27 days ago
JSON representation
Una web app leggera e immediata per creare mappe mentali in pochi click
- Host: GitHub
- URL: https://github.com/saidone75/simple-mindmaps
- Owner: saidone75
- License: gpl-3.0
- Created: 2026-04-17T07:13:23.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T08:48:40.000Z (29 days ago)
- Last Synced: 2026-05-30T10:16:17.505Z (29 days ago)
- Topics: mind-map, mindmap, mindmaps
- Language: Java
- Homepage:
- Size: 545 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🧠✨ Alice's Simple Mind Maps
Benvenuto in **Alice's Simple Mind Maps**, una web app leggera e immediata per creare mappe mentali in pochi click.
Pensata per essere intuitiva anche per chi non è tecnico ma costruita con uno stack solido e moderno.
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://sonarcloud.io/summary/new_code?id=saidone75_alice-s-simple-mind-maps)
[](https://sonarcloud.io/summary/new_code?id=saidone75_alice-s-simple-mind-maps)
[](https://sonarcloud.io/summary/new_code?saidone75_alice-s-simple-mind-maps)
## 🚀 Cos'è
Simple MindMap è un'applicazione Java/Spring Boot con interfaccia Thymeleaf che permette di:
- creare una nuova mappa,
- aggiungere rami e sotto-rami,
- personalizzare testo e stile,
- esportare il risultato.
Obiettivo: **trasformare idee in una struttura visiva chiara**.
---
## 🌟 Caratteristiche principali
- ✅ Creazione mappa rapida
- ✅ Template pronti (Italiano, Scienze, Storia, Geografia)
- ✅ Generazione mappe con AI
- ✅ Drag & drop dei nodi
- ✅ Modifica testo, colore e dimensione font
- ✅ Autosave dei nodi
- ✅ Export PNG
- ✅ Export PDF stampabile
- ✅ Eliminazione mappe e nodi
---
## 🧱 Stack tecnologico
### Backend
- **Java 21**
- **Spring Boot 3.3.1**
- **Spring Data JPA**
- **H2 Database** (persistito su file)
### Frontend
- **Thymeleaf**
- **JavaScript vanilla**
- **SVG** per rendering visuale della mappa
### Build & Tooling
- **Maven**
---
## 📋 Prerequisiti
Prima di avviare il progetto assicurati di avere:
- **JDK 21** installato
- **Maven 3.9+** disponibile da terminale
- Un browser moderno (Chrome, Edge, Firefox)
Verifica veloce:
```bash
java -version
mvn -version
```
---
## 🛠️ Avvio locale
1. Clona il repository
2. Avvia l'app:
```bash
mvn spring-boot:run
```
3. Apri nel browser:
```text
http://localhost:8080/maps
```
---
## 🔌 API / Endpoints principali
> Nota: l'app usa pagine server-side Thymeleaf + chiamate AJAX per i nodi.
### UI routes
- `GET /maps` → elenco mappe
- `GET /maps/{id}` → editor della mappa
### Operazioni mappe (backend)
- Creazione nuova mappa
- Eliminazione mappa
- Export HTML stampabile
### Operazioni nodi (backend/API interne)
- Creazione nodo (principale/figlio)
- Aggiornamento nodo (testo, colore, font, posizione)
- Eliminazione nodo
- Salvataggio automatico modifiche
---
## 💾 Persistenza dati
- Database locale H2 persistito su file in:
- `./data/mindmapdb`
- Nessuna dipendenza da DB esterno per lo sviluppo iniziale.
---
## 📤 Export
- **PNG**: export client-side dal browser
- **HTML**: export server-side in formato semplice e stampabile
---
## 🧪 Idee per evoluzioni future
- Export PDF server-side
- Undo/Redo completo
- Multiutenza con login
- Libreria icone e sticker
- Condivisione mappe via link
---
## 🤝 Contributi
Hai idee per rendere l'app ancora più utile o divertente?
Apri una issue o proponi una PR: ogni contributo è il benvenuto. 🚀