Costruire la tua prima App

Questa guida ti accompagna nella creazione di un’App a partire da un workflow del Canvas. Alla fine, avrai uno strumento riutilizzabile che chiunque può usare.

Prerequisiti

Prima di creare un’App, ti serve:

• ✅ Un workflow Canvas funzionante
• ✅ Il workflow testato e con buoni risultati
• ✅ Chiarezza su quali input devono essere modificabili

Step 1: Costruisci il workflow

Per prima cosa, crea e testa il tuo workflow nel Canvas.

Workflow di esempio

Costruiamo un semplice generatore di foto prodotto:

[Upload Node] → [BG Remover] → [Image Node (Flux Kontext)] → [Upscaler]
                                        ↑
                              [Text Node: "on marble surface, studio lighting"]

Testalo

1. Esegui il workflow con input di esempio
2. Verifica la qualità dell’output
3. Regola le impostazioni finché sei soddisfatto
4. Salva il Canvas

Step 2: Apri l’App Builder

Come accedere

1. Apri il tuo workflow nel Canvas
2. Cerca il pulsante App Builder nella toolbar (o nella sidebar)
3. Cliccalo per aprire il pannello App Builder

Il pannello App Builder

Vedrai:

• Elenco App — App esistenti per questo Canvas
• Create New — Pulsante per creare una nuova App
• Settings — Opzioni di configurazione

Step 3: Dai un nome alla tua App

Nome App

Scegli un nome chiaro e descrittivo:

✅ Nomi buoni:

• “Product Photo Generator”
• “Social Media Post Creator”
• “Video Ad Maker”

❌ Da evitare:

• “My App”
• “Test”
• “Workflow 1”

Descrizione

Scrivi una breve descrizione di cosa fa l’App:

Generate professional product photos with custom backgrounds. 
Upload your product image, describe the desired background, 
and get a polished, high-resolution result.

Step 4: Configura gli input

Questo è lo step più importante. Stai scegliendo quali parti del workflow gli utenti possono cambiare.

Trovare gli input disponibili

L’App Builder mostra tutti i nodi che possono ricevere input:

• Nodi di testo (per prompt)
• Nodi di upload (per file)
• Impostazioni che possono essere modificate

Selezionare gli input da esporre

Per ogni input che vuoi esporre:

1. Attivalo — Lo rende visibile agli utenti dell’App
2. Imposta l’etichetta — Ciò che gli utenti vedono (es. “Product Photo”)
3. Imposta il tipo — Testo, immagine, video o audio
4. Segnalo come obbligatorio — Se gli utenti devono inserirlo

Configurazione di esempio

Per il nostro workflow foto prodotto:

Etichette degli input

Scrivi etichette chiare e “user-friendly”:

✅ Buone etichette:

• “Product Photo”
• “Background Description”
• “Brand Name”

❌ Da evitare:

• “input_1”
• “Text for node 3”
• “Upload here”

Step 5: Aggiungi una thumbnail

Una thumbnail aiuta gli utenti a identificare la tua App.

Opzioni

1. Carica un’immagine — La tua thumbnail
2. Usa un output del workflow — Un risultato generato
3. Seleziona dagli asset — Dalla tua Gallery

Best practice

• Usa un risultato del tuo workflow
• Mostra cosa produce l’App
• Mantienila chiara visivamente
• Formato quadrato o 4:3 funziona meglio

Step 6: Rivedi e salva

Prima di salvare

Controlla che:

• ✅ Il nome sia chiaro e descrittivo
• ✅ La descrizione spieghi cosa fa l’App
• ✅ Tutti gli input necessari siano esposti
• ✅ Le etichette siano “user-friendly”
• ✅ I campi obbligatori siano segnati correttamente
• ✅ La thumbnail rappresenti bene l’App

Salva l’App

Clicca Save o Create App.

La tua App è ora pronta all’uso!

Step 7: Testa la tua App

Esegui un test

1. Vai alla sezione Apps
2. Trova la tua nuova App
3. Compila gli input
4. Clicca Generate
5. Verifica l’output

Verifica l’esperienza

Chiediti:

• È chiaro cosa inserire?
• L’output corrisponde alle aspettative?
• Ci sono elementi confusi?

Modificare la tua App

Accedere alla modalità di modifica

1. Vai alla sezione Apps
2. Trova la tua App
3. Clicca il pulsante Edit o Settings

Cosa puoi cambiare

• Nome e descrizione dell’App
• Quali input sono esposti
• Etichette e obbligatorietà degli input
• Thumbnail

Cosa non puoi cambiare

• Il workflow sottostante (si modifica nel Canvas)
• La configurazione dei nodi (si modifica nel Canvas)

Aggiornare il workflow

Se devi cambiare il workflow:

1. Apri il Canvas originale
2. Fai le modifiche
3. Riapri l’App Builder
4. Aggiorna la configurazione dell’App se necessario

Best practice

Mantienila semplice

• Esponi solo gli input essenziali
• Non sovraccaricare gli utenti con opzioni
• Nascondi la complessità dietro le quinte

Scrivi etichette chiare

• Usa linguaggio semplice
• Descrivi cosa serve
• Includi esempi se utili

Testa a fondo

• Esegui l’App più volte
• Prova input diversi
• Verifica la qualità dell’output

Pensa agli utenti

• Chi userà questa App?
• Cosa deve sapere?
• Cosa potrebbe confondere?

Errori comuni

❌ Esporre troppi input

Problema: Gli utenti sono sopraffatti dalle opzioni.

Soluzione: Esponi solo ciò che è davvero necessario. Tieni nascoste le impostazioni avanzate.

❌ Etichette poco chiare

Problema: Gli utenti non sanno cosa inserire.

Soluzione: Scrivi etichette descrittive e aggiungi descrizioni utili.

❌ Non testare

Problema: L’App non funziona come previsto.

Soluzione: Testa sempre con input vari prima di condividerla.

❌ Dimenticare i campi obbligatori

Problema: Gli utenti inviano input incompleti.

Soluzione: Segna gli input essenziali come obbligatori.

Esempio: Setup completo di un’App

Product Photo Generator

Name: Product Photo Generator

Description: Create professional product photos with custom backgrounds. Upload your product image and describe your ideal setting.

Inputs:

Thumbnail: Esempio di output che mostra un prodotto su marmo

Prossimi passi

• Eseguire le App — Impara a usare le tue App
• Idee di App per creativi — Trova ispirazione
• Workflow multi-step — Crea App più complesse