Category
Forms
Lead-capture forms — vision, API spec, architecture, database schema, submission credits/metering, and embedding surfaces
Forms Service — Documentation Index
--- Vlozi Forms is a multi-tenant, Web3Forms-grade form backend. A tenant creates a form in the dashboard, gets a public form_id, and embeds a <form> or AJAX call, or SDK on any we
Forms Service — API Specification
All routes are reached through the gateway, which mounts the service at /forms and strips that prefix. Internal worker paths shown below. Public gateway base URL: https://api.vlozi
Forms Service — Architecture
--- Forms Service is vlozi's multi-tenant form backend — a Web3Forms-grade capture layer described in forms-vision.md./forms-vision.md. A tenant creates a form, gets a public form_
Forms Service — Backlog: Bugs, Gaps & Improvement Scope
--- | | Parameter | Score | Notes | |---|-----------|-------|-------| | 1 | API Design | 9.0/10 | Three clean surfaces public/admin/MCP, Web3Forms compat, good error codes, paginat
Forms Service — Billing & Credits
--- 0.25 credits per accepted non-spam submission. Spam submissions honeypot trips, captcha failures are stored but not billed. The credit charge happens only after the submission
Forms Service — Database
Single Neon PostgreSQL database FORMS_DATABASE_URL. Every table is tenant-scoped via a tenant_id text column. Credit metering reads from CORE_DATABASE_URL a separate database — see
Forms Service — Embedding & SDK
Three surfaces for collecting form submissions: a hosted page, a script embed widget, and the @vlozi/forms SDK. --- Every form has a fully themed, standalone HTML page at: https://
Vlozi Forms — Product Vision
--- Founders and creators bleed leads every day. They have a landing page with a contact form, a waitlist on a side-project, a feedback widget on a docs site, and a "book a demo" b
Forms Service — Implementation Plan (Phase 1: Web3Forms Parity)
This plan mirrors apps/blog-service conventions verbatim Hono app, dbMiddleware, gateway-key guard, requireTenant/requirePermission, ServiceResult<T> + jsonError, Drizzle/Neon, str
Forms Service — Permissions
--- | Permission | Grants access to | |-----------|-----------------| | forms:read | List forms, get a form, per-form analytics, tenant overview, list submissions all statuses, get
Forms Service — Webhooks
Webhooks deliver real-time submission notifications to your own endpoint. Every accepted submission excluding spam triggers a POST to the form's configured webhookUrl. --- Set webh