🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

GateCrash Forms

by @phoenix2479

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

Versionv0.2.0
Downloads1,213
TERMINAL
clawhub install gatecrash-forms

πŸ“– About This Skill


name: gatecrash-forms description: CLI-first form builder with BYOK philosophy. Generate beautiful HTML forms from JSON schemas, handle submissions via your own SMTP server, store responses locally. Kimi Claw native. We crash gates, we don't build new ones. metadata: { "openclaw": { "emoji": "πŸš€", "requires": { "bins": ["gatecrash-forms", "node"] }, "install": [ { "id": "npm-global", "kind": "node", "package": "gatecrash-forms", "bins": ["gatecrash-forms"], "label": "Install GateCrash Forms globally (npm)", }, ], }, }

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 your-email@example.com
    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": "your-email@example.com",
        "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

    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."

    ⚑ When to Use

    TriggerAction
    - **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

    πŸ’‘ Examples

    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.

    βš™οΈ 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 your-email@example.com
    gatecrash-forms config smtp.auth.pass your-password
    

    Or configure per-form in the JSON schema.