Skip to content

Forms

The Forms module replaces tools like Formspree and Basin for form handling.

Planned Features

No-code forms - Accept submissions with just an endpoint
Webhooks - Forward submissions to your backend
Email notifications - Get notified of new submissions
Spam protection - Built-in honeypot and rate limiting
File uploads - Accept file attachments

Quick Start (Preview)

# Create a form
soup forms create contact-form \
  --webhook https://api.myapp.com/contact \
  --email notify@myapp.com

# Get the form endpoint
soup forms info contact-form
# Endpoint: https://getsoup.dev/f/abc123

HTML Usage (Preview)

<form action="https://getsoup.dev/f/abc123" method="POST">
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <textarea name="message" required></textarea>

  <!-- Honeypot for spam -->
  <input type="text" name="_honey" style="display:none">

  <button type="submit">Send</button>
</form>

Webhook Payload (Preview)

{
  "form_id": "abc123",
  "submission_id": "sub_xyz789",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello!"
  },
  "metadata": {
    "ip": "192.168.1.1",
    "user_agent": "Mozilla/5.0...",
    "submitted_at": "2024-01-15T10:30:00Z"
  }
}

Pricing (Planned)

Tier	Limits
Free	3 forms, 100 submissions/month
Standard	Unlimited ($1/user/month)
Self-hosted	Unlimited (free)

Interested?

Sign up for early access to be notified when Forms is available.