diff --git a/packages/php-wasm/web/README.md b/packages/php-wasm/web/README.md
index 02f37d0d7f..33d40fe492 100644
--- a/packages/php-wasm/web/README.md
+++ b/packages/php-wasm/web/README.md
@@ -6,18 +6,15 @@ Here's how to use it:
 
 ```js
 import { PHP } from '@php-wasm/web';
+import { loadWebRuntime } from '@php-wasm/web'
 
-// PHP.load() calls import('php.wasm') internally
+// loadWebRuntime() calls import('php.wasm') and import('icudt74l.dat') internally.
 // Your bundler must resolve import('php.wasm') as a static file URL.
 // If you use Webpack, you can use the file-loader to do so.
-const php = await PHP.load('8.0', {
-	requestHandler: {
-		documentRoot: '/www',
-	},
-});
+const php = new PHP(await loadWebRuntime('8.3'))
 
 // Create and run a script directly
-php.mkdirTree('/www');
+php.mkdir('/www');
 php.writeFile('/www/index.php', `<?php echo "Hello " . $_POST['name']; ?>`);
 await php.run({ scriptPath: './index.php' });
 
@@ -30,6 +27,53 @@ const response = await php.request({
 console.log(response.text);
 ```
 
+## Usage with bundlers
+
+If you use `@php-wasm/web` with a bundler such as Vite, you may see the following errors:
+
+```
+01:31:50 [vite] (client) error while updating dependencies:
+Error: Error during dependency optimization:
+
+✘ [ERROR] No loader is configured for ".dat" files: app/node_modules/@php-wasm/web/shared/icudt74l.dat
+
+    app/node_modules/@php-wasm/web/shared/icudt74l.js:1:25:
+      1 │ import dataFilename from './icudt74l.dat';
+```
+
+The `@php-wasm/web` package imports a few non-JavaScript assets file using the import syntax. This ensures
+all the required dependencies may be tracked statically, but it creates an inconvenience for apps relying
+on bundlers.
+
+To resolve that error, you'll need to configure your bundler to resolve the import above to the URL
+of the `icudt74l.dat` in your app, e.g. `https://playground.wordpress.net/assets/icudt74l.dat`.
+
+In Vite, you can use the following options to support importing all the required assets types:
+
+```js
+export default defineConfig({
+	assetsInclude: [/\.dat$/, /\.wasm$/, /\.so$/, /\.la$/],
+	optimizeDeps: {
+		esbuildOptions: {
+			loader: {
+				'.dat': 'file',
+				'.wasm': 'file',
+				'.so': 'file',
+				'.la': 'file',
+			},
+		},
+	},
+	build: {
+		// outDir is required with the 'file' loader
+		outDir: path.resolve(workspaceRoot, 'dist'),
+	}
+});
+```
+
+Other bundlers will typically have analogous options or plugins. If you create a working configuration for
+WebPack, esbuild, or another bundler, feel free to propose a new configuration example for this README at
+https://github.com/WordPress/wordpress-playground/edit/trunk/packages/php-wasm/web/README.md
+
 ## Attribution
 
 `@php-wasm/web` started as a fork of the original PHP to WebAssembly build published by Oraoto in https://github.com/oraoto/pib and modified by Sean Morris in https://github.com/seanmorris/php-wasm.