Príklady

Verejný repozitár SDK frontmail-dev/frontmail-js obsahuje v adresári examples/ spustiteľný príklad pre každé SDK. Každý z nich je kontaktný formulár s chybami validácie, stavom pozdržanej správy a Turnstile – rovnaký postup ako v návode Kontaktný formulár s automatickou odpoveďou.

Príklad	Technológie	Ukazuje
examples/vanilla	Čisté HTML + @frontmail/browser (CDN)	sendForm, Turnstile, prílohu súboru, polling cez getStatus
examples/react	Vite + React + @frontmail/react	FrontmailProvider, FrontmailForm, useSendEmail, typované parametre
examples/react-native	Expo + React Native + @frontmail/react-native	FrontmailProvider, useSendEmail, TurnstileWebView, limitRate s 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, idempotency keys

Spustenie príkladu

git clone https://github.com/frontmail-dev/frontmail-js.git
cd frontmail-js
corepack enable                 # pnpm 10
pnpm install
pnpm build                      # zostaví SDK, na ktoré príklady odkazujú
echo "VITE_FRONTMAIL_PUBLIC_KEY=pk_…" > examples/react/.env.local   # + ID služby a ID šablóny
pnpm --filter @frontmail/example-react dev

README každého príkladu uvádza parametre šablóny, ktoré očakáva. Zodpovedajúcu šablónu získate najrýchlejšie ako Kontaktný formulár z galérie.

Natívne aplikácie: Android (Kotlin), iOS (Swift) a Flutter

Natívne SDK majú vlastné verejné repozitáre a zatiaľ nemajú ukážkový projekt. Stránka každého SDK prevedie rovnakým postupom kontaktného formulára krok za krokom – inštalácia, odoslanie, stav pozdržania, stav doručenia a Turnstile vo WebView – s kódom, ktorý môžete vložiť do svojej aplikácie:

SDK	Repozitár	Ukazuje
Android (Kotlin) – dev.frontmail:frontmail	frontmail-dev/frontmail-kotlin	send z viewModelScope, AcceptedStatus.HELD, getStatus, Turnstile vo WebView
iOS a platformy Apple (Swift) – balík Frontmail	frontmail-dev/frontmail-swift	async/await send, .held, stav doručenia, Turnstile vo WKWebView (SwiftUI + UIKit)
Flutter a Dart – frontmail na pub.dev	frontmail-dev/frontmail-flutter	send, DeliveryStatus.held, stav doručenia, Turnstile vo webview_flutter (kompletný widget s formulárom)

Všetky vyžadujú zapnuté Povoliť mobilné aplikácie a prijímajú len verejný kľúč. Multiplatformové aplikácie môžu použiť @frontmail/react-native a projekt examples/react-native vyššie.

Ukážky kódu z dashboardu

Každá šablóna v dashboarde má kartu Kód, ktorá generuje kód pripravený na vloženie pre čistý JS, React, Vue, Svelte, Node a cURL, s vašimi ID a všetkými parametrami šablóny (vrátane typov a vzorových hodnôt) už vyplnenými.

Poznámky k frameworkom

• Next.js / Nuxt / SvelteKit: posielajte z klientskych komponentov s verejným kľúčom alebo zo server actions / API routes so súkromným kľúčom a @frontmail/node.
• Generátory statických webov (Astro, Hugo, Eleventy, Jekyll): použite build z CDN a sendForm.
• WordPress a no-code nástroje: vložte ukážku kódu z CDN do vlastného HTML bloku.
• Mobilné aplikácie: použite natívne SDK pre Android (Kotlin), iOS (Swift), Flutter alebo @frontmail/react-native s verejným kľúčom a zapnite Povoliť mobilné aplikácie, alebo volajte REST API zo svojho backendu so súkromným kľúčom. Súkromný kľúč nikdy nedávajte do aplikácie.