Importare un’app

Non devi per forza partire da zero. Se l’app esiste già altrove, Setherion può leggerla e ricostruirla qui, e da quel momento è una normale app di Setherion che modifichi chiedendo.

Ci sono cinque modi per entrare. Quale scegliere dipende da ciò che hai.

Importare un’app

È la via d’ingresso per il codice. Si trova nella dashboard, in tre punti: Import an app nel menu + accanto al campo di testo, Import nella colonna a sinistra, e Import an app nella palette dei comandi (Ctrl K).

Da GitHub

Incolla l’indirizzo di un repository, come https://github.com/owner/name, oppure solo owner/name, e premi Import. Un repository pubblico non richiede altro.

Per uno privato, premi Connect GitHub nella stessa finestra. Ti fa accedere a GitHub una volta sola, e poi puoi cercare tra i tuoi repository, con quelli privati contrassegnati da Private, e sceglierne uno. È la stessa connessione a GitHub che usa l’esportazione su GitHub. L’elenco mostra i tuoi 100 repository con il push più recente; qualsiasi altro si può comunque importare incollando il suo indirizzo.

Viene letto il branch predefinito. Un repository più grande di 60 MB viene rifiutato: scaricalo come ZIP senza le immagini e i video, e importa quello.

Da uno ZIP

Trascina un .zip sulla finestra, oppure sceglilo. Lo ZIP viene aperto nel tuo browser, e viene inviato solo il suo codice. Uno ZIP sopra gli 80 MB viene rifiutato, quindi lascia fuori le immagini e i video.

Da Lovable, Bolt, v0 o Base44

Questi builder tengono fuori dal codice una parte di ciò che fa funzionare un’app, come i suoi dati e la sua logica lato server. Per questo la finestra ti dà un export prompt. Chiede all’IA di quel builder di aggiungere un file, SETHERION_EXPORT.md, che descrive le pagine dell’app, i suoi dati, la sua logica lato server e i suoi account, con qualche record di esempio inventato per ogni tabella. Gli viene detto di non scriverci mai chiavi o password.

Copia l’export prompt

Premi Copy export prompt, oppure Show it per leggerlo prima.

Incollalo nella chat del builder

Aggiunge il file al progetto.

Estrai il codice

Lovable: collega il progetto a GitHub da Lovable, oppure scaricalo come ZIP. Bolt: scarica lo ZIP, oppure fai il push su GitHub. v0: scarica lo ZIP, oppure usa il repository da cui il tuo progetto Vercel pubblica. Base44: se il tuo piano Base44 include l’esportazione del codice, mandalo su GitHub o scaricalo come ZIP.

Importalo qui

Setherion legge prima SETHERION_EXPORT.md. Se il file non c’è, la finestra lo dice e l’app viene ricostruita solo dal codice.

Cosa viene letto

Setherion legge i file di testo del progetto: codice, stili, HTML, SQL, Markdown e simili. I file segreti, i pacchetti installati, le cartelle di build, i test, i lock file, le immagini e i font non vengono letti. Qualsiasi chiave che compaia comunque nel codice viene cancellata prima che un modello legga qualcosa.

Un progetto molto grande viene letto partendo dai file più significativi, come le pagine e i dati, e la finestra dice quanti file verranno letti e quanti sono stati lasciati fuori per fare spazio.

Funziona qualsiasi app web: React, Next.js, Vue o semplice HTML.

Cosa viene ricostruito, e cosa no

È una ricostruzione, non una copia del codice. Un modello legge il progetto e scrive una descrizione semplice di ciò che fa, e l’app viene poi creata da quella descrizione. Il codice in sé non viene mai copiato.

Le funzioni lato server e i pagamenti vengono descritti e ricostruiti alla maniera di Setherion, e dopo possono richiedere qualche modifica. Gli account vengono ricostruiti come accesso sul backend di Setherion, non trasferiti. Le immagini archiviate nel progetto vengono sostituite da foto corrispondenti che puoi cambiare.

Se i dati stavano in Supabase, Base44, Firebase o Prisma, la loro struttura si trasferisce ma non i record che contengono. Per portare dentro i record, vedi l’importazione da foglio di calcolo qui sotto.

Quanto costa

Un’importazione costa come una nuova app più la lettura del codice, cioè circa il 40% in più del prezzo della nuova app. La finestra mostra il prezzo sul pulsante prima che tu lo prema, e non spende nulla finché non lo fai. Una nuova app viene creata nella modalità Seth standard qualunque cosa tu abbia scelto nel menu Build.

La tua prima importazione è gratuita. Una volta per account, la creazione la offriamo noi, quindi non paghi nulla. Se hai scelto un modello più caro di quello che il tuo piano usa per impostazione predefinita, paghi la differenza quando parte la creazione. Se la prima importazione fallisce, ce l’hai ancora.

Se la lettura fallisce in un’importazione a pagamento, i crediti spesi ti vengono restituiti. Se non hai crediti a sufficienza, il pulsante lo dice e non viene addebitato nulla. Vedi Piani e crediti.

Importare da Figma

Figma non è un’importazione di app. Dà al builder un frame di cui copiare l’aspetto, per una nuova app o per una modifica a una che hai già. Si trova nel menu +: Import from Figma nella dashboard (dentro Import a design dove è offerto anche Canva), e Design poi Import from Figma nell’editor.

