Initial commit: lightweight form capture microservice

2026-02-04 10:24:06 -06:00
commit e46c1c7063
4 changed files with 317 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,94 @@
+# Form Capture
+
+Lightweight form capture microservice. ~100 lines, SQLite storage, zero config.
+
+## Deploy to Railway
+
+[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template)
+
+1. Create new project on Railway
+2. Connect this repo
+3. Add environment variables (optional):
+   - `API_KEY` - Protect admin endpoints (recommended)
+   - `ALLOWED_ORIGINS` - Comma-separated origins (default: `https://chatlabsai.com`)
+4. Add a volume mounted at `/app/data` for persistent storage
+5. Deploy
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `3000` | Server port |
+| `API_KEY` | none | Protect `/emails`, `/export`, `/stats` |
+| `ALLOWED_ORIGINS` | `https://chatlabsai.com` | CORS origins (comma-separated) |
+| `DATABASE_PATH` | `./data/forms.db` | SQLite database path |
+
+## API Endpoints
+
+### Submit Form
+```bash
+POST /submit
+Content-Type: application/json
+
+{
+  "email": "user@example.com",
+  "form_name": "newsletter",  # optional, default: "default"
+  "source": "homepage"        # optional
+}
+```
+
+### List Submissions (protected)
+```bash
+GET /emails?form_name=newsletter&limit=100&offset=0
+Authorization: Bearer YOUR_API_KEY
+```
+
+### Export CSV (protected)
+```bash
+GET /export?form_name=newsletter
+Authorization: Bearer YOUR_API_KEY
+```
+
+### Stats (protected)
+```bash
+GET /stats
+Authorization: Bearer YOUR_API_KEY
+```
+
+### Health Check
+```bash
+GET /health
+```
+
+## Frontend Usage
+
+```javascript
+// Submit form
+const response = await fetch('https://your-app.railway.app/submit', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    email: 'user@example.com',
+    form_name: 'android-waitlist',
+    source: window.location.pathname
+  })
+});
+
+if (response.ok) {
+  // Show success message
+}
+```
+
+## Local Development
+
+```bash
+npm install
+npm start
+```
+
+Test submission:
+```bash
+curl -X POST http://localhost:3000/submit \
+  -H "Content-Type: application/json" \
+  -d '{"email": "test@example.com", "form_name": "test"}'
+```