Costruire HelioPeak: lezioni dallo sviluppo iOS indipendente

Alcuni mesi di sere e weekend, sei lingue, tre piattaforme, uno sviluppatore

Questo articolo è stato scritto in inglese e tradotto con assistenza AI. Leggi l'originale →

Questo è l'ultimo articolo della serie originale, ed è quello con la minore pretesa di utilità generale. I quattordici articoli precedenti parlavano di fotovoltaico, di PVOutput, di monitoraggio, delle questioni pratiche legate alla gestione di un impianto fotovoltaico domestico. Questo racconta come una sola persona ha costruito un piccolo software per quel pubblico, nell'arco di qualche mese di sere e weekend. Se hai seguito la serie per i contenuti tecnici, puoi fermarti qui; nulla in questo articolo cambierà il modo in cui i tuoi pannelli producono chilowattora. Se invece hai mai pensato di costruire qualcosa di piccolo per un pubblico di nicchia e ti sei chiesto come sia davvero farlo nel 2026, questo articolo è per te.

Sarò onesto sulle scelte che ho fatto, sugli errori che ho commesso e sulle parti del lavoro che mi hanno sorpreso. L'obiettivo non è sostenere che qualcuno debba fare ciò che ho fatto io. È descrivere com'è stato farlo, per un progetto specifico.

Perché costruire un'altra app solare

La prima domanda, quella che avrebbe dovuto fermarmi all'inizio e che quasi ci è riuscita, era se il mondo avesse bisogno di un'altra app PVOutput per iOS. Abbiamo passato in rassegna il panorama in Monitoraggio solare su iOS: confrontare le opzioni nel 2026: sull'App Store c'erano già tre opzioni serie, ciascuna con il suo pubblico, ciascuna mantenuta da qualcuno che aveva a cuore il problema. Gli argomenti onesti a favore di una quarta app erano scarsi.

Ciò che mi ha spinto ad andare avanti è stata un'osservazione sulla mia abitudine quotidiana di consultazione. Le app esistenti eccellevano ciascuna in qualcosa di specifico, ma nessuna era l'app che avevo davvero voglia di aprire ogni mattina. Una aveva uno splendido flusso di energia animato, ma un design visivo che sembrava precedente a SwiftUI. Un'altra era semplice e affidabile, ma le mancava l'analisi pluriennale che mi interessava. Un'altra ancora era sviluppata attivamente, ma non esisteva nella mia lingua. Non c'era un'app che unisse un design nativo moderno, un'analisi storica approfondita, il supporto per iPhone e iPad (e per i Mac con Apple silicon tramite la versione per iPad) e la visione a lungo termine di chi osserva gli stessi pannelli stagione dopo stagione.

È l'eterna trappola dello sviluppatore indipendente: notare un vuoto in un mercato già piccolo di suo e decidere di passare diversi mesi a colmarlo. L'argomento economico non è mai stato forte. L'argomento personale, volere che lo strumento esistesse, soprattutto per me, è ciò che mi ha sostenuto nelle prime settimane. Sospetto che valga per la maggior parte dei progetti indipendenti in mercati maturi. Costruisci ciò che vuoi usare e speri che abbastanza persone condividano i tuoi gusti.

Il punto di partenza: non uno sviluppatore Swift

Ho una lunga esperienza nell'IT: sistemi, infrastruttura, architettura, le parti dello stack tecnologico che stanno diversi livelli sotto l'interfaccia utente. Prima di questo progetto non avevo mai scritto un'applicazione in Swift. Non avevo mai usato SwiftUI. Non mi ero mai mosso sul serio in Xcode. Avevo costruito strumenti a riga di comando, script di automazione, infrastructure-as-code, servizi web, le cose che un informatico accumula nel corso di una carriera. Non avevo mai costruito un'app nativa rifinita per una piattaforma consumer.

Sembra un ostacolo evidente alla costruzione di un'app iOS nativa rifinita. In un altro decennio sarebbe stato fatale. Nel 2026 è gestibile, per due motivi.