Importare il frame non costa crediti. La creazione o la modifica che lo usa viene addebitata come al solito.

Cosa richiede Figma

• Un posto Editor in Figma. Figma blocca la sua API per gli account View e Collaborator, quindi un file che puoi leggere nel tuo browser può comunque essere rifiutato qui.
• Un file Design. Le lavagne FigJam e le Slides non si possono importare.
• Un file che l’account collegato può aprire. Uno nel team di qualcun altro, o aperto da Community senza duplicarlo nelle tue bozze, non si aprirà.

La finestra apre da sola questo elenco quando un’importazione fallisce.

Importare da Canva

I design di Canva arrivano come immagini, non come un layout da ricostruire. Apri il design in Canva, copia l’indirizzo dal browser (contiene /design/) e incollalo in Import from Canva. Le sue prime tre pagine arrivano nel campo di testo come immagini, pronte da inserire nell’app. Il design deve essere tuo o condiviso con te, e un indirizzo breve canva.link viene rifiutato: usa quello lungo. La prima volta ti verrà chiesto di Connect to Canva, e in Canva non viene modificato nulla.

Importare non costa crediti. La creazione che usa le immagini viene addebitata come al solito.

Da un foglio di calcolo

Ci sono due importazioni da foglio di calcolo, per due scopi diversi.

Una nuova app costruita attorno a un foglio di calcolo

In Import an app, scegli Spreadsheet e dagli un file Excel (.xlsx) o CSV. Salva prima un Google Sheet con File, poi Download. I vecchi file .xls, .ods e .numbers vanno salvati come .xlsx o .csv. Un file sopra i 30 MB viene rifiutato.

Il file viene letto nel tuo browser. Poi vedi le sue colonne, ognuna con il tipo di cosa che contiene, come testo, numero, data, e-mail o immagine, e le prime cinque righe. Deseleziona le colonne che l’app non deve avere, di’ a cosa serve l’app se vuoi, e premi Build the app. Leggere il foglio di calcolo non costa nulla; il pulsante mostra il prezzo di una nuova app.

Ottieni un’app attorno alle tue righe: ricerca, una pagina per ogni riga e un modulo per aggiungere e modificare. Le tue righe vengono copiate esattamente come sono, dopo che il codice è stato creato, così la primissima anteprima mostra i tuoi dati e nessuna IA li riscrive. L’IA stessa vede solo i nomi delle colonne e le prime cinque righe.

Vengono copiate fino a 300 righe. Se il tuo file ne ha di più, la finestra dice con quante parte l’app, e le altre si possono aggiungere dopo la creazione con Import a catalogue, qui sotto.

Se una colonna sembra un dato personale, come un’e-mail, un numero di telefono o uno stipendio, la finestra ti avverte che chiunque apra l’app pubblicata può leggerlo. Deselezionala se all’app non serve.

Una cartella di lavoro con più fogli chiede quale usare; un foglio diventa un elenco. I colori delle celle e la formattazione non si trasferiscono, mentre i valori delle formule sì.

Righe aggiunte a un’app che hai già (Import a catalogue)

Apri l’app, poi Manage, poi Database, e scegli Import a catalogue. Dagli un file CSV o Excel (.xlsx), da Excel, Sheets o Shopify. Viene letto nel tuo browser e mai caricato, quindi le sue dimensioni non contano, e non costa nulla.

L’app ha bisogno di un elenco in cui inserire le righe, come un elenco di prodotti. Se non ne ha, chiedilo prima nella chat. Setherion abbina le tue colonne ai campi dell’elenco in base al nome, e puoi cambiare ogni abbinamento. I file Shopify con le varianti vengono ridotti a una riga per prodotto.

Poi scegli dove vanno le righe.

• In the app è istantaneo. Va bene fino a circa mille righe; oltre, il sito si carica lentamente e smette di salvare, quindi un’importazione che renderebbe l’app troppo pesante viene rifiutata.
• In the database richiede un attimo per il caricamento e gestisce un catalogo completo. L’app lo legge una pagina alla volta. È la scelta proposta per impostazione predefinita per un file di più di 800 righe. È anche l’unica scelta quando l’elenco legge già dal database.

Il database del piano Free contiene fino a 10.000 righe per app. I piani a pagamento ne contengono fino a 500.000. Vedi Cloud.

Se un’importazione fallisce

La finestra ne spiega il motivo, in parole semplici. I casi in cui è più probabile imbattersi:

• “We could not find owner/name.” Per un repository privato, premi prima Connect GitHub. Se sei collegato, l’account collegato potrebbe non poterlo leggere.
• Il repository o lo ZIP è troppo grande. Lascia fuori le immagini e i video dallo ZIP.
• “There is no code in this ZIP that we can read.” I file all’interno non sono codice di testo, oppure stanno tutti in cartelle che non vengono mai lette, come node_modules.
• Il frame di Figma viene rifiutato. Apri “What Figma requires” nella finestra. Un frame che viene disegnato troppo grande funziona meglio come una sola schermata che come una pagina intera.
• “This import costs N credits and you have M.” Compra crediti o aspetta la tua quota mensile. Vedi Piani e crediti.