gatecrash-forms

具有 BYOK 理念的 CLI 优先表单生成器。从 JSON 模式生成漂亮的 HTML 表单，通过您自己的 SMTP 服务器处理提交，在本地存储响应。基米爪本地人。我们撞毁大门，我们不会建造新的大门。

## 概述（中文）

具有 BYOK 理念的 CLI 优先表单生成器。从 JSON 模式生成漂亮的 HTML 表单，通过您自己的 SMTP 服务器处理提交，在本地存储响应。基米爪本地人。我们撞毁大门，我们不会建造新的大门。

## 原文

# 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

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

### Start Server

```bash
./scripts/serve.sh 3000
```

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

### Initialize Project

```bash
./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:

```bash
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

```json
{
  "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

```bash
# 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."**