Intentflow: Open-Source UX Flow Engine for Product-Led Growth Teams

At Mixpeek, we track a lot: homepage interactions, docs exploration, demo CTAs, SDK installs. Like most growth-minded teams we're rich in hypotheses—and poor in implementation bandwidth.

We needed a way to ship contextual UX flows fast without hard-coding logic into every page or paying for heavyweight onboarding suites.

So we built Intentflow—an open-source engine that lets anyone define banners, tooltips, and modals in YAML and render them dynamically with React.

Quick Install

npm install intentflow

import { IntentflowProvider } from 'intentflow';

<IntentflowProvider>
  <App />
</IntentflowProvider>

What Is Intentflow?

Think of Intentflow as feature flags for UX flows. You describe a journey declaratively and Intentflow handles flag tracking and component rendering.

# schedule_meeting.yaml

goals:
  schedule_meeting:
    steps:
      - id: viewed_pricing
        event: page_view
        path: "/pricing"
        set_flag: viewed_pricing
      - id: clicked_cta
        event: click
        selector: ".cta-button"
        requires_flags: [viewed_pricing]
        set_flag: interested_user

Wrap components with hooks like useUXFlag, useUXStep, or drop in <Modal> / <Tooltip> and let the flow engine do the rest.

Why Existing Tools Fell Short

Tool	Why It Didn't Work
Appcues / Pendo	Too heavy, rigid, and pricey
PostHog / Segment	Great tracking, no UI control
Custom JS	Hard to maintain across 20+ pages

We wanted:

Version-controlled YAML
Full control over rendering
Built-in flag tracking
No vendor lock-in / minimal JS

Intentflow gave us that—and nothing else did.

How We Use Intentflow at Mixpeek

Homepage Engagement – set flags like viewed_pricing, hovered_demo
Contextual Onboarding – trigger tooltips on docs & dashboards
Demo & Lead Capture – show modals when a user signals intent but hasn't converted
Dynamic Banners – guide sign-ups based on scroll-depth & exits

All defined in YAML, reviewed in PRs, and shipped in minutes.

Analytics Integrations

Intentflow broadcasts every captureEvent to any provider you initialise.

Provider	Focus	OSS?	Init Example
PostHog	Product analytics + feature flags	Yes	`initPostHog('PH_KEY')`
Amplitude	Growth analytics & cohorts	No	`initAmplitude('AMP_KEY')`
Heap	Auto-captured events	No	`initHeap('HEAP_APP_ID')`
RudderStack	CDP / data pipeline	Partial	`initRudderStack('WRITE_KEY','https://rs.acme.com')`
Snowplow	Behavioural data platform	Yes	`initSnowplow('https://collector.acme.com')`
Matomo	GDPR-focused analytics	Yes	`initMatomo('SITE_ID','https://matomo.acme.com')`

LLM-Driven Decisioning

Need smarter targeting? Evaluator lets you ask your favourite model which component to render.

Provider	Model Family	Init Example
OpenAI ChatGPT	GPT-3.5 / GPT-4	`new Evaluator('openai', OPENAI_KEY)`
Google Gemini	Gemini-Pro	`new Evaluator('gemini', GEMINI_KEY)`
Anthropic Claude	Claude 3	`new Evaluator('claude', ANTHROPIC_KEY)`

const decision = await evaluator.evaluate({
  flags: { viewed_pricing: true },
  components: [{ id: 'modal1', type: 'modal' }],
  goal: 'schedule_meeting',
  page: '/pricing'
});

Supercharge with Mixpeek

Pair Intentflow with Mixpeek's retrieval engine to:

Retrieve the best YAML flow for a session
Cluster historical sessions to surface winning patterns
Personalise without cookies using multimodal vectors

import { retrieveFlow } from 'intentflow/mixpeek';
const flow = await retrieveFlow("User hovered CTA, watched demo");

Roadmap

Devtools overlay to inspect flags live
LLM prompt builder playground
Component A/B testing with clustering insights
Vue, Svelte & Solid bindings

Open Source & Contributing

Intentflow is free & open-source under the permissive Apache-2.0 license.

We welcome pull requests for:

New analytics adapters
Additional framework bindings
Docs & examples
Bug fixes / performance tweaks

→ Fork the repo, open a PR, and build the composable UX engine growth teams deserve.

Ready to Try?

npm install intentflow

Ship contextual UX in minutes—not days. Built for devs. Designed for growth. Powered by Mixpeek.