Il primo motivo è che l'ecosistema per sviluppatori di Apple è diventato straordinariamente accessibile per chi arriva da discipline affini. SwiftUI è, per gli standard dei framework di interfaccia nativi, un sistema insolitamente pulito e facile da imparare. La documentazione è completa. Il simulatore funziona abbastanza bene da poter sviluppare senza testare di continuo su un dispositivo. La toolchain è gratuita. Tutte le informazioni necessarie per costruire un'app valida sono disponibili, per chi ha una cultura generale di programmazione, senza una formazione specifica.

Il secondo motivo è che gli assistenti di programmazione basati sull'IA hanno cambiato la leva a disposizione di un singolo sviluppatore. Non voglio drammatizzare; penso che la copertura trafelata degli strumenti di IA abbia già fatto la sua parte di danni alle conversazioni oneste sull'argomento. Ma la realtà pratica è che un assistente IA, usato con attenzione, permette a chi non è uno sviluppatore Swift di produrre codice più vicino allo SwiftUI idiomatico di quanto avrebbe potuto fare da solo, e di riconoscere schemi e scelte architetturali che altrimenti richiederebbero anni di esperienza sulla piattaforma. Ho usato Claude per tutto il progetto, verificando ogni pezzo di codice generato con il mio istinto da informatico e con la documentazione, e trattandolo come un collaboratore senior anziché come una bacchetta magica. Il risultato è un'app che da solo non avrei potuto costruire in tempi ragionevoli, e che spetta a me capire e mantenere. È il modello che ha funzionato per me; credo sia anche quello che funzionerà per la maggior parte degli sviluppatori indipendenti che costruiranno strumenti di nicchia nei prossimi anni.

Com'era davvero il lavoro

Il tempo totale di sviluppo di HelioPeak, secondo il mio calcolo approssimativo, è di diversi mesi di sere e weekend, non di un impegno a tempo pieno. A volte qualche ora in una serata, a volte un weekend lungo, a volte una pausa di più settimane perché la vita o l'attività di consulenza si mettevano di mezzo. Non è un lavoro a tempo pieno. È il progetto che procede in parallelo a un'attività di consulenza già esistente.

Le prime tre settimane sono servite solo ad arrivare a una build che partisse e mostrasse qualcosa di utile da PVOutput. L'API di PVOutput è semplice, ma ha alcune stranezze non ovvie (il tetto di 100 record di getoutput.jsp per gli account gratuiti, l'asimmetria dei limiti di richieste tra account gratuiti e account donatore, il modo in cui getstatistic restituisce le date) che hanno richiesto un po' di esplorazione. La maggior parte di quel tempo iniziale è andata nelle tubature dei dati e nell'impalcatura di base in SwiftUI, niente che si potrebbe definire interessante.

Alla settimana 4 la dashboard di base funzionava. Alla settimana 5 i grafici erano abbastanza buoni da guardarli ogni giorno. Alla settimana 6 c'era qualcosa che si poteva plausibilmente chiamare beta. La prima versione inviata ad Apple per la revisione è stata rifiutata. La seconda è passata. Il primo utente pagante è arrivato una settimana dopo il lancio. Alla fine del secondo mese l'app supportava più sistemi e sei lingue, e aveva un report annuale in PDF, widget, Note, un livello di sincronizzazione iCloud e le fondamenta architetturali per ciò che è ancora nella roadmap.

Ripensandoci, la parte del lavoro che ha richiesto più tempo non è stata quella che mi aspettavo. Costruire funzioni è più veloce di quanto pensi. Rifinirle richiede più tempo di quanto pensi. L'ultimo venti per cento di ogni funzione (lo stato vuoto quando non ci sono dati, lo stato di caricamento quando l'API è lenta, lo stato di errore quando la rete cade, le etichette di accessibilità, i testi localizzati in sei lingue, il layout per iPad che deve essere sottilmente diverso da quello per iPhone) richiede complessivamente più tempo della costruzione originale della funzione. Non l'ho capito fino a dopo qualche ciclo.

Sei lingue dal primo giorno

