Domande e risposte
Le cose che le persone chiedono più spesso su Indigo — licenze, il confronto con builder e boilerplate e com'è costruirci sopra.
È gratis? Dov'è la fregatura?
Indigo è davvero gratis?
Sì. Il framework e quasi tutti i moduli sono gratuiti e open source sotto la licenza permissiva Apache-2.0. Puoi costruire, eseguire e andare online con loro senza alcun costo — inclusi prodotti commerciali a codice chiuso.
Posso usare Indigo commercialmente?
Assolutamente, e senza vincoli. Apache-2.0 non ha alcun obbligo di copyleft, quindi puoi costruire software proprietario a codice chiuso sul core gratuito senza acquistare nulla. Il codice che generi è tuo.
Quali moduli costano?
Solo tre. core-store (e-commerce), core-chat (chat AI con personaggi) e core-ai-writer (generazione di contenuti AI) sono sotto licenza commerciale — i verticali in cui stai chiaramente gestendo un prodotto che genera ricavi. Tutto il resto è gratuito.
Cosa copre la licenza commerciale?
Solo quei tre moduli premium. Acquistare una licenza ti permette di installarli e distribuirli; finanzia lo sviluppo continuo del core gratuito e open source.
È l'ennesimo website builder?
In cosa Indigo è diverso da Wix, Lovable, Bolt o v0?
Quelle sono piattaforme in hosting — la tua app vive sulla loro infrastruttura, costruita con i loro strumenti, prezzata dal loro abbonamento. Indigo è l'opposto: una codebase Next.js vera e open source sulla tua macchina, nel tuo repo git, su cui costruisce il tuo agente di coding. Non c'è nessuna piattaforma, niente da cui esportare e nessun precipizio quando il prototipo deve diventare un prodotto.
In cosa è diverso da ShipFast o create-t3-app?
Un boilerplate ti consegna un'istantanea di codice già cablato — ne erediti la colla, la mantieni per sempre e al tuo agente non dice nulla. Indigo è un framework: le nuove funzionalità si registrano da sole tramite config e moduli, il core condiviso non viene mai modificato, e l'agente riceve una mappa (CLAUDE.md, diagrammi live), un segnale (tipi, test, indigo doctor) e mani (personas MCP) per verificare ciò che ha costruito.
Com'è lavorarci?
È pronto per la produzione?
Indigo include gli aspetti di produzione che la maggior parte degli starter salta — auth, RBAC, billing, real-time, job in background, i18n, SEO e un modello scalabile di ruoli server. È costruito per far girare prodotti veri, non solo demo.
Devo capire l'intera codebase?
No — la maggior parte potresti non leggerla mai. Indigo è guidato dalla config e open-closed: il tuo agente lo estende esattamente dove il sistema si aspetta di essere esteso, e ogni modifica resta un diff piccolo e revisionabile.
Cosa significa «agent-native»?
L'agente è l'interfaccia primaria. Ha una mappa (CLAUDE.md annidati, diagrammi live dell'architettura), un segnale di feedback (tipi rigorosi, test, indigo doctor) e le mani sull'app in esecuzione (strumenti MCP tipizzati, personas di test). Tu descrivi il prodotto; l'agente lo costruisce, lo verifica e ti chiede in chat quando una decisione spetta a te.
Posso aggiungere e rimuovere moduli in seguito?
Sì. I moduli sono subtree git autonomi. bun run indigo add <module> ne installa uno — router, schema, seed e pagine admin inclusi — e remove lo toglie di nuovo.
Come inizio?
Dai al tuo agente una sola frase: claude "Set up a new project named my-app from https://github.com/indigo-fw/starter — ask me what you need". Crea la cartella, installa tutto e ti chiede le tue scelte in chat. Funziona allo stesso modo in Codex e Gemini CLI — e il percorso classico degit + bun run init è sempre lì se preferisci il terminale.
Mi serve proprio Claude?
No. Indigo è agnostico rispetto all'agente: Claude Code, Codex CLI e Gemini CLI funzionano tutti, e le affordance sono standard aperti — file di contesto CLAUDE.md/AGENTS.md, un endpoint MCP, CLI non interattive. Qualsiasi agente di coding in grado di eseguire comandi può eseguire il loop. Puoi anche fare a meno degli agenti e sviluppare a mano.
E se l'agente rompe qualcosa?
L'ambiente è costruito perché non possa rompere nulla in silenzio. TypeScript strict, input vincolati con Zod e controlli di ownership respingono le modifiche sbagliate; indigo doctor e i test valutano ogni passata; il core condiviso non viene mai modificato, così il raggio d'impatto resta dentro la modifica. E ogni passata atterra come un semplice diff git — lo esamini, o lo annulli.
Come arrivano gli aggiornamenti del framework al mio progetto?
Core e moduli vivono nel tuo repo come subtree git, e le tue funzionalità li estendono tramite config e registrazione invece di modificarli — così gli aggiornamenti si integrano puliti, senza collidere con ciò che hai costruito. Nessuna migrazione forzata, nessuna piattaforma che decide per te: fai pull quando decidi tu.
Dove trovo aiuto?
GitHub Discussions per le domande, GitHub Issues per i bug e la documentazione per le guide. Per il supporto commerciale, contatta il team.
Ancora curioso?
Il modo più veloce per capire Indigo è usarlo — la demo live esegue ogni modulo.