FormFarm v1.0.0 is the inception release of FormFarm — a lightweight, private SaaS alternative to Formspree built from scratch in PHP and MySQL using a custom MVC pattern. It allows developers to collect form submissions directly from frontend websites without managing independent backend servers for every form.
- 👤 Full User Authentication Engine:
- Secure registration, login, and logout backed by native PHP session persistence.
- High-security password encryption using
password_hash()andpassword_verify().
- 📊 Dynamic Neural Dashboard:
- Real-time counter displaying total active data nodes.
- Recent activity stream showing the latest form collection points.
- 🔑 Cryptographic Form Key Generation:
- Generates unique 16-character hexadecimal keys via
bin2hex(random_bytes(8)).
- Generates unique 16-character hexadecimal keys via
- 📩 Public Form Ingestion Endpoint (
/f/{form_key}):- Accepts standard HTML form submissions using HTTP POST.
- Dynamic routing powered by a custom regex router with Apache
mod_rewrite. - Non-POST requests automatically direct users to an informative
/endpoint_activeguide.
- 👁️ Data Stream Viewer:
- Form submissions parsed from JSON and displayed chronologically in tabular format.
- Single record purge and bulk purge with select-all checkbox support.
- 📬 Basic Email Notifications:
- Form owners receive instant email alerts via native PHP
mail()andMailHelper.
- Form owners receive instant email alerts via native PHP
- 🎨 Dark Sci-Fi Cyberpunk Theme:
- Red-and-black palette (
#000000,#ff0a0a), Google Fonts Orbitron & Inter. - Interactive Canvas particle background with interconnecting nodes using
particles.js.
- Red-and-black palette (
- Backend: PHP 7.4+ (Custom MVC framework)
- Database: MySQL (PDO with prepared statements & foreign key cascading)
- Frontend: HTML5, CSS3, Bootstrap 5, Bootstrap Icons
- Web Server: Apache (
.htaccessURL rewriting)
FormFarm v1.1.0 introduces a standalone, client-side testing interface designed for developers to test their FormFarm endpoints live, along with hosting optimizations and server stability improvements for production deployment.
- 🧪 Standalone Interactive Client Test Suite (
test/):test/index.html: A production-grade test contact form simulating external website transmissions.test/style.css:- Cyber-glow aesthetics using Google Font Outfit.
- Vibrant cyan and electric blue gradient palette (
#00f2feand#4facfe). - Input focus-glow micro-animations and blurred glass card (
backdrop-filter).
test/script.js:- Real-Time 3D Card Parallax: Subtle card rotation responding dynamically to cursor coordinates across X and Y axes.
- Interactive submit state ("Transmitting Data...") with button locking to prevent double submissions.
test/assets/neural_background.png: High-resolution dark cybernetic background asset.
- ⚙️ Production Server & Hosting Configurations:
- Added dedicated
php.inidirectives for cPanel environments with automated error logging. - Configured Hostinger and cPanel deployment instructions in
Host.md. - Refined
/thankssubmission confirmation page styling.
- Added dedicated
- Core Platform: PHP 7.4+, MySQL
- Test Interface: Vanilla HTML5, CSS3, JavaScript (ES6+), Google Font Outfit
- Deployment: Apache, cPanel MultiPHP, Hostinger
FormFarm v2.0.0 is a complete, ground-up rewrite of the FormFarm platform into an enterprise-grade, modern SaaS stack. Replacing the PHP and MySQL codebase, this version leverages Next.js 16 (App Router), TypeScript, and MongoDB Atlas (FormFarmDB) to provide ultra-fast performance, automated client telemetry, serverless scalability, and enhanced developer ergonomics.
- ⚡ Next.js 16 App Router & Serverless Architecture:
- Full TypeScript type-safety across all server actions, route handlers, and UI components.
- Built with Turbopack for near-instant hot reloads and optimized production builds.
- 🍃 Cloud MongoDB Persistence (
FormFarmDB):- Connected to MongoDB Atlas with connection pooling for serverless environments.
- Unique database indexing on user emails and form keys.
- Automatic cascading deletions: deleting a form cleanly purges all its associated submissions.
- 🔐 Hardened Authentication & Session Management:
- High-security password hashing using
bcryptjswith auto-generated salts. - Stateless authentication utilizing cryptographically signed,
HttpOnly,SameSite=laxJWT session cookies.
- High-security password hashing using
- 🌐 Automated Client Telemetry & Tracking:
- Real IP Detection: Accurately resolves client IP addresses through proxy and cloud headers (
x-forwarded-for,x-real-ip). - Live Geolocation Tracking: Automatically determines the submitter's Country and City.
- Device / Browser Identification: Captures client
User-Agenttelemetry. - Telemetry is stored directly in MongoDB and displayed with globe/pin badges on the dashboard.
- Real IP Detection: Accurately resolves client IP addresses through proxy and cloud headers (
- 📬 Dual-Format Email Dispatcher (Nodemailer):
- Form owners receive instant, beautifully styled dark-mode HTML & Plain Text emails upon every submission.
- Emails include the full extracted payload along with the client's IP, City, Country, and User-Agent.
- 🔗 Universal Form Ingestion Endpoint (
/f/[form_key]):- HTML Forms: Seamlessly accepts standard
POSTsubmissions (x-www-form-urlencodedandmultipart/form-data) with automatic 303 redirect to/thanks. - AJAX / Fetch: Supports direct JSON
POSTrequests with comprehensive CORS headers for modern Single-Page Applications (SPAs). - Clean Thank You Page: Clean, distraction-free confirmation strictly displaying:
"Your data has been successfully submitted."
- HTML Forms: Seamlessly accepts standard
- 🛠️ Included Developer Testing Suite:
test-form.html: Standalone interactive test page with live toggle between Standard POST and AJAX modes.public/test/: The v1.1.0 3D parallax Outfit test interface migrated directly into the Next.js static engine.scripts/verify-e2e.mjs: Automated 13-stage end-to-end integration test runner validating all auth, form, and submission flows.
- Framework: Next.js 16 (React 19, Turbopack)
- Language: TypeScript 5+
- Database: MongoDB Atlas (
FormFarmDB) - Security:
bcryptjs,jsonwebtoken - Email:
nodemailer - Design System: Vanilla CSS with custom properties, Google Fonts Orbitron & Inter, Bootstrap Icons
This project is 100% created by MD SAMIUR RAHMAN TANIM. All rights reserved. Unauthorized copying or redistribution is strictly prohibited without explicit author consent.