La decisione di localizzare l'app in sei lingue fin dalla prima versione pubblica è stata presa presto e mai davvero giustificata dai dati. L'argomento era semplice: il pubblico di un'app PVOutput per iOS è in gran parte europeo, l'Europa è multilingue, e un'app solare solo in inglese sembrerebbe provinciale a un utente olandese o tedesco. L'argomento contrario era altrettanto semplice: localizzare in sei lingue alla prima versione è molto lavoro per un pubblico che ancora non esiste.

Ho localizzato comunque, e ne sono ancora contento. La base di utenti emersa nelle prime settimane era effettivamente europea, e una parte significativa leggeva l'app in olandese, francese o tedesco anziché in inglese. Le localizzazioni in italiano e spagnolo hanno prodotto basi di utenti più piccole, ma reali. Il costo in tempo di sviluppo iniziale è stato significativo (forse una ventina di ore in più per il primo lancio), ma da allora è stato trascurabile. Le nuove funzioni vengono localizzate nel momento in cui vengono scritte, il che è molto più rapido che aggiungere la localizzazione a posteriori.

La lezione generale è che le decisioni sul perimetro tendono a essere più facili da difendere se prese all'inizio che se recuperate in seguito. Localizzazione, accessibilità, supporto della modalità scura, il supporto per iPhone e iPad (i Mac con Apple silicon eseguono poi la versione per iPad): sono cose più facili da integrare subito che da aggiungere dopo. Quando si parte, la tentazione è saltarle per arrivare prima sul mercato. Il costo di quella decisione cresce con ogni funzione successiva che devi adattare.

Il primo rifiuto

