Esempi

Il repository pubblico degli SDK frontmail-dev/frontmail-js contiene un esempio eseguibile per ogni SDK nella cartella examples/. Ognuno è un modulo di contatto con errori di validazione, lo stato dei messaggi in attesa e Turnstile – lo stesso flusso del tutorial sul modulo di contatto.

Esempio	Stack	Mostra
`examples/vanilla`	HTML semplice + `@frontmail/browser` (CDN)	`sendForm`, Turnstile, allegato, polling con `getStatus`
`examples/react`	Vite + React + `@frontmail/react`	`FrontmailProvider`, `FrontmailForm`, `useSendEmail`, parametri tipizzati
`examples/react-native`	Expo + React Native + `@frontmail/react-native`	`FrontmailProvider`, `useSendEmail`, `TurnstileWebView`, `limitRate` con AsyncStorage
`examples/vue`	Vite + Vue 3 + `@frontmail/vue`	plugin, `<FrontmailForm>`, `useSendEmail`
`examples/svelte`	Vite + Svelte 5 + `@frontmail/svelte`	`createFrontmail`, `use:frontmailForm`
`examples/node`	Node.js + `@frontmail/node`	`send`, `sendBatch`, `history`, chiavi di idempotenza

Eseguire un esempio

git clone https://github.com/frontmail-dev/frontmail-js.git
cd frontmail-js
corepack enable                 # pnpm 10
pnpm install
pnpm build                      # compila gli SDK a cui rimandano gli esempi
echo "VITE_FRONTMAIL_PUBLIC_KEY=pk_…" > examples/react/.env.local   # + ID servizio e ID modello
pnpm --filter @frontmail/example-react dev

Il README di ogni esempio elenca i parametri del modello che si aspetta. Il modo più rapido per avere un modello adatto è il Modulo di contatto della galleria.

App native: Android (Kotlin), iOS (Swift) e Flutter

Gli SDK nativi hanno i propri repository pubblici e non hanno ancora un progetto di esempio. Ogni pagina dell’SDK percorre passo dopo passo lo stesso flusso del modulo di contatto – installazione, invio, stato di attesa, stato di consegna e Turnstile in una WebView – con codice da incollare nella tua app:

SDK	Repository	Mostra
Android (Kotlin) – `dev.frontmail:frontmail`	`frontmail-dev/frontmail-kotlin`	`send` da `viewModelScope`, `AcceptedStatus.HELD`, `getStatus`, Turnstile in una `WebView`
iOS e piattaforme Apple (Swift) – pacchetto `Frontmail`	`frontmail-dev/frontmail-swift`	`send` con `async`/`await`, `.held`, stato di consegna, Turnstile in una `WKWebView` (SwiftUI + UIKit)
Flutter e Dart – `frontmail` su pub.dev	`frontmail-dev/frontmail-flutter`	`send`, `DeliveryStatus.held`, stato di consegna, Turnstile in `webview_flutter` (un widget di modulo completo)

Tutti richiedono l’attivazione di Consenti app mobile e accettano solo la chiave pubblica. Le app multipiattaforma possono usare @frontmail/react-native e il progetto examples/react-native qui sopra.

Snippet dalla dashboard

Ogni pagina di un modello nella dashboard ha una scheda Snippet che genera codice pronto da incollare per JavaScript puro, React, Vue, Svelte, Node e cURL, con i tuoi ID e tutti i parametri del modello (compresi tipi e valori di esempio) già compilati.

Note sui framework

Next.js / Nuxt / SvelteKit: invia dai componenti client con la chiave pubblica, oppure dalle server action / API route con la chiave privata e @frontmail/node.
Generatori di siti statici (Astro, Hugo, Eleventy, Jekyll): usa la build dalla CDN e sendForm.
WordPress e builder no-code: incolla lo snippet della CDN in un blocco HTML personalizzato.
App mobile: usa gli SDK nativi per Android (Kotlin), iOS (Swift) e Flutter, oppure @frontmail/react-native, con la chiave pubblica e attiva Consenti app mobile, oppure chiama l’API REST dal tuo backend con una chiave privata. Non mettere mai una chiave privata in un’app.