Gatecrash Forms
CLI-first form builder with BYOK philosophy.
- Rating
- 4.4 (17 reviews)
- Downloads
- 1,176 downloads
- Version
- 1.0.0
Overview
CLI-first form builder with BYOK philosophy.
โจKey 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
Complete Documentation
View Source โ
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)
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 [email protected]
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": "[email protected]",
"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)
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."
Installation
openclaw install gatecrash-forms
๐ปCode Examples
./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.auth.pass your-password
Or configure per-form in the JSON schema.
## Example Form Schema}
## 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 Referencegatecrash-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 [email protected]
gatecrash-forms config smtp.auth.pass your-password{
"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": "[email protected]",
"storage": "responses/feedback.json"
}
}# 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 helpTags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw โ a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.