La prima volta che ho inviato l'app all'App Store, la revisione non è andata a buon fine. Il motivo era procedurale e non sostanziale (Apple voleva chiarimenti su un elemento della descrizione e degli screenshot, non su un problema dell'app in sé), ma il risultato era lo stesso. L'invio è rimasto per diversi giorni nella coda di Apple. Lo stato «In Review», che controllavo ogni giorno, è diventato «Rejected». L'e-mail che ho ricevuto era formulata con garbo e indicava chiaramente come procedere, ma l'esperienza è sembrata più grande di quanto avrebbe dovuto.

È una di quelle piccole esperienze da sviluppatore a cui nessuna quantità di letture ti prepara. Gli sviluppatori indipendenti descrivono il primo rifiuto come un rito di passaggio, e non hanno torto. La correzione ha richiesto due ore. Riprendersi emotivamente ha richiesto di più.

Il secondo invio è stato approvato. Il terzo, il quarto, il quinto e molti dei successivi sono stati per lo più approvati al primo tentativo, con occasionali domande procedurali risolte rapidamente. La lezione è che il processo di revisione dell'App Store è fondamentalmente collaborativo e non ostile, ma servono alcuni cicli per interiorizzarlo. Apple ha un lavoro da fare; i suoi revisori vedono migliaia di app; cercano cose specifiche; soddisfare i loro criteri una volta ti insegna cosa fare tutte le volte successive. Il primo rifiuto sembra personale. Al quinto invio, la revisione è solo una parte ordinaria del rilascio di un software.

Conquistare i primi cento utenti

I primi utenti sono arrivati da un post sul forum di PVOutput. La community che lo frequenta è il pubblico naturale di un'app PVOutput: piccola, appassionata, competente e raggiungibile con un unico thread. Il post ha ricevuto qualche risposta, i primi utenti paganti sono arrivati nel giro di una settimana, e il piccolo ma reale volano ha cominciato a girare.

La seconda ondata è arrivata dai post in olandese su Tweakers e su un forum olandese di appassionati di fotovoltaico. Tweakers, in particolare, ha una cultura che apprezza il dettaglio tecnico e tollera poco i discorsi di marketing, quindi la discussione è stata impegnativa ma costruttiva. Gli utenti hanno trovato bug che io non avevo trovato. Gli utenti hanno suggerito funzioni davvero migliori di quelle che avrei costruito di mia iniziativa. Gli utenti hanno confrontato l'app con le concorrenti con un livello di dettaglio che nessun sondaggio può darti.

La terza ondata è arrivata da Reddit (r/solar, r/iOS, r/homeassistant quando una funzione diventava pertinente), da MacStories (una proposta inviata a viticci@macstories.net per valutare una recensione, che non ha prodotto alcun articolo ma è sembrata il passo giusto) e dal passaparola nella community fotovoltaica belga. Ogni canale ha portato un piccolo numero di utenti; messi insieme, hanno fatto numero.

La lezione sulla distribuzione è che, per una piccola app di nicchia, non esiste un unico canale magico. Ci sono diversi canali adeguati, ognuno dei quali porta da una manciata a qualche decina di utenti, e il lavoro consiste nel trovarli, pubblicarci in modo appropriato (cioè non da venditore, ma da utente tra gli utenti) e trattare le risposte con rispetto. Nel 2026 la distribuzione indipendente somiglia più alla blogosfera dei primi anni 2010 che all'algoritmo di raccomandazione dell'App Store. È lenta e personale, e funziona se le dai tempo.

La questione del prezzo

Il prezzo iniziale dell'acquisto «Sblocca sistemi multipli» era di 2,99 €. Dopo qualche settimana di utilizzo reale e una revisione importante della versione, ho alzato il prezzo a 6,99 €. Chi aveva già acquistato ha mantenuto lo sblocco al vecchio prezzo; solo i nuovi acquisti hanno pagato il nuovo importo. Il ragionamento era semplice: l'app era cresciuta molto dal lancio, il valore offerto era più alto, e 6,99 € restava ben al di sotto di quanto costano strumenti professionali equivalenti. La preoccupazione era reale: un aumento di prezzo avrebbe scoraggiato gli utenti?

Empiricamente, la risposta è stata no. I tassi di conversione dopo l'aumento sono stati paragonabili a quelli di prima. Gli acquirenti che apprezzavano l'app hanno pagato il nuovo prezzo senza lamentarsi; quelli che avrebbero rinunciato al vecchio prezzo probabilmente avrebbero rinunciato comunque. La lezione, che avevo letto nei racconti di altri sviluppatori indipendenti ma che ho davvero interiorizzato solo vedendola nei miei dati, è che la maggior parte delle app indipendenti ha un prezzo troppo basso rispetto al valore che offre. Raramente è il prezzo a farti perdere una vendita. Ciò che conta è quanto l'app risponde al bisogno reale dell'utente.

Il prezzo attuale, 6,99 € una tantum, con una versione gratuita che copre un sistema reale, dovrebbe restare stabile per il prevedibile futuro. Prima o poi potrebbe aggiungersi una versione Pro in abbonamento per funzioni che richiedono un servizio continuativo (previsioni nel cloud, aggregazione di più sistemi), ma il cuore dell'app è un acquisto unico, ed è il modello che mi aspetto di mantenere.

Cosa farei diversamente

Ripensando a quei mesi di lavoro, le cose che farei diversamente sono per lo più piccole e, col senno di poi, ovvie.

Avvierei le analisi d'uso fin dal primo giorno, non da una versione successiva. Le prime settimane hanno prodotto dati che sarebbe stato prezioso conservare, e li ho persi perché non avevo ancora capito come raccoglierli senza violare i miei stessi principi di privacy. (Alla fine ci sono riuscito; vedi La questione della privacy: di quali dati ha davvero bisogno un'app di monitoraggio solare?.) Quei dati persi non torneranno.

Scriverei più test. L'investimento nei test unitari sembrava lento all'epoca, ma il ritorno è stato notevole: fare refactoring di un'app ben testata è qualitativamente diverso dal farlo su una che non lo è. I punti del codice in cui all'inizio ho risparmiato sui test sono quelli in cui ancora oggi mi innervosisco a fare modifiche.

Documenterei le decisioni architetturali man mano che le prendo. Più volte durante questo progetto ho dovuto ricostruire a ritroso le mie stesse scelte di design perché non ricordavo più perché le avessi fatte. Una breve nota architetturale al momento mi avrebbe fatto risparmiare ore in seguito.

Una nota sul lavorare con l'aiuto dell'IA

