Architecture overview

How LogicGen turns a business goal into a live, connected system — the objects, the lifecycle, and the boundaries.

Last updated June 2025

Mental model#

LogicGen is organised around outcomes, not tools. You describe what you want to happen. The system decides what needs to be built, assembles it, and connects the parts — without you specifying each piece individually.

  • Input: a plain-English description of a business outcome.
  • Output: a surface, a workflow, and a campaign — connected.
  • Control: two review gates before anything goes live.
  • Record: every action logged automatically.

Core objects#

Everything in LogicGen is built from six core objects. They nest inside each other from workspace down to deployment.

  • Workspace — the top-level container. Holds clients, members, and connected tools. One workspace per business or agency.
  • Client — an isolated unit inside an agency workspace. Has its own projects and access controls. Not used in single-tenant workspaces.
  • Project — a named initiative inside a workspace or client. Groups related Lead Automations together.
  • Lead Automation — the core delivery unit. One surface, one workflow, one campaign. Built from a single description.
  • Integration — a connected external tool (CRM, email, payment, etc.). Scoped to the workspace and used by Lead Automations inside it.
  • Deployment — the live instance of a Lead Automation. Created on approval. Immutable; revisions create new deployments.

A single workspace can contain many projects. A single project can contain many Lead Automations. Each Lead Automation maps to exactly one deployment at a time.


Build lifecycle#

Every Lead Automation moves through six stages. The two review stages are the only moments where human input is required.

  • intake — you describe the outcome. LogicGen asks clarifying questions if needed.
  • plan — LogicGen produces a structured plan: surface type, workflow steps, campaign shape. You review and approve or revise.
  • generate — LogicGen builds all three layers from the approved plan. No further input needed.
  • review — you inspect the output before it goes live. Request changes to return to generate.
  • deploy — on approval, the Lead Automation is deployed. Integrations activate. The surface goes live.
  • monitor — activity is recorded. Conversion events, integration actions, and errors appear in the audit trail.

Workspace boundaries#

Workspace boundaries are hard. No data, credentials, or customer records cross workspace lines unless explicitly exported.

  • Integrations are scoped to the workspace that connected them.
  • Client workspaces inside an agency cannot see each other.
  • Members can be invited into specific workspaces or clients — not both by default.
  • Lead Automation templates can be copied across workspaces, but live data stays isolated.

This model makes LogicGen safe for agency use — a single team member can manage multiple clients without accidental data bleed.

Read about multi-tenant workspaces

Data flow#

Data moves through a Lead Automation in a predictable direction: inbound from the surface, processed by the workflow, outbound via integrations, and stored in the deployment record.

  • Surface captures input — form fill, click, payment, or page visit.
  • Workflow processes it — scores, routes, enriches, or stores.
  • Integrations execute — CRM write, Slack alert, email trigger, or webhook.
  • Deployment record stores the event — queryable from the audit trail.

LogicGen does not store your customers' data long-term. Events are passed through to your connected tools. The audit trail records what happened, not the payload content.


Deployment#

Lead Automation surfaces are deployed to a global CDN on approval. Workflows run as serverless functions. Campaigns are handed off to the connected email or outbound tool.

  • Default deployment target: Vercel. Bring your own domain or use the LogicGen subdomain.
  • Data storage for form responses: Supabase or your own database via integration.
  • Deployments are immutable. Revisions produce a new deployment. The previous one is preserved in history.
  • Rollback is available from the audit trail — re-activate any previous deployment in one action.

Activity & history#

Every stage transition, approval, deployment, and integration action is appended to an immutable log. The log is scoped to the workspace and can be filtered by object or event type.

  • Recorded events: plan created, plan approved, generation started, review opened, approved, deployed, integration triggered, deployment rolled back.
  • Each event records the actor, timestamp, and affected object.
  • Logs are exportable as JSON or CSV.
  • Read more at Audit Trail.