Quick Reference
| Topic | File |
|---|
| Field types by use case | INLINECODE0 |
| Platform comparisons |
platforms.md |
| Code generation (React, Flutter) |
code.md |
| Validation patterns |
validation.md |
| Integrations (webhooks, CRMs) |
integrations.md |
| Self-hosted options |
selfhosted.md |
User Profile
Preferred Stack
Primary Use Case
Default Platform
Data Storage
Store form definitions and templates in ~/forms/:
- - templates — Reusable form definitions (JSON/YAML)
- submissions — Collected responses (if self-hosted)
- feedback — What converts well, what fails
Core Rules
- - Ask use case before suggesting fields — lead form ≠ application form
- Progressive disclosure: start minimal, reveal complexity if needed
- Mobile-first: every form must work on phone
- Never more than 7 fields for lead capture — each field drops conversion ~10%
- Multi-step > single long form for 5+ fields
- Validate on blur, not just submit — immediate feedback
- Always include: clear labels, error states, success confirmation
- GDPR checkbox mandatory for EU — link to privacy policy
- Honeypot over CAPTCHA when possible — less friction
- File uploads need type + size limits — prevent abuse
- Conditional logic syntax: INLINECODE6
- Test on real devices — emulators miss keyboard quirks
快速参考
| 主题 | 文件 |
|---|
| 按用例划分的字段类型 | types.md |
| 平台对比 |
platforms.md |
| 代码生成（React、Flutter） | code.md |
| 验证模式 | validation.md |
| 集成（Webhooks、CRM） | integrations.md |
| 自托管选项 | selfhosted.md |
用户画像
首选技术栈
主要使用场景
默认平台
数据存储
将表单定义和模板存储在 ~/forms/ 目录下：
- - templates — 可复用的表单定义（JSON/YAML）
- submissions — 收集到的回复（如为自托管）
- feedback — 哪些转化效果好，哪些效果差
核心规则
- - 在推荐字段前先询问使用场景 — 线索表单 ≠ 申请表单
- 渐进式披露：从最简开始，必要时再展示复杂内容
- 移动优先：每个表单都必须在手机上可用
- 线索收集表单字段不超过7个 — 每增加一个字段转化率下降约10%
- 5个以上字段时，多步骤表单优于单页长表单
- 失焦时即验证，而非仅提交时验证 — 提供即时反馈
- 始终包含：清晰的标签、错误状态、成功确认
- 欧盟地区必须包含GDPR复选框 — 链接至隐私政策
- 尽可能使用蜜罐技术而非验证码 — 减少用户操作摩擦
- 文件上传需设置类型和大小限制 — 防止滥用
- 条件逻辑语法：IF 字段=值 THEN 显示/隐藏 字段
- 在真实设备上测试 — 模拟器无法捕捉键盘交互细节
