Skip to content

Commit 2951384

Browse files
authored
Improve copywriting on the landing page (#107)
* 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
1 parent 32b560f commit 2951384

File tree

1 file changed

+29
-28
lines changed

1 file changed

+29
-28
lines changed

pkgs/website/src/content/docs/index.mdx

Lines changed: 29 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,10 @@
11
---
22
title: pgflow
3-
description: Postgres-First Workflow OrchestrationAll in SQL
3+
description: Postgres-First Workflow Orchestration - All in SQL
44
template: splash
55
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.
138
image:
149
dark: ../../assets/pgflow-logo-dark.svg
1510
light: ../../assets/pgflow-logo-light.svg
@@ -40,61 +35,67 @@ npx pgflow@latest install
4035

4136
## Why pgflow Exists
4237

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.
4439

4540
#### Developers Instantly Got It
4641

4742
*Real comments after seeing early demos*
4843

4944
<TestimonialCarousel client:load />
5045

51-
### Pain You've Probably Felt:
46+
### Have you run into any of these situations?
5247

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:
5449

5550
<CardGrid>
56-
<Card title="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+
<Card title="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.
5855
</Card>
5956

60-
<Card title="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+
<Card title="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.
6260
</Card>
6361

64-
<Card title="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+
<Card title="Extra Type Confidence">
63+
Define workflows in TypeScript and get a compile-time safety for the data flow between steps.
6664
</Card>
6765

68-
<Card title="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+
<Card title="Keeping Everything Inside Supabase">
67+
All state, retries, and dependencies stay in the Postgres database you already trust-no extra services required.
7068
</Card>
69+
7170
</CardGrid>
7271

7372
### How pgflow Helps:
7473

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
7677

7778
<CardGrid>
7879
<Card title="Postgres-Native Orchestration" icon="approve-check">
79-
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.
8081
</Card>
8182

8283
<Card title="Durable Queue-Based Workers" icon="approve-check">
83-
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.
8485
</Card>
8586

86-
<Card title="Simple Flow Definitions" icon="approve-check">
87+
<Card title="Simple, Typed Flow Definitions" icon="approve-check">
8788
You specify flow logic once. pgflow enforces retries, timeouts, and step dependencies without custom plumbing.
8889
</Card>
8990

90-
<Card title="No Infra, No Lock-In" icon="approve-check">
91-
Everything runs inside your Supabase setup. No external runtimes or vendor dashboards.
91+
<Card title="Zero Extra Infra, Zero Lock-In" icon="approve-check">
92+
Everything stays in your Supabase project. No extra runtimes, no vendor dashboards.
9293
</Card>
9394
</CardGrid>
9495

9596
### What You Can Build with pgflow:
9697

97-
- **AI Workflows:** Chain LLMs, scrape data, reason across tools, and recover from failures all natively in Supabase.
98+
- **AI Workflows:** Chain LLMs, scrape data, reason across tools, and recover from failures - all natively in Supabase.
9899
- **Background Jobs:** Handle emails, file processing, and scheduled tasks with full visibility
99100
- **Data Pipelines:** Extract, transform, and load data across systems without losing track of progress
100101

@@ -153,7 +154,7 @@ new Flow<{ url: string }>({
153154

154155
<CardGrid>
155156
<Card title="Single source of truth" icon="open-book">
156-
All workflow definitions, state, and execution history stored in your Postgres databasesimplifying monitoring and debugging.
157+
All workflow definitions, state, and execution history stored in your Postgres database-simplifying monitoring and debugging.
157158
</Card>
158159

159160
<Card title="Reliable task processing" icon="rocket">
@@ -178,7 +179,7 @@ Create and run workflows with a straightforward process:
178179
1. **Deploy as Supabase Edge Functions**
179180
1. **Trigger workflows from your app or SQL**
180181

181-
The execution system handles the restscheduling steps when dependencies complete, retrying failed tasks, and aggregating results automatically.
182+
The execution system handles the rest-scheduling steps when dependencies complete, retrying failed tasks, and aggregating results automatically.
182183

183184
## Ready to get started?
184185

0 commit comments

Comments
 (0)