SmartCloud Flow – Block‑based Forms & Workflow Automation
SmartCloud Flow is a block-based forms and workflow plugin for WordPress. It combines a modern Gutenberg editor experience with a React/Mantine runtime for forms, a native -based light-DOM modal block, and an optional AWS backend, so site owners can design forms and supporting UI in WordPress while choosing where submissions should be posted and, in Pro, running submissions, templates, workflows, and integrations in their own AWS account. Flow is part of the WP Suite product family by Smart Cloud Solutions, Inc. WP Suite keeps WordPress as the CMS and editing layer, while optional connected features can extend selected workflows into modular AWS-backed services for identity, AI, APIs, workflows, protected routes, and static delivery. The free Flow features described here do not require a WP Suite account, subscription, or AWS backend unless you explicitly configure an external service or upgrade-only backend feature. Free mode Flow does not require a hosted SaaS backend or a WP Suite connection to render forms. In Free mode, each form can post directly from the browser to a URL you define per form. That endpoint may be: your own custom endpoint, a WordPress-side endpoint you implement yourself, or the Flow backend submission endpoint, if you later deploy it. Pro mode Pro becomes available after connecting your WordPress site to a WP Suite workspace. It is designed to work especially well with the separately deployed WP Suite Flow Backend in your own AWS account. A typical Pro setup is: deploy the Flow backend to AWS, add the published backend API base URL to Gatey as a separate API, choose the desired protection mode for that API (IAM or COGNITO, matching the backend deployment), then select that API in SmartCloud → Flow Settings → API Settings. This lets Flow use Gatey-aware authenticated API access, while keeping the backend in your own AWS account. Key features Gutenberg form builder — Build forms with a dedicated Form block, layout/container blocks, and rich field blocks. Single React runtime per form — Front-end forms run as one mounted React tree. Light-DOM modal block — Wrap any Gutenberg content in a native dialog with class and data-attribute triggers, hash opening, default header/body/actions slots, action-role aware buttons, and a stable browser API on WpSuite.plugins.flow.modals. Light-DOM gallery block — Build a Mantine-free gallery/lightbox from core Image blocks with previous/next controls, optional thumbnails, optional captions/counter, and modal-aware start positions driven by outer trigger classes. Rich display & content blocks — Use styled content primitives such as blockquotes, marks, badges, code blocks, spoilers, lists, tables, timelines, and overflow lists alongside inputs. API-backed options & request controls — Load select, radio, checkbox-group, and tags options from API/autocomplete endpoints with configurable methods, headers, parameters, selected-value mapping, and runtime interpolation. Conditional logic & validation — Show/hide, enable/disable, require/optional, and other rule-based field behavior. Theme overrides & design tokens — Theme both interactive controls and display/content blocks inside the Shadow DOM with Mantine variables and stable --flow-* CSS tokens. Shortcodes & Elementor support — Reuse forms or content roots via shortcode and Elementor integrations. Flexible submission target model — Submit directly from the browser to a per-form endpoint URL with configurable HTTP methods, optional request headers, and runtime interpolation. Runtime events & host-page integration — Listen for submit, draft, wizard, modal, and API-loading error events from outer-page JavaScript. Pro: backend-aware operation — Connect Flow to the AWS-hosted Flow backend for durable submissions, admin tooling, templates, workflows, and webhook-driven automation. Pro: backend form sync — Optionally sync Gutenberg-defined forms into canonical backend form definitions stored in AWS. Pro: admin application — Manage submissions, templates, workflows, and backend/API settings from WordPress admin. Pro: workflow automation — Event-driven automation for emails, webhooks, status changes, and related operational flows. Pro: security & ownership — Deploy into your own AWS account and choose auth modes such as IAM or COGNITO. You can find continuously expanding documentation at: https://wpsuite.io/docs/ This plugin is not affiliated with or endorsed by Amazon Web Services or the WordPress Foundation. All trademarks are property of their respective owners. Free and Pro Usage Notice Flow works in Free mode without registration or subscription. In Free mode: forms are rendered in the browser, submissions are posted directly to the endpoint URL configured for the form, no WP Suite connection is required. Flow does not inherently store submissions in WordPress. If you want submissions handled inside WordPress, you need to implement and expose your own receiving endpoint there. Pro features are optional and become available after connecting your WordPress site to a WP Suite workspace. The main Pro scenario is to use the separately deployed WP Suite Flow Backend in your own AWS account. In that setup: you publish the backend API, register that API in Gatey, choose its protection mode (IAM or COGNITO), and select that API in SmartCloud → Flow Settings → API Settings. This simplifies secure communication between the WordPress-side Flow plugin and the AWS-hosted backend. Machine-readable resources Plugin manifest: https://wpsuite.io/.well-known/ai-plugin.json OpenAPI spec (backend): https://wpsuite.io/.well-known/openapi.yaml External Services This plugin may integrate with the following external services, depending on configuration: Google reCAPTCHA v3 (optional) What it is & what it’s used for: Client-side bot detection. If enabled, Flow can request reCAPTCHA tokens in the browser to protect submissions. What data is sent & when: The browser may contact Google to retrieve a token. That token may then be included in submission requests. How to configure: Enter your reCAPTCHA site key/secret in the relevant Flow or shared WP Suite settings. Links: About reCAPTCHA: https://www.google.com/recaptcha/about/ Google Terms: https://policies.google.com/terms Google Privacy: https://policies.google.com/privacy Customer-configured submission endpoint / Flow backend endpoint What it is & what it’s used for: The endpoint URL configured for a form submission. In Free mode this may be any URL you control. In Pro, it is commonly the AWS-hosted Flow backend. What data is sent & when: Form field values and, depending on your implementation, related submission metadata. For Pro backend flows, uploaded file references, template variables, and workflow/event metadata may also be sent. Where it goes: Requests are sent directly from the browser to the configured endpoint URL, either through direct fetch calls or, in Pro, through a Gatey-integrated authenticated API flow. How it’s called: Standard HTTPS requests. Authentication depends on your configuration and may be none, IAM, or Cognito-based. WP Suite platform connection (optional; workspace linking and shared features) When it applies: When you connect the site to a WP Suite workspace to enable Pro features and shared admin capabilities. What it’s used for: Workspace linking, shared admin capabilities, license/subscription handling, and related WP Suite platform features. What data may be sent: Minimal site/workspace identifiers and authentication/session data required for linking and management. Where it goes: Secure HTTPS requests to WPSuite.io services such as wpsuite.io and api.wpsuite.io. Links: WPSuite.io Privacy Policy: https://wpsuite.io/privacy-policy WPSuite.io Terms of Use: https://wpsuite.io/terms-of-use Amazon Cognito (optional; authentication for protected APIs) When it applies: When your Flow backend API or related WP Suite services are protected with Cognito and the site uses Cognito-based authentication. What it’s used for: User authentication and token-based authorization for protected API calls. Links: AWS Service Terms: https://aws.amazon.com/service-terms/ AWS Privacy: https://aws.amazon.com/privacy/ Stripe (optional; subscription/purchase flow) When it applies: Only when the user opens the optional WP Suite subscription / purchase flow in the shared admin component. What it’s used for: Displaying hosted pricing/subscription UI for optional paid features. What data may be sent: Browser/session data required by Stripe to render the hosted purchase UI and process the purchase flow. Links: Terms: https://stripe.com/legal/consumer Privacy: https://stripe.com/privacy Trademark Notice Amazon Web Services, AWS, Amazon EventBridge, Amazon DynamoDB, Amazon SES, and Amazon Cognito are trademarks of Amazon.com, Inc. or its affiliates. Google reCAPTCHA is a trademark of Google LLC. WordPress is a trademark of the WordPress Foundation. SmartCloud Flow is an independent project and is not affiliated with, sponsored by, or endorsed by Amazon Web Services, Google, or the WordPress Foundation. Source & Build Public (free) source code: All code that ships in the public (free) version of Flow is available here: https://github.com/smartcloudsol/flow Build & distribution: Flow is shipped to WordPress.org as a pre-built distribution. Build steps and developer notes are maintained in the GitHub repository documentation. Shared WP Suite components: Some admin UI modules may originate from shared WP Suite components to support workspace linking, license validation, and subscription management across WP Suite plugins. Pro-only features (source availability): Flow Pro includes additional functionality such as backend-powered submissions management, templates, workflows, and webhook dispatching. The code that enables these paid features is distributed to Pro users but is not published in the public repository.
