Ho finalmente lanciato Lubinik.dev.

Questa frase sembra molto più ordinata della storia reale che c’è dietro.

Lubinik non è nato come un framework già rifinito, con un nome, una roadmap e un sito pubblico immaginato fin dall’inizio. È nato in modo più silenzioso, da progetti WordPress che continuavano a chiedere le stesse basi, la stessa struttura, gli stessi strumenti di amministrazione e la stessa separazione tra ciò che appartiene a un solo sito e ciò che dovrebbe essere riutilizzabile.

A un certo punto, quello che stavo costruendo per i progetti dei clienti è diventato un sistema vero e proprio. Lubinik.dev è il posto in cui posso finalmente documentare quel sistema in modo chiaro.

E siccome ogni framework sembra aver bisogno di un piccolo mito privato dietro al nome: Lubinik nasce dalla mia ricerca di un nome unico, mescolato con i nomi dei miei due cani, Blu e Niki. Suonava abbastanza insolito da appartenere al progetto, quindi è rimasto.

Non proprio un lancio di prodotto

Non penso a Lubinik come a un prodotto che sto cercando di vendere.

È qualcosa di più personale. È il mio framework WordPress, la mia memoria di lavoro, e l’architettura che uso per smettere di ricostruire a mano le stesse fondamenta ogni volta che inizia un nuovo progetto.

Il sito pubblico non serve a far sembrare che il framework sia apparso già completo. È costruito come un diario, perché questa è la forma più onesta del progetto. Lubinik è cresciuto attraverso siti reali, refactor, prime versioni un po’ disordinate, ripetizioni fastidiose e piccole decisioni che sono diventate evidenti solo dopo che la versione sbagliata mi aveva insegnato qualcosa.

Il lancio di Lubinik.dev è quindi meno un “ecco una cosa finita” e più un “ecco la storia di come questa cosa è diventata abbastanza utile da meritare una casa propria”.

Cos’è Lubinik

Lubinik è un framework WordPress su misura composto da diversi livelli, ognuno con un compito preciso.

• Il tema parent gestisce la meccanica condivisa del sito: struttura dei layout, menu, header, footer, sezioni riutilizzabili, template e strumenti lato tema.
• Il plugin core fornisce il livello backend condiviso per gli addon: sistemi di amministrazione, registrazione degli shortcode, caricamento dei template, componenti riutilizzabili, asset, gallerie, calendari, filtri, tab e shortcode di utilità.
• Gli addon contengono la logica di dominio per tipi di siti specifici, come siti BnB, rifugi animali, comics, curriculum, portfolio freelance e contenuti showcase.
• I temi child conservano l’identità visiva, i template specifici del progetto, i design pack e la configurazione del singolo sito.
• I plugin di supporto gestiscono traduzione, SEO, dati strutturati, output API, aggiornamenti e altri sistemi che devono collegarsi in modo pulito senza diventare parte obbligatoria di ogni progetto.
• Lo scaffolder trasforma la struttura ripetuta di addon e temi child in configurazione, così l’avvio di un nuovo progetto non dipende da un copia-incolla fragile.

Lo scopo non è rendere tutto astratto. Lo scopo è mettere le cose giuste nel posto giusto.

Perché aveva bisogno di un sito tutto suo

Per molto tempo, Lubinik è esistito soprattutto dentro repository, installazioni WordPress locali, note private e siti costruiti con il framework.

Funzionava finché il sistema era piccolo. Ma quando il framework ha iniziato a includere un tema parent, un plugin core, diversi addon, temi child, plugin di supporto, un updater privato, strumenti di sincronizzazione locale e uno scaffolder, è diventato più difficile spiegare il progetto dall’esterno.

Il sito dà al framework una forma leggibile. Può mostrare i componenti, documentare i case study e tenere insieme gli articoli cronologici del blog, così l’evoluzione del sistema non sparisce dentro la cronologia dei commit.

Questo conta, perché Lubinik non è solo codice. È anche una traccia di decisioni.

Il diario conta

Il blog su Lubinik.dev è scritto volutamente come un diario.

Comincia dalla prima frustrazione: cercare di fare pace con WordPress, costruire un tema BnB e capire che alcune parti del lavoro venivano ricostruite troppo spesso. Poi segue il progetto attraverso i primi refactor, la separazione tra tema e plugin, l’addon BnB, l’addon rifugio, i template dinamici, i temi child, i design pack, i plugin di supporto, lo sviluppo assistito dall’IA, lo scaffolder, gli aggiornamenti privati e il momento in cui il sistema è diventato abbastanza mantenibile da essere affidabile su siti reali.

Volevo che questa storia restasse visibile, perché è il modo più onesto per spiegare il framework. Lubinik non è nato prima dalla teoria. È nato costruendo cose reali e ascoltando quando gli stessi problemi tornavano con forme diverse.

Un framework non è solo un insieme di file riutilizzabili. È anche la memoria di ciò che è diventato abbastanza doloroso da meritare un sistema migliore.

Costruito con il sistema che documenta

C’è una piccola soddisfazione nel fatto che Lubinik.dev sia anche un sito Lubinik.

Il sito non è soltanto una brochure sul framework. Usa la logica del framework stesso: un tema child per il livello visivo, contenuti showcase per presentare componenti e strumenti, articoli di blog per documentare il diario, e la stessa disciplina architetturale che Lubinik dovrebbe portare negli altri progetti.

Questo rende il sito una specie di prova. Non perfetta, perché un framework personale non è mai davvero finito, ma viva. Se il sistema deve aiutarmi a costruire e mantenere siti WordPress personalizzati, allora anche il suo sito dovrebbe poter poggiare su quella stessa base.

Cosa cambia con il lancio

Lanciare Lubinik.dev non significa che il framework sia completo.

Significa che il progetto è ora abbastanza visibile da poter essere documentato pubblicamente. Significa che l’architettura ha un luogo in cui essere spiegata. Significa che i cambiamenti futuri possono essere aggiunti a una timeline invece di sparire nelle note private. Significa anche che posso indicare il sistema dietro al mio lavoro per i clienti senza trasformare ogni spiegazione in una piccola storia orale delle mie decisioni su WordPress.

E, sinceramente, dà al progetto anche un po’ più di responsabilità. Quando qualcosa ha una casa pubblica, diventa più difficile trattarlo come una pila di cartelle che solo io capisco vagamente.

Guardando avanti

La prossima fase di Lubinik non riguarda il renderlo più grande solo per il gusto di farlo.

Riguarda il rendere i pezzi esistenti più calmi, più chiari e più facili da riutilizzare: scaffolding migliore, generazione più pulita dei temi child, aggiornamenti più affidabili, superfici API più solide, supporto SEO e dati strutturati più forte, e addon pratici che continuano a nascere da progetti reali invece che da liste astratte di funzionalità.

Lubinik.dev dà a questo lavoro un posto in cui vivere.

Non come annuncio finale, ma come diario continuo di un framework iniziato per caso e diventato lentamente una delle cose più utili che abbia costruito.