Skip to content

Conversation

@josephfusco
Copy link
Member

@josephfusco josephfusco commented Nov 20, 2025

This pull request updates the Faust.js tutorial and its example project to use @wordpress/env (wp-env) and Docker for local WordPress development, replacing the previous @wp-now/wp-now setup. It also standardizes the WordPress local development port to 8888 throughout the documentation and configuration files, and removes the now-unnecessary blueprint file. These changes streamline the setup process, improve compatibility, and make the tutorial easier to follow.

Local development environment migration:

  • The tutorial now instructs users to install Docker Desktop and uses @wordpress/env (wp-env) for managing the local WordPress environment, replacing the previous @wp-now/wp-now approach. The wp-dev script in package.json is updated to use wp-env start, and @wordpress/env is added as a dev dependency. [1] [2] [3] [4]
  • A new .wp-env.json configuration file is added to specify plugins, port (8888), and debugging settings for the local WordPress environment.
  • The obsolete faust-tutorial-blueprint.json file is removed from the example project.

Documentation and configuration updates:

  • All documentation and example configuration files are updated to use port 8888 instead of 8881 for WordPress URLs, ensuring consistency and preventing port conflicts. [1] [2] [3] [4] [5] [6]
  • The tutorial provides updated instructions for accessing the WordPress admin area, including default credentials, and clarifies where to find required plugins.

These changes modernize the tutorial's local development workflow and make the setup process more reliable for new users.

Replaces wp-now and blueprint setup with @wordpress/env and Docker for local WordPress development in the Faust.js tutorial. Updates documentation, environment example, and removes faust-tutorial-blueprint.json in favor of .wp-env.json. Changes all references and ports from 8881 to 8888 for consistency.
@josephfusco josephfusco requested a review from a team as a code owner November 20, 2025 19:39
@changeset-bot
Copy link

changeset-bot bot commented Nov 20, 2025

⚠️ No Changeset found

Latest commit: 77bcfc4

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

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request modernizes the Faust.js tutorial's local WordPress development setup by migrating from wp-now to @wordpress/env (wp-env) with Docker, and standardizes the WordPress port to 8888 throughout all documentation and configuration files.

Key Changes:

  • Replaced wp-now with @wordpress/env for Docker-based local WordPress development
  • Standardized WordPress port from 8881 to 8888 across all configuration files and documentation
  • Introduced .wp-env.json to manage required plugins and WordPress configuration settings

Reviewed Changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
examples/next/tutorial/package.json Updated wp-dev script to use wp-env start and added @wordpress/env as a devDependency
examples/next/tutorial/faust-tutorial-blueprint.json Removed obsolete blueprint file used by wp-now
examples/next/tutorial/.wp-env.json Added wp-env configuration specifying required plugins, port 8888, and debug settings
examples/next/tutorial/.env.local.example Updated WordPress URL to use port 8888
docs/tutorial/learn-faust/index.md Updated tutorial instructions to reference Docker Desktop, wp-env setup steps, and port 8888 throughout
Files not reviewed (1)
  • examples/next/tutorial/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@josephfusco josephfusco linked an issue Nov 20, 2025 that may be closed by this pull request
@github-actions
Copy link
Contributor

github-actions bot commented Nov 20, 2025

📦 Next.js Bundle Analysis for @faustwp/getting-started-example

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@josephfusco josephfusco requested a review from Copilot November 20, 2025 19:57
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

Copilot reviewed 28 out of 36 changed files in this pull request and generated 3 comments.

Files not reviewed (1)
  • examples/next/tutorial/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@josephfusco josephfusco requested a review from Copilot November 24, 2025 15:59
@josephfusco josephfusco changed the title Switch tutorial to use wp-env and Docker chore: Switch tutorial to use wp-env and Docker Nov 24, 2025
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 6 changed files in this pull request and generated no new comments.

Files not reviewed (1)
  • examples/next/tutorial/package-lock.json: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@josephfusco josephfusco merged commit f2bd740 into canary Nov 25, 2025
7 of 19 checks passed
@josephfusco josephfusco deleted the issue-2211-fix branch November 25, 2025 14:56
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.

Update Faust Tutorial

3 participants