Skip to main content

Cos’è Diagram Forge?

Diagram Forge analizza qualsiasi repository GitHub con Claude AI e genera un diagramma di architettura interattivo e animato — completo di loghi tecnologici ufficiali, flussi di particelle animati, inspector dei nodi ed esportazione in SVG/PNG/Markdown. Il pagamento viene gestito tramite Lightning Network utilizzando il protocollo L402 — nessun account, nessuna carta di credito, nessun abbonamento. Paga per ogni analisi.
Diagram Forge interactive viewer demo

Per Iniziare

Opzione 1 — App web (più veloce)

  1. Vai su forge.l402kit.com
  2. Incolla qualsiasi URL GitHub pubblico (es. https://github.com/vercel/next.js)
  3. Scegli un livello: Basic (100 sats), Full (500 sats), o Live ✦ (1000 sats)
  4. Clicca Analyze & Generate Diagram
  5. Paga la fattura Lightning con qualsiasi wallet — oppure inserisci un codice promozionale per l’accesso gratuito
  6. Il tuo diagramma interattivo si apre automaticamente

Opzione 2 — Estensione VS Code

Installa dal Marketplace:
code --install-extension ShinyDapps.diagram-forge
Oppure cerca “Diagram Forge” nel pannello Estensioni (Ctrl+Shift+X).
Diagram Forge VS Code extension — idle, confirming, analyzing, done
Utilizzo:
  1. Apri qualsiasi progetto con un remote GitHub
  2. Clicca sull’icona di Diagram Forge nella barra delle attività (barra laterale sinistra)
  3. Clicca Analyze Repo — l’URL GitHub viene rilevato automaticamente
  4. Scegli il livello + inserisci il codice promozionale (facoltativo)
  5. Paga con Lightning o usa il codice promozionale
  6. Il diagramma si apre nel browser

Opzione 3 — Collega GitHub (app web)

Clicca Connect GitHub nella navigazione in alto dell’app web per autorizzare e ottenere un menu a tendina di tutti i tuoi repo — senza dover copiare e incollare URL.

Livelli di Analisi

LivelloPrezzoCosa ottieni
Basic100 sats (~$0.10)Scansione rapida — top 10 file, servizi principali rilevati
Full500 sats (~$0.50)Repo completo — tutti i servizi, connessioni, monorepo
Live ✦1000 sats (~$1.00)Analisi completa + SVG animato con flussi di particelle
I prezzi Lightning sono significativamente inferiori rispetto ai prezzi con carta perché non ci sono commissioni di elaborazione del pagamento.

Non hai un wallet Lightning?

Inizia in meno di 2 minuti:

Wallet of Satoshi

Il wallet mobile più semplice — custodial, configurazione immediata

Phoenix

Mobile, self-custodial, senza KYC

Alby

Estensione browser — funziona direttamente in VS Code
Dopo l’installazione, acquista una piccola quantità di Bitcoin (anche $1 copre decine di analisi) e scansiona il codice QR quando Diagram Forge mostra la fattura.

Codici Promozionali

Hai un codice promozionale? Inseriscilo nel campo “Promo code (optional)” prima di cliccare Analyze — l’analisi viene eseguita completamente gratis, senza necessità di wallet. I codici promozionali hanno una validità temporale e un limite di utilizzi. Controlla forge.l402kit.com o segui @ShinyDapps per i codici attuali.

Cosa mostra il diagramma

Ogni diagramma include:
  • Nodi — servizi, database, code, API, modelli ML, CDN rilevati nel tuo codice
  • Archi — connessioni tra componenti con etichette di protocollo (HTTP, SQL, gRPC, WebSocket, AMQP…)
  • Loghi — branding ufficiale Simple Icons per 80+ tecnologie
  • Flussi animati — particelle che si muovono lungo gli archi, colorate per tipo di protocollo (giallo = Lightning, blu = HTTP, verde = SQL…)
Funzionalità del visualizzatore interattivo:
  • Pan & zoom (scorri per zoomare, trascina per spostarti)
  • Clicca su qualsiasi nodo per ispezionare le sue connessioni e descrizione
  • Minimappa per diagrammi di grandi dimensioni
  • Cerca nodi per nome o tipo
  • Esporta: SVG, PNG, Markdown, Draw.io
  • Link di condivisione: /g/:id — URL condivisibile permanente per ogni diagramma

Importa da immagine

Non hai un repository GitHub? Carica una foto di una lavagna, uno screenshot, un file Visio o un PDF — Claude estrae l’architettura e genera lo stesso diagramma interattivo. Formati supportati: JPG, PNG, WEBP, GIF, PDF

Benchmark dell’Architettura

Dopo aver generato un diagramma, clicca Benchmark nel visualizzatore per ottenere un punteggio di qualità in 6 dimensioni:
DimensioneCosa misura
ScalabilitàPotenziale di scaling orizzontale, colli di bottiglia
AffidabilitàPunti singoli di guasto, ridondanza
SicurezzaAutenticazione, crittografia, superficie di esposizione
OsservabilitàCopertura di logging, metriche e tracing
ManutenibilitàAccoppiamento, complessità, modularità
Efficienza dei CostiFacoltativamente — costo per servizio rispetto al valore

Privacy

  • Il tuo codice viene clonato temporaneamente su un server sicuro, analizzato, poi eliminato immediatamente
  • Solo i metadati del grafo (etichette dei nodi, connessioni degli archi — nessun codice sorgente) vengono memorizzati se utilizzi i link di condivisione
  • Nessun account richiesto, nessuna conservazione dei dati oltre al diagramma

Come utilizza l402-kit

Diagram Forge è costruito sulla Managed Mode di l402-kit — il modo più semplice per accettare pagamenti Lightning senza gestire un nodo:
import { l402, ManagedProvider } from "l402-kit";

const provider = ManagedProvider.fromAddress("pinkfalcon21@primal.net", {
  registerDirectory: {
    url: "https://forge.l402kit.com/analyze",
    name: "Diagram Forge — Architecture Analysis",
    priceSats: 500,
    description: "AI-powered living architecture diagrams from any repo",
    category: "ai",
  },
});

// Gate the /analyze endpoint — returns 402 until paid
app.post("/analyze", l402({ priceSats: 500, lightning: provider }), handler);
Quando un client chiama POST /analyze senza un preimage valido:
HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="...", invoice="lnbc..."
Il client paga la fattura e riprova con Authorization: L402 <macaroon>:<preimage>. Vuoi costruire qualcosa di simile? Consulta la guida rapida di l402-kit.

App Web

Analizza qualsiasi repo GitHub pubblico nel tuo browser

Estensione VS Code

Esperienza completa nella barra laterale all’interno di VS Code

Codice Sorgente

Licenza MIT — fai un fork, estendilo, costruisci sopra

Guida Rapida l402-kit

Costruisci il tuo servizio protetto da L402 in pochi minuti