From 3507402eb54ebcce399d932d399e480ec042d237 Mon Sep 17 00:00:00 2001 From: Pranay Prakash Date: Sat, 11 Apr 2026 19:51:46 -0700 Subject: [PATCH 1/2] Add Railway deployment guide to postgres README --- postgres/README.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/postgres/README.md b/postgres/README.md index acf8e8e..3ac237e 100644 --- a/postgres/README.md +++ b/postgres/README.md @@ -57,4 +57,29 @@ This starter is a template for a Next.js project that uses Workflow DevKit with The postgres world is incompatible with Vercel deployments (on Vercel, workflow deployments are automatically configured to use the Vercel World with zero configuration). -Coming soon: instructions on deploying workflows using the Postgres World off-Vercel. +### Deploy on Railway + +[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/workflow-devkit?utm_campaign=workflow-devkit) + +This example is also available as a Railway template that deploys: + +- the `postgres` demo app +- a PostgreSQL database for the Postgres World +- a separate observability deployment for inspecting runs + +After deploying the template, trigger a workflow run against your app deployment: + +```bash +curl -X POST \ + -H 'content-type: application/json' \ + --data '{"email":"your-test@example.com"}' \ + https://YOUR-APP-URL/api/signup +``` + +You should get back: + +```json +{"message":"User signup workflow started"} +``` + +Then open your observability deployment URL to watch the run progress and confirm that it completes successfully. From af98ef9d989b18f00b2da6babb21bb627c29f8c2 Mon Sep 17 00:00:00 2001 From: Pranay Prakash Date: Sat, 11 Apr 2026 19:57:05 -0700 Subject: [PATCH 2/2] Refine postgres README deployment wording --- postgres/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/postgres/README.md b/postgres/README.md index 3ac237e..75e7223 100644 --- a/postgres/README.md +++ b/postgres/README.md @@ -55,9 +55,9 @@ This starter is a template for a Next.js project that uses Workflow DevKit with ### Production Deployment -The postgres world is incompatible with Vercel deployments (on Vercel, workflow deployments are automatically configured to use the Vercel World with zero configuration). +On Vercel, workflows are automatically configured and optimized to use the [Vercel World](https://useworkflow.dev/worlds/vercel), which is secure and infinitely scalable by default. When using the Postgres World, you may want to self-host on your own infrastructure. Here's an example with Railway. -### Deploy on Railway +### Self-Host on Railway [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/workflow-devkit?utm_campaign=workflow-devkit) @@ -82,4 +82,4 @@ You should get back: {"message":"User signup workflow started"} ``` -Then open your observability deployment URL to watch the run progress and confirm that it completes successfully. +Then open your observability deployment URL to watch the run progress, inspect the workflow steps, and confirm that the run completes successfully.