Ho accennato prima che ho usato un assistente di programmazione basato sull'IA per tutto il progetto. Voglio dire qualcosa di più al riguardo, perché è un tema carico di tensioni e credo che le discussioni accese non colgano come funziona davvero nella pratica.

Il modello che ha funzionato per me è stato trattare l'IA come un collaboratore senior con una conoscenza approfondita della piattaforma, ma nessuna conoscenza del contesto specifico del progetto e nessun interesse per il risultato a lungo termine. Ogni pezzo di codice che generava, l'ho letto. Ogni proposta architetturale, l'ho valutata alla luce del mio istinto e della documentazione. Ogni affermazione del tipo «questo è lo schema standard per X», l'ho verificata prima di adottarla. Quando l'IA sbagliava, e ha sbagliato spesso, me ne accorgevo perché leggevo con attenzione, non perché me lo dicesse l'IA. La responsabilità del codice dell'app è interamente mia. La leva era reale, ma richiedeva un uso partecipe, non una delega.

Il bilancio onesto è che senza questo strumento quest'app non esisterebbe. La versione di me con una solida esperienza IT ma senza esperienza di iOS nativo avrebbe sbattuto contro il muro degli idiomi di Swift e degli schemi di SwiftUI molto prima di finire l'app, e avrebbe rinunciato oppure rilasciato qualcosa di decisamente peggiore. La versione con lo strumento è riuscita a rilasciare qualcosa di cui vado fiero. È questa la vera storia di come viene costruito molto software indipendente nel 2026. Gli sviluppatori che dicono di non usare questi strumenti a volte dicono la verità e a volte nascondono un certo imbarazzo; la conversazione meriterebbe più onestà di quella che di solito ha.

Dove andrà da qui

La roadmap da qui in avanti è, in ordine: qualche piccola correzione e miglioramento delle funzioni principali esistenti, poi analisi e previsioni più approfondite (probabilmente la versione Pro, quando sarà il momento). Niente di tutto questo è urgente. L'app fa ciò per cui è nata, e la scelta di cosa aggiungere dopo è guidata dalle funzioni che gli utenti vogliono davvero, piuttosto che da ciò che sarebbe tecnicamente interessante costruire.

La domanda a più lungo termine è se HelioPeak crescerà fino a diventare qualcosa che richiede più del tempo libero di una persona, o se resterà nel territorio artigianale e indipendente in cui si trova oggi. Non ho ancora un'opinione netta. Entrambe le strade sono percorribili per un'app in questa nicchia. Ciò che voglio evitare è la strada in cui l'ambizione supera la capacità e la qualità ne risente.

Un pensiero conclusivo, per la serie

Questo è stato il quindicesimo articolo della serie e l'ultimo di quella originale; un sedicesimo, su un test di sei assistenti IA con dati solari, è arrivato più tardi. Nei quattordici precedenti ho cercato di condividere ciò che ho imparato in anni di gestione di un impianto fotovoltaico domestico in Belgio, monitorandolo con PVOutput e riflettendo con attenzione su ciò che i dati mi dicono e non mi dicono. L'obiettivo era essere utile ad altri proprietari alle prese con la stessa curva di apprendimento, non vendere qualcosa in particolare.

Se hai letto fin qui, hai tutta la mia gratitudine. Il fotovoltaico in Belgio nel 2026 è un tema più interessante di quanto gli si riconosca, e le persone a cui sta a cuore tendono a essere le stesse che tengono a fare bene le piccole cose. I dati sul tuo tetto, le scelte che fai su come usarli, le app a cui ti affidi per mostrarteli, le conversazioni con il tuo installatore quando qualcosa non torna: tutto questo si accumula nei 25 anni in cui i tuoi pannelli resteranno lassù.

HelioPeak è, in fin dei conti, solo uno strumento in quel panorama. Se ti è utile, è il complimento più grande. Se qualcos'altro risponde meglio alle tue esigenze, usalo pure. Il punto non è mai stato l'app. Il punto erano i dati, il rapporto con i dati e lo sguardo lungo.

Grazie per aver letto.

← Torna all'indice del blog
ENNLFRDEITES