Skip to content

Conversation

@jumski
Copy link
Contributor

@jumski jumski commented Nov 27, 2025

Improved Example Flow and Worker for Better Onboarding

This PR enhances the onboarding experience by replacing the generic example flow with a more intuitive GreetUser flow and adding a corresponding Edge Worker. The changes include:

  • Created a new greet-user-worker that automatically gets scaffolded during installation
  • Replaced example-flow.ts with a more descriptive greet-user.ts that demonstrates step dependencies
  • Added a new "Quickstart" guide to help users run the example flow in 5 minutes
  • Restructured the "Create Flow" guide to focus on explaining the scaffolded example
  • Updated the installation completion message to direct users to the quickstart

The GreetUser flow demonstrates core pgflow concepts with two steps:

  1. A fullName step that combines first and last name
  2. A greeting step that depends on the first step's output

These changes provide a more complete out-of-the-box experience, allowing new users to see pgflow in action immediately after installation.

@changeset-bot
Copy link

changeset-bot bot commented Nov 27, 2025

⚠️ No Changeset found

Latest commit: 98f0546

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Copy link
Contributor Author

jumski commented Nov 27, 2025

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • merge:queue - adds this PR to the back of the merge queue
  • hotfix:queue - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@nx-cloud
Copy link

nx-cloud bot commented Nov 27, 2025

View your CI Pipeline Execution ↗ for commit 98f0546

Command Status Duration Result
nx affected -t verify-exports --base=origin/mai... ✅ Succeeded 3s View ↗
nx affected -t build --configuration=production... ✅ Succeeded 30s View ↗
nx affected -t lint typecheck test --parallel -... ✅ Succeeded 3m 49s View ↗
nx run edge-worker:e2e ✅ Succeeded 2m 52s View ↗
nx run cli:e2e ✅ Succeeded 5s View ↗

☁️ Nx Cloud last updated this comment at 2025-11-28 07:43:14 UTC

@jumski jumski force-pushed the 11-27-scaffold_greetuser_example_flow_and_worker_during_install_with_quickstart_docs branch from 65e1a20 to 98f0546 Compare November 28, 2025 07:34
@github-actions
Copy link
Contributor

🔍 Preview Deployment: Website

Deployment successful!

🔗 Preview URL: https://pr-443.pgflow.pages.dev

📝 Details:

  • Branch: 11-27-scaffold_greetuser_example_flow_and_worker_during_install_with_quickstart_docs
  • Commit: 2059886e03fe8325badf41a31c6e60762d15cb03
  • View Logs

_Last updated: _

@graphite-app
Copy link
Contributor

graphite-app bot commented Nov 28, 2025

Merge activity

  • Nov 28, 11:45 PM UTC: jumski added this pull request to the Graphite merge queue.
  • Nov 28, 11:45 PM UTC: CI is running for this pull request on a draft pull request (#449) due to your merge queue CI optimization settings.
  • Nov 28, 11:53 PM UTC: Merged by the Graphite merge queue via draft PR: #449.

graphite-app bot pushed a commit that referenced this pull request Nov 28, 2025
# Improved Example Flow and Worker for Better Onboarding

This PR enhances the onboarding experience by replacing the generic example flow with a more intuitive `GreetUser` flow and adding a corresponding Edge Worker. The changes include:

- Created a new `greet-user-worker` that automatically gets scaffolded during installation
- Replaced `example-flow.ts` with a more descriptive `greet-user.ts` that demonstrates step dependencies
- Added a new "Quickstart" guide to help users run the example flow in 5 minutes
- Restructured the "Create Flow" guide to focus on explaining the scaffolded example
- Updated the installation completion message to direct users to the quickstart

The `GreetUser` flow demonstrates core pgflow concepts with two steps:
1. A `fullName` step that combines first and last name
2. A `greeting` step that depends on the first step's output

These changes provide a more complete out-of-the-box experience, allowing new users to see pgflow in action immediately after installation.
@graphite-app graphite-app bot closed this Nov 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants