React Newsletter Signup Form

A beautiful email signup form for React. Integrates with Mailchimp, ConvertKit, or any email service via webhooks. Includes validation and success animations.

Installation

npm install @formflow.sh/react

Basic Usage

import { NewsletterForm } from '@formflow.sh/react';

function Newsletter() {
  return (
    <NewsletterForm
      apiKey="ff_live_xxx"
      onSuccess={() => console.log('Subscribed!')}
    />
  );
}

With Name Field

<NewsletterForm
  apiKey="ff_live_xxx"
  showNameField={true}
  buttonText="Join the list"
/>

Props

PropTypeDefaultDescription
apiKeystring-Your FormFlow API key
showNameFieldbooleanfalseShow optional name field
buttonTextstring"Subscribe"Submit button label
placeholderstring"Enter your email"Email input placeholder
theme"minimal" | "modern" | "brutalist" | "glass""minimal"Visual theme
onSuccess(data) => void-Called after successful subscription

Mailchimp Integration

Connect your Mailchimp account in the FormFlow dashboard to automatically add subscribers to your list:

  1. Go to Dashboard → Settings
  2. Add your Mailchimp API key and list ID
  3. New subscribers are automatically added to your Mailchimp audience

No code changes needed! Once connected, all newsletter submissions are automatically synced to Mailchimp.

Inline Layout

<NewsletterForm
  apiKey="ff_live_xxx"
  layout="inline"
  className="max-w-md"
/>

Custom Webhook

Send subscribers to ConvertKit, Buttondown, or any other service using webhooks. Configure in your dashboard under Form Settings → Webhooks.

Features

  • Email validation - Client and server-side
  • Duplicate detection - Prevents duplicate signups
  • Mailchimp sync - Automatic subscriber sync
  • Webhook support - Connect any email service
  • Success animation - Satisfying confirmation

Related

React Newsletter Form Component - FormFlow | FormFlow