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.

Come incorporare un flipbook in un’app Lovable o Bolt
Cristian Da Conceicao
Fondatore di Flipbooks AI

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.

Sviluppatore alla scrivania con un’app web e un visualizzatore di pagine sullo schermo

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.

FunzioneLovableBolt
Stack generatoReact, Vite, Tailwind, SupabaseReact o altri framework, Vite, Tailwind
Modo migliore per aggiungere l’incorporamentoPrompt in chat o modifica nella vista del codicePrompt in chat o modifica nell’albero dei file
Anteprima in tempo realePannello di anteprima integratoAnteprima WebContainer
Supporto iframeSupporto completoSupporto completo
Destinazione di pubblicazioneHosting di Lovable o dominio personalizzatoNetlify e altri
Serve un passaggio di buildNessun passaggio manualeNessun passaggio manuale

Tablet con un visualizzatore di pagine in stile rivista e una mano che gira la pagina

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.

Vista dall’alto di un depliant stampato, uno smartphone e un tablet su una scrivania di legno

Carica e converti il PDF

  1. Vai su Flipbooks AI e crea un account.
  2. Clicca per creare un nuovo flipbook e carica il tuo PDF.
  3. Attendi la conversione. Le pagine diventano immagini ad alta risoluzione con un effetto sfoglio di pagina fluido.
  4. 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:

<iframe
  src="https://flipbooksai.com/embed/YOUR-FLIPBOOK-ID"
  width="100%"
  height="600"
  allowfullscreen
  style="border: none;"
></iframe>

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.

Uomo con felpa grigia che controlla un sito web su un monitor widescreen

Converti HTML in JSX

React non accetta ogni attributo HTML così com’è. Se incolli il frammento a mano in un componente, cambia questi:

Versione HTMLVersione React (JSX)
allowfullscreenallowFullScreen
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:

type FlipbookEmbedProps = {
  id: string;
  title: string;
};

export default function FlipbookEmbed({ id, title }: FlipbookEmbedProps) {
  return (
    <div className="w-full overflow-hidden rounded-xl shadow-lg">
      <div className="relative w-full" style={{ paddingTop: "62.5%" }}>
        <iframe
          src={`https://flipbooksai.com/embed/${id}`}
          title={title}
          loading="lazy"
          allowFullScreen
          className="absolute inset-0 h-full w-full"
          style={{ border: "none" }}
        />
      </div>
    </div>
  );
}

Poi usalo dove vuoi:

<FlipbookEmbed id="YOUR-FLIPBOOK-ID" title="Spring product catalog" />

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.

Due colleghi che collaborano a una scrivania in piedi e guardano un laptop

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:

const documents = [
  { id: "abc123", title: "Product catalog" },
  { id: "def456", title: "Annual report" },
  { id: "ghi789", title: "Onboarding manual" },
];

export default function Library() {
  return (
    <div className="grid gap-8 md:grid-cols-2">
      {documents.map((doc) => (
        <FlipbookEmbed key={doc.id} id={doc.id} title={doc.title} />
      ))}
    </div>
  );
}

💡 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.

ProblemaCausa probabileSoluzione
Riquadro vuotoID del flipbook sbagliato o link privatoRicontrolla l’ID e le impostazioni di condivisione
Riquadro troppo bassoAltezza fissa in pixelUsa il contenitore con rapporto d’aspetto
Nessun pulsante schermo interoAttributo mancanteAggiungi allowFullScreen
Avviso nella console di ReactAttributi HTML nel JSXConverti in prop camelCase
La pagina salta durante il caricamentoNessuno spazio riservatoRacchiudi in un contenitore con rapporto
Bloccato dal browserContenuto misto (http e https)Usa sempre l’URL https

Smartphone in mano che mostra una pagina mobile con un visualizzatore in stile libro

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.

Titolare di una boutique che tiene in mano un tablet con un catalogo digitale

Scegliere il tipo di documento giusto

Caso d’usoNumero di pagine consigliatoStrumento suggerito
Catalogo prodottiDa 20 a 80Catalogo prodotti
Presentazione commercialeDa 10 a 25Presentazione commerciale
Report annualeDa 30 a 100Creatore di relazioni annuali interattive
Manuale di formazioneDa 15 a 60Flipbook per manuali di formazione
Portfolio digitaleDa 10 a 40Creatore di portfolio digitali

Funzioni da attivare

Una volta che l’incorporamento funziona, alcune funzioni della piattaforma lo rendono più utile dentro un’app.

Laptop su una scrivania minimalista al crepuscolo con una lista di controllo accanto

  • ✅ 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

  1. L’anteprima del flipbook è nitida su computer desktop e telefono.
  2. L’incorporamento usa l’URL https.
  3. L’iframe ha un title descrittivo per l’accessibilità.
  4. Il contenitore usa un rapporto adattivo, non un’altezza fissa in pixel.
  5. Le impostazioni di password e privacy corrispondono al pubblico.
  6. 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.

Pronto a crearne uno? Inizia gratis su Flipbooks AI, sfoglia tutti gli strumenti per flipbook per trovare il modello giusto e confronta i piani tariffari quando vuoi statistiche e raccolta di contatti. Quando sei pronto a pubblicare, scegli il tuo piano e vai online.

Condividi questo articolo

Scegli la tua lingua