GitPress Forms

Independent WordPress form builder for the GitPress ecosystem. Original PHP and React/TypeScript implementation; Fluent Forms is not a runtime dependency. There are no subscription checks, feature entitlements, site limits, hosted GitPress dependency, or plugin transaction fees.

Version 0.1.1-dev is a development preview. It is not the complete Fluent Forms parity release described in the product plan. Payments are not implemented. Native integration coverage and live account verification are incomplete. Review current coverage and the release checklist before evaluation. This build has not been approved for client production use.

Requirements

• WordPress 6.6 or later; PHP 8.2 or later.
• MySQL with InnoDB for production. WordPress Playground/SQLite is supported for local browser development.
• PHP mbstring, DOM, fileinfo, and Sodium or OpenSSL. GD is required for image/PDF operations.
• WordPress cron and a working WordPress mail transport for queued notifications.

Install the preview

Download the gitpress-forms.zip asset from the GitHub release. Do not upload GitHub's Source code (zip) download or the -source.zip archive; those contain editable source and intentionally omit generated browser assets and Composer dependencies.

1. Build or obtain dist/gitpress-forms.zip.
2. On a test site, open Plugins → Add New → Upload Plugin, upload the ZIP, and activate it.
3. Open GitPress Forms, create a form, choose Published, and save.
4. Embed [gitpress_form id="123"] or use the GitPress Form block.
5. For a popup, use [gitpress_form id="123" popup="Contact us"].

GitPress can render the same shortcode inside its HTML fragments. GitPress remains optional and needs no source changes. Form definitions, entries and workflows belong to WordPress; they are not synchronized to GitHub.

Google reCAPTCHA

GitPress Forms supports the Google reCAPTCHA v2 Checkbox field. Create keys for the website's domain in the Google reCAPTCHA Admin Console, then open GitPress Forms → Global Settings and save the site key and secret key. In the builder, add Google reCAPTCHA from Advanced Fields and choose its light/dark theme and normal/compact size.

The site key is public. The secret is encrypted in WordPress and is never returned by the management API or sent to the browser. Every response is verified with Google on the server before the entry is accepted, and the one-time response token is removed before entries, partial entries, and jobs are stored.

Reproducible build

Use Node.js 24, npm, Composer 2 and PHP 8.2+:

npm ci
composer install --no-dev --prefer-dist --optimize-autoloader
npm run typecheck
npm test
npm run test:php
npm run lint:php
npm run build
npm run package

Set GPF_PHP to your PHP executable if it is not on PATH. The Windows helper can also locate Local's PHP runtime. The canonical WordPress installer is always dist/gitpress-forms.zip; it includes Composer dependencies and browser bundles. An additional source ZIP contains the editable project and lockfiles and is not installable. ZIP entries use fixed timestamps and sorted paths.

npm run release:check

This command intentionally fails while any required acceptance item lacks verified evidence. Stable-version packaging enforces it; development archives are explicitly named -dev.

Development and verification

npm run dev:wordpress

Opens a disposable WordPress Playground site on port 9400. See testing instructions and evidence for the isolated PHP/MySQL site, browser tests and version matrix. No production website was changed during implementation. GitPress Forms is a standalone project with its own dependencies and build configuration, independent of the Barber Refinery website and the GitPress plugin.

Additional documentation: migration, architecture and extension interfaces, security and data lifecycle, provider verification, third-party notices.

Copyright 2026 WestCose Labs. Original plugin code is licensed under GPL-2.0-or-later; see LICENSE. Third-party dependencies retain their licenses.