Diramo — calcolatori per freelance

Contesto

Diramo è online da luglio 2026 su www.diramo.app, è solo in italiano e non richiede registrazione. È un progetto personale: l'ho ideato e lo sviluppo con l'assistenza di Claude Code, e da settembre 2026 si arricchisce di nuovi strumenti generati con Gemini.

Chi lavora in proprio rifà spesso gli stessi conti, come lo scorporo dell'IVA, la ritenuta d'acconto o la tariffa oraria.

Obiettivo

Volevo un portale di utility che si alimentasse da solo. Diramo dedica a ogni calcolo una pagina con lo stesso schema:

• un form essenziale, con il risultato aggiornato mentre si scrive;
• la spiegazione del metodo, con un esempio numerico svolto;
• approfondimenti, domande frequenti e strumenti correlati.

Il secondo obiettivo era tecnico: capire quanto si può automatizzare la crescita di un portale senza backend, database o gestionale dei contenuti.

Cosa ho fatto

Com'è costruito il sito?

Diramo è un sito statico generato con Astro 7 e TypeScript: le pagine sono HTML pronto e il JavaScript serve solo dove c'è interazione.

• Dati in JSON: ogni strumento è una voce di un file JSON con titolo, categoria, spiegazione, sezioni, FAQ e correlati.
• Calcoli separati dall'interfaccia: la logica è una funzione TypeScript pura; il componente Astro legge i campi e mostra il risultato con un piccolo script vanilla, senza framework UI.
• CSS senza framework: variabili CSS, font di sistema, layout a tre colonne su schermi larghi e menu a scomparsa su mobile.
• Ricerca locale: un indice JSON prodotto in fase di build alimenta una ricerca lato client.
• CI e pubblicazione: GitHub Actions esegue Prettier, type-check e build a ogni push e pubblica in automatico il ramo principale.

Come nasce un nuovo calcolatore?

Lo propone e lo scrive Gemini, due volte a settimana, dentro un workflow di GitHub Actions che esegue uno script Node.js:

1. Gemini sceglie un tema, ricevendo l'elenco degli strumenti esistenti per evitare doppioni e alcuni vincoli: un bisogno ricorrente per chi ha partita IVA, risolvibile con un solo calcolo.
2. Gemini produce la scheda: titolo, categoria, spiegazione, sezioni, FAQ e alcuni casi di prova con valori di ingresso e risultato atteso.
3. Gemini scrive la funzione di calcolo e il componente Astro, prendendo un calcolatore esistente come riferimento di stile.
4. Lo script esegue formattazione, type-check, confronto della funzione con i casi di prova e build completa. Se qualcosa fallisce, l'errore torna a Gemini per una correzione, fino a tre tentativi.
5. Se tutto passa, il calcolatore viene pubblicato senza intervento umano; altrimenti le modifiche vengono annullate e il sito resta com'era.

La parte più difficile

La parte più difficile è stabilire che cosa possono garantire i controlli automatici e che cosa no.

Cosa verificano i controlli automatici?

Verificano che il codice compili, che il sito si costruisca e che la funzione dia i risultati previsti dai casi di prova. Quei casi però li propone Gemini stesso: i controlli misurano la coerenza tra codice e specifica, non la correttezza fiscale o normativa della formula, come un'aliquota, una soglia o una scadenza.

Per questo rileggo ogni calcolatore generato dopo la pubblicazione e, se serve, correggo a mano formule e testi. Ogni pagina riporta inoltre un avviso: i risultati sono stime indicative e non sostituiscono un commercialista.

Risultato

I primi calcolatori (IVA, margine e ricarico, tariffa freelance, prezzo di progetto) li ho sviluppati con Claude Code prima della pipeline; da settembre 2026 i nuovi arrivano dalla generazione automatica. Il sito ha le pagine informative e legali e si sostiene con annunci Google AdSense. Restano da fare la versione inglese e un generatore di preventivi.

Se ti serve un sito statico che cresce con una pipeline automatica, trovi cosa posso fare nella pagina servizi.