GateCrash Forms

CLI-first form builder with BYOK philosophy. Generate beautiful HTML forms from JSON schemas, handle submissions via your own SMTP server, store responses lo...

GateCrash Forms Skill

CLI-first form builder with BYOK (Bring Your Own Keys) philosophy

Generate beautiful, secure HTML forms from JSON schemas. Email notifications via YOUR SMTP server, response storage on YOUR infrastructure. No external services, no gatekeeping.

✨ Kimi Claw Ready

Perfect for Kimi's 24/7 cloud agents:

• ✅ Works natively in Kimi.com browser tabs
• ✅ Installed via ClawHub's 5,000+ skill library
• ✅ 40GB cloud storage for form responses
• ✅ Agent-friendly email providers (agentmail.to, Resend)

Your AI assistant can now generate and manage forms for you!

Quick Start

Generate a Form

./scripts/generate.sh examples/feedback.json output.html

Start Server

./scripts/serve.sh 3000

Visits http://localhost:3000 to see all forms.

Initialize Project

./scripts/init.sh

Creates forms/ and responses/ directories with example forms.

Features

• 🎨 8+ Field Types: text, email, textarea, select, radio, checkbox, scale/rating, date
• 🔒 Security Hardened: XSS prevention, CSRF tokens, honeypot spam protection, rate limiting
• 📧 BYOK Email: Use your own SMTP server (Zoho, Gmail, SendGrid, etc.)
• 💾 Local Storage: Responses saved as JSON or CSV
• 🎨 Beautiful UI: Gradient purple theme, responsive design
• 🚀 Self-Hosted: Deploy anywhere Node.js runs

Configuration

Set up your SMTP credentials globally:

gatecrash-forms config smtp.host smtp.example.com
gatecrash-forms config smtp.port 465
gatecrash-forms config smtp.secure true
gatecrash-forms config smtp.auth.user [e-mail]
gatecrash-forms config smtp.auth.pass your-password

Or configure per-form in the JSON schema.

Example Form Schema

{
  "title": "Customer Feedback",
  "description": "We'd love to hear from you!",
  "fields": [
    {
      "type": "scale",
      "name": "rating",
      "label": "Overall satisfaction",
      "min": 1,
      "max": 5,
      "required": true
    },
    {
      "type": "checkbox",
      "name": "topics",
      "label": "What interested you most?",
      "options": ["Product", "Service", "Price", "Experience"]
    },
    {
      "type": "textarea",
      "name": "comments",
      "label": "Additional comments",
      "maxLength": 500
    }
  ],
  "submit": {
    "email": "[e-mail]",
    "storage": "responses/feedback.json"
  }
}

Use Cases

• Customer Feedback: Collect product/service feedback
• Contact Forms: Simple contact forms for websites
• Event Registration: Sign up forms for workshops/events
• Surveys: Market research, user surveys
• Lead Generation: Capture leads without third-party services

Philosophy: We Crash Gates

GateCrash Forms is NOT a service. It's a toolmaker.

• ✅ Your SMTP server (email notifications)
• ✅ Your storage (form responses)
• ✅ Your deployment (host anywhere)
• ✅ Your data (no external servers)

No GateCrash accounts. No GateCrash servers. No gatekeeping.

Links

• GitHub: https://github.com/Phoenix2479/gatecrash-forms
• npm: https://www.npmjs.com/package/gatecrash-forms
• Manifesto: Read MANIFESTO.md in the project
• Documentation: Full docs in README.md

Commands Reference

# Generate form from schema
gatecrash-forms generate schema.json output.html

# Start HTTP server
gatecrash-forms serve [port]

# Set global config
gatecrash-forms config <key> <value>

# Initialize project
gatecrash-forms init

# Show help
gatecrash-forms help

License

MIT - Use it, fork it, sell it. Just don't gatekeep it.

---

Made with 🔥 by Dinki & Molty

"We crash gates. We don't build new ones."