Come incorporare un flipbook in un’app Lovable o Bolt
Hai creato un’app con Lovable o Bolt e ti serve un depliant, un catalogo o un report che i lettori possano davvero sfogliare? Questo tutorial mostra i prompt esatti, il componente React e le impostazioni dell’iframe per incorporare un flipbook senza rovinare il layout o la vista da telefono.
In un pomeriggio hai creato un’app funzionante con i prompt, e ora devi mostrare dentro un depliant, un catalogo prodotti o un report di 60 pagine. Un semplice link a un PDF sembra goffo, e un visualizzatore PDF grezzo sembra vecchio. La soluzione più pulita è un flipbook con sfoglio di pagina, e il modo più rapido per crearlo è con Flipbooks AI. Poi lo inserisci nel tuo progetto Lovable o Bolt con poche righe di codice o un solo prompt in chat.
Questo tutorial ti guida lungo l’intero processo: convertire il PDF, copiare il codice di incorporamento, chiedere a Lovable o Bolt di posizionarlo e risolvere i soliti problemi con gli iframe. Ogni frammento di codice è pronto all’uso.
Perché i flipbook si adattano alle app create con l’AI
Gli strumenti che creano app con l’AI generano componenti React in fretta, ma non generano visualizzatori di documenti rifiniti. Se chiedi "un visualizzatore PDF", spesso ottieni un semplice tag <embed> che si rompe sui dispositivi mobili, nasconde la navigazione tra le pagine e non offre statistiche di lettura.
Un flipbook risolve tre problemi insieme:
Leggibilità: le pagine si sfogliano come una vera pubblicazione, con zoom, miniature e modalità a schermo intero.
Velocità: il contenuto si carica da un visualizzatore ospitato, quindi il bundle della tua app resta leggero.
Controllo: aggiorni il PDF una sola volta e ogni copia incorporata si aggiorna, senza un nuovo rilascio.
Dove funziona meglio
Chi crea app con questi strumenti ha spesso bisogno di documenti in alcuni punti precisi:
Una presentazione di prezzi o di vendita su una pagina di destinazione
Un catalogo prodotti scaricabile dentro la dashboard di uno store
Un portale clienti che mostra i report mensili
Una pagina di documentazione o di onboarding con un manuale
💡 Suggerimento pro: Se il documento cambia spesso, come un listino prezzi, un flipbook ospitato batte un PDF inserito nel repository. Eviti il commit, la build e il problema della cache.
Lovable o Bolt per gli incorporamenti
Entrambi gli strumenti producono progetti React e Vite, quindi il metodo di incorporamento è quasi identico. Le differenze stanno nel modo in cui dai istruzioni all’AI e in dove modifichi i file.
Funzione
Lovable
Bolt
Stack generato
React, Vite, Tailwind, Supabase
React o altri framework, Vite, Tailwind
Modo migliore per aggiungere l’incorporamento
Prompt in chat o modifica nella vista del codice
Prompt in chat o modifica nell’albero dei file
Anteprima in tempo reale
Pannello di anteprima integrato
Anteprima WebContainer
Supporto iframe
Supporto completo
Supporto completo
Destinazione di pubblicazione
Hosting di Lovable o dominio personalizzato
Netlify e altri
Serve un passaggio di build
Nessun passaggio manuale
Nessun passaggio manuale
Il punto è questo: non ti serve un plugin speciale per nessuna delle due piattaforme. Uno iframe standard funziona in entrambe.
Passo 1: crea prima il flipbook
Prima di toccare la tua app, crea il flipbook. Ci vogliono circa due minuti, e il Convertitore da PDF a flipbook fa il lavoro più pesante.
Clicca per creare un nuovo flipbook e carica il tuo PDF.
Attendi la conversione. Le pagine diventano immagini ad alta risoluzione con un effetto sfoglio di pagina fluido.
Controlla l’anteprima e verifica che caratteri e immagini siano nitidi.
Personalizza prima di incorporare
Dare lo stile adesso fa risparmiare tempo dopo. Nell’editor puoi regolare:
Identità visiva: aggiungi il tuo logo e scegli colori di sfondo che si abbinino al tema della tua app.
Effetti di pagina: scegli la velocità dell’animazione di sfoglio e l’intensità dell’ombra.
Multimedia: inserisci video o audio nelle pagine dove servono.
Barra degli strumenti: nascondi i pulsanti che non ti servono, così il visualizzatore sembra parte della tua interfaccia.
✅ Buona pratica: Abbina lo sfondo del flipbook allo sfondo della sezione della tua app. Un riquadro grigio fuori posto dentro una pagina bianca è il motivo numero uno per cui gli incorporamenti sembrano incollati.
Scegli le impostazioni di privacy
Decidi chi può vedere il documento. I link pubblici vanno bene per il materiale di marketing. Per i report dei clienti, attiva la protezione con password, così lo può aprire solo chi ha il codice. Ricorda che la password vive nel flipbook, non nella tua app, quindi non devi creare un’autenticazione extra.
Passo 2: copia il codice di incorporamento
Apri il pannello di condivisione del flipbook finito e seleziona l’opzione di incorporamento. Ottieni un frammento iframe simile a questo:
Se vuoi approfondire le opzioni, la pagina dello strumento Incorpora flipbook nel sito web elenca tutti i metodi di condivisione, inclusi i link diretti e i codici QR.
Converti HTML in JSX
React non accetta ogni attributo HTML così com’è. Se incolli il frammento a mano in un componente, cambia questi:
Versione HTML
Versione React (JSX)
allowfullscreen
allowFullScreen
style="border: none;"
style={{ border: "none" }}
frameborder="0"
frameBorder={0}
class="..."
className="..."
Se salti questa conversione, la tua app potrebbe mostrare un avviso nella console o un riquadro vuoto. Se chiedi al generatore di app con l’AI di farlo, lo gestisce al posto tuo.
Passo 3: aggiungilo in Lovable
In Lovable hai due strade: descrivere il risultato in chat, oppure incollare tu il codice.
Il metodo con il prompt
Apri la chat e invia qualcosa del genere:
Add a section titled "Our Catalog" to the home page. Inside it, embed this
iframe responsive at full width with a 16:10 aspect ratio, no border,
rounded corners, allow fullscreen, and lazy loading:
<iframe src="https://flipbooksai.com/embed/YOUR-FLIPBOOK-ID"></iframe>
Lovable di solito crea un nuovo componente e lo importa nella tua pagina. Controlla l’anteprima, poi pubblica.
Il metodo con il componente
Per avere più controllo, crea un componente riutilizzabile. Questa versione accetta l’ID del flipbook come prop, così puoi posizionare più documenti in tutta l’app:
Il trucco del padding mantiene un rapporto 16:10 a qualsiasi larghezza, il che evita che l’iframe si schiacci sugli schermi stretti.
Passo 4: aggiungilo in Bolt
Bolt segue lo stesso schema. Apri la chat e descrivi cosa vuoi, oppure apri l’albero dei file, crea src/components/FlipbookEmbed.tsx e incolla il componente qui sopra.
Un prompt affidabile per Bolt
Create a FlipbookEmbed component that takes an id and title prop and renders
an iframe pointing to https://flipbooksai.com/embed/{id}. Make it responsive
with a 16:10 aspect ratio, rounded corners, lazy loading, and fullscreen
support. Use it on the Resources page.
Bolt collegherà l’import e mostrerà il risultato nell’anteprima. Se l’anteprima mostra un riquadro vuoto, non farti prendere dal panico. Spesso è una stranezza della sandbox di anteprima, quindi apri l’URL pubblicato prima di pensare che il codice sia sbagliato.
Incorporare più flipbook
Per una libreria di risorse, conserva i documenti in un array e scorrilo con map:
💡 Suggerimento pro: Chiedi al generatore di caricare questi ID dalla tabella del database. Quando aggiungi una riga, compare un nuovo flipbook senza modificare il codice.
Risolvere i problemi comuni di incorporamento
Anche un frammento pulito può comportarsi male. Ecco i problemi che i lettori incontrano più spesso e la soluzione più rapida per ciascuno.
Problema
Causa probabile
Soluzione
Riquadro vuoto
ID del flipbook sbagliato o link privato
Ricontrolla l’ID e le impostazioni di condivisione
Riquadro troppo basso
Altezza fissa in pixel
Usa il contenitore con rapporto d’aspetto
Nessun pulsante schermo intero
Attributo mancante
Aggiungi allowFullScreen
Avviso nella console di React
Attributi HTML nel JSX
Converti in prop camelCase
La pagina salta durante il caricamento
Nessuno spazio riservato
Racchiudi in un contenitore con rapporto
Bloccato dal browser
Contenuto misto (http e https)
Usa sempre l’URL https
Consigli per il layout mobile
Più della metà dei visitatori aprirà la tua app da un telefono. Un flipbook è già adattivo di suo, ma il contenitore conta ancora:
Usa width="100%" e mai una larghezza fissa in pixel.
Dai al riquadro almeno 450px di altezza sugli schermi piccoli, oppure passa a un rapporto più alto come 4:5.
Mantieni il padding circostante ridotto, così le pagine restano leggibili.
Prova i gesti tattili su un dispositivo reale, non solo nell’anteprima del computer desktop.
⚠️ Avviso: Non inserire l’iframe in un contenitore con overflow: hidden e un’altezza fissa. Taglia la barra degli strumenti e fa sembrare il documento rotto.
Ottimizzazioni delle prestazioni
Un visualizzatore incorporato è leggero, ma più di uno nella stessa pagina si sommano. Aggiungi loading="lazy" perché i riquadri si carichino solo quando entrano nella vista. Per una pagina con molti documenti, mostra prima una miniatura di copertina e carica l’iframe dopo un clic. Il tuo punteggio Lighthouse ti ringrazierà.
Esempi reali
Ecco come diversi fondatori usano questa configurazione.
Il titolare di una boutique costruisce un negozio online in Lovable e incorpora un lookbook stagionale con il Creatore di lookbook interattivi. Chi acquista sfoglia i look senza lasciare la pagina.
Un fondatore SaaS usa Bolt per pubblicare un portale clienti e incorpora i riepiloghi trimestrali creati con il Creatore di flipbook di report, protetti da password.
Un gruppo di ristoranti aggiunge una pagina con la carta pubblicata e sempre aggiornata creato con il Creatore di flipbook per menù di ristoranti. I prezzi cambiano in un solo punto e l’app si aggiorna subito.
Un fotografo freelance pubblica un portfolio con lo strumento Portfolio fotografico dentro un sito personale creato con Lovable.
Una volta che l’incorporamento funziona, alcune funzioni della piattaforma lo rendono più utile dentro un’app.
✅ Mai filigrane. La tua identità visiva resta in primo piano.
✅ Protezione con password per materiale riservato ai clienti.
✅ Video e audio incorporati nelle pagine per demo più ricche.
✅ Download offline per chi vuole una copia.
✅ Statistiche e generazione di contatti nel piano Professional, così puoi vedere quali pagine catturano l’attenzione e raccogliere email. Confronta i piani tariffari per vedere le differenze tra i livelli.
✅ Flipbook illimitati nel piano Standard e in quelli superiori, utile se la tua app ospita molti documenti.
Una lista di controllo prima del lancio
L’anteprima del flipbook è nitida su computer desktop e telefono.
L’incorporamento usa l’URL https.
L’iframe ha un title descrittivo per l’accessibilità.
Il contenitore usa un rapporto adattivo, non un’altezza fissa in pixel.
Le impostazioni di password e privacy corrispondono al pubblico.
Hai testato il sito pubblicato, non solo l’anteprima del generatore.
Prossimi passi per la tua app
Ora hai tutto ciò che serve: un flipbook convertito, un componente React riutilizzabile e prompt che funzionano in entrambi i generatori. L’intero lavoro richiede meno di quindici minuti, e il risultato sembra molto più professionale di un semplice link di download.