You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* docs: update documentation to clarify pgflow's benefits and features
Refines the project description, improves clarity on workflow reliability, observability,
type safety, and deployment simplicity, and updates visual asset references for consistency.
* docs: update documentation content and improve clarity on pgflow features
- Revised index.mdx to enhance descriptions of pgflow's capabilities
- Clarified workflow benefits, observability, type safety, and storage details
- Corrected formatting for consistency and readability in the documentation
Copy file name to clipboardExpand all lines: pkgs/website/src/content/docs/index.mdx
+29-28Lines changed: 29 additions & 28 deletions
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,10 @@
1
1
---
2
2
title: pgflow
3
-
description: Postgres-First Workflow Orchestration—All in SQL
3
+
description: Postgres-First Workflow Orchestration - All in SQL
4
4
template: splash
5
5
hero:
6
-
title: Run AI Workflows and Background Jobs directly in Supabase
7
-
# title: Effortless Supabase Workflows for AI & Background Jobs
8
-
# title: Automate AI Workflows Natively on Supabase
9
-
# title: AI Agents & Workflow Automation for Supabase
10
-
# title: Supabase Workflows for AI Agents & Background Jobs
11
-
# title: Build AI Agent Workflows on Supabase
12
-
tagline: No extra servers. Just Supabase-native AI workflows and jobs that don't fail silently.
6
+
title: Run reliable AI Workflows and Background Jobs directly in Supabase
7
+
tagline: With pgflow, you can seamlessly run workflows directly in Supabase, ensuring reliability and visibility without adding extra infrastructure.
13
8
image:
14
9
dark: ../../assets/pgflow-logo-dark.svg
15
10
light: ../../assets/pgflow-logo-light.svg
@@ -40,61 +35,67 @@ npx pgflow@latest install
40
35
41
36
## Why pgflow Exists
42
37
43
-
Supabase is great - until you need reliable, observable background workflows. Then you're stuck hacking together partial solutions or outsourcing core logic to third-party platforms.
38
+
While Supabase provides the essential building blocks, pgflow brings enhanced orchestration for advanced workflow management.
44
39
45
40
#### Developers Instantly Got It
46
41
47
42
*Real comments after seeing early demos*
48
43
49
44
<TestimonialCarouselclient:load />
50
45
51
-
### Pain You've Probably Felt:
46
+
### Have you run into any of these situations?
52
47
53
-
These are the frustrations you’ve likely encountered while trying to piece together workflows with scattered tools and limited support.
48
+
As apps grow, a little extra coordination can save a lot of engineering time. pgflow steps in right there:
54
49
55
50
<CardGrid>
56
-
<Cardtitle="Death by Glue Code"icon="warning">
57
-
Supabase gives you primitives - pg_cron, pg_net, queues - but no orchestration. You end up hand-coding state machines: tracking task progress, wiring retries, handling failures, and cleaning up. Each workflow becomes a tangle of bespoke logic waiting to break.
51
+
52
+
<Cardtitle="Bringing the Pieces Together">
53
+
Queues and Edge Functions shine on their own.
54
+
pgflow wraps them in one orchestration interface, so you write features-not glue code.
58
55
</Card>
59
56
60
-
<Cardtitle="You Can’t Trust It"icon="warning">
61
-
When execution is scattered across queues and handlers, there's no clear spec, no structured tracking, and no way to reason about progress. Failures are invisible. You ship blind, and debug with grep.
57
+
<Cardtitle="Wanting a Bird’s-Eye View">
58
+
When your workflows span several functions or use multiple cron schedules, it's handy to follow progress from a single place.
59
+
pgflow's approach prioritizes at-a-glance visibility for runs, step states, retries and outputs.
62
60
</Card>
63
61
64
-
<Cardtitle="No Type Safety Between Steps"icon="warning">
65
-
Without type safety, you must manually ensure that each step’s outputs align with the next step’s inputs. It’s easy to miss mismatches, leading to runtime errors and fragile workflows.
62
+
<Cardtitle="Extra Type Confidence">
63
+
Define workflows in TypeScript and get a compile-time safety for the data flow between steps.
66
64
</Card>
67
65
68
-
<Cardtitle="Your State, Their Dashboard"icon="warning">
69
-
Tools like Inngest or Trigger.dev live outside your database. Failures and state live in someone else's dashboard. You lose visibility and debug across multiple systems.
66
+
<Cardtitle="Keeping Everything Inside Supabase">
67
+
All state, retries, and dependencies stay in the Postgres database you already trust-no extra services required.
70
68
</Card>
69
+
71
70
</CardGrid>
72
71
73
72
### How pgflow Helps:
74
73
75
-
Solve workflow pain points with Postgres-native orchestration, minimal overhead, and built-in reliability.
74
+
pgflow works in harmony with Supabase's tools, simplifying orchestration and enabling a more cohesive workflow.
75
+
76
+
Eliminate manual orchestration with Postgres‑native workflows, zero extra servers, and built‑in reliability
pgflow handles state transitions, dependencies, and execution control directly in your Supabase Postgres database. No external services required.
80
+
pgflow handles state transitions, dependencies, and execution control directly inside in your Supabase Postgres database. Everything is self-contained.
Jobs are pulled from a Postgres-backed queue and executed in stateless Edge Functions. Built-in support for retries, backoff strategies, and concurrency limits.
84
+
Edge Functions pull tasks from a Postgres queue with automatic retries, back‑offs, and concurrency limits.
0 commit comments