> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowripple.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Stop hardcoding transactional logic. Trigger notifications, delays, and multi-step flows from your code with a single SDK call.

## What is Flowripple?

Flowripple is backend infrastructure that handles your transactional logic—notifications, delays, retries, and multi-step flows—so you don't have to hardcode them. Install the SDK, fire events from your code, and let Flowripple execute the rest.

<Info>
  Replace hundreds of lines of notification code, cron jobs, and queue workers
  with a single `flowripple.trigger()` call. We handle the infrastructure so you
  can ship features faster.
</Info>

Stop writing boilerplate for every notification and delay. Flowripple gives you a code-to-no-code bridge that separates transactional logic from your core application:

* **One SDK call, unlimited workflows** - Trigger complex multi-step sequences with `flowripple.trigger('user.signup', { user })`
* **Update logic without deployments** - Change notification copy, add delays, or modify flows in the dashboard—no code changes required
* **Built-in reliability** - Automatic retries, rate limiting, and error handling you'd otherwise build yourself
* **Full observability** - Real-time execution logs and traces for debugging production issues

## Get started

Get your first workflow running in under 10 minutes.

<Card title="Quickstart guide" icon="rocket" href="/quickstart">
  Complete walkthrough from account setup to your first triggered workflow.
  Includes code examples and step-by-step instructions.
</Card>

## How it works

<Steps>
  <Step title="Install the SDK">
    Add the Flowripple SDK to your project with a single command:

    ```bash theme={null}
    npm install @flowripple/sdk
    ```
  </Step>

  <Step title="Trigger events from your code">
    Fire events wherever you'd normally write transactional logic:

    ```typescript theme={null}
    import { FlowrippleClient } from '@flowripple/sdk';

    const flowripple = new FlowrippleClient({ apiKey: process.env.FLOWRIPPLE_API_KEY });

    // Instead of hardcoding email logic here...
    await flowripple.trigger('user.signup', {
      user: { id: user.id, email: user.email, name: user.name }
    });
    ```

    <Tip>
      Events are auto-created on first trigger—no pre-configuration needed.
    </Tip>
  </Step>

  <Step title="Build workflows visually">
    Design what happens after each event in the dashboard. Add welcome emails,
    delays, Slack notifications, webhooks—chain them together without writing code.
  </Step>

  <Step title="Monitor in production">
    View real-time execution logs. Debug failed workflows with full traces.
    Know exactly what happened and when.
  </Step>
</Steps>

## What you can eliminate from your codebase

Replace hardcoded transactional logic with SDK calls:

* **Notification sequences** - Welcome emails, onboarding drips, payment receipts—trigger once, update anytime in the dashboard
* **Delayed actions** - "Send reminder in 24 hours" without cron jobs or queue workers
* **Conditional branching** - Route logic based on user data without if/else spaghetti
* **Multi-channel alerts** - Email + Slack + webhook from one trigger, no integration code needed
* **Retry logic** - Automatic retries with exponential backoff—delete your try/catch boilerplate
* **Webhook orchestration** - Call external APIs with built-in error handling and logging

## Common use cases

SaaS developers use Flowripple to eliminate transactional boilerplate:

<AccordionGroup>
  <Accordion title="User onboarding">
    Replace your hardcoded welcome email sequence with a single `user.signup` trigger. Add onboarding steps, delays between emails, and conditional paths—all without touching your codebase.

    ```typescript theme={null}
    // Your code stays clean
    await flowripple.trigger('user.signup', { user });
    // Flowripple handles: welcome email → 24h delay → tips email → 3d delay → feature highlight
    ```
  </Accordion>

  <Accordion title="Transactional notifications">
    Stop scattering email code across your controllers. Centralize all notification logic in visual workflows and trigger them from anywhere in your app.

    ```typescript theme={null}
    await flowripple.trigger('order.shipped', { order, tracking });
    // Flowripple handles: shipping email + Slack alert to ops + webhook to analytics
    ```
  </Accordion>

  <Accordion title="Payment events">
    Handle billing logic without polluting your payment code. Trigger on Stripe webhooks or from your own handlers—receipts, failed payment reminders, and upgrade prompts all live in the dashboard.

    ```typescript theme={null}
    await flowripple.trigger('payment.failed', { user, invoice });
    // Flowripple handles: immediate email → 3d reminder → 7d final warning → Slack alert
    ```
  </Accordion>

  <Accordion title="Internal alerts">
    Get notified when important things happen in production. High-value signups, failed jobs, usage thresholds—route alerts to Slack, email, or webhooks without writing alert code.

    ```typescript theme={null}
    await flowripple.trigger('alert.high_value_signup', { user, plan });
    // Flowripple handles: Slack to #sales + email to founder + CRM webhook
    ```
  </Accordion>
</AccordionGroup>

## Explore the documentation

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install the SDK, get your API key, and trigger your first event in under 10 minutes.
  </Card>

  <Card title="Workflows" icon="sitemap" href="/workflows">
    Build multi-step flows in the visual editor. Chain actions, add delays, and create conditional paths.
  </Card>

  <Card title="Triggers" icon="bolt" href="/workflows/triggers">
    Connect workflows to SDK events or run them on schedules with cron expressions.
  </Card>

  <Card title="Delays" icon="clock" href="/workflows/delay">
    Add time-based pauses—"wait 24 hours then send reminder"—without cron jobs.
  </Card>

  <Card title="Flow Control" icon="code-branch" href="/workflows/flow-control">
    Branch workflows based on event data. Route different users through different paths.
  </Card>

  <Card title="Actions" icon="zap" href="/workflows/actions">
    Send emails, post to Slack, call webhooks, and more—all with built-in retries.
  </Card>
</CardGroup>

## Need help?

<Note>
  **Questions or feedback?** Reach out to our support team at
  [support@flowripple.com](mailto:support@flowripple.com) or visit the
  [dashboard](https://app.flowripple.com/app) to get started.
</Note>
