Install instruction for PNPM should use pnpm not pnpx

[ADTC]

For this section (Installation) in Readme, the instruction calls for pnpx.

❌ However, I encountered error:

pnpx astro add @playform/compress
...
[config] Astro found issue(s) with your configuration:

! Invalid or outdated experimental feature.
  Check for incorrect spelling or outdated Astro version.
  See https://docs.astro.build/en/reference/experimental-flags/ for a list of all current experiments.

✅ Changing to pnpm worked:

pnpm astro add @playform/compress

> project@0.0.1 astro /path/to/project
> astro add \@playform/compress

✔ Resolving packages...

  Astro will run the following command:
  If you skip this step, you can always run it yourself later

 ╭─────────────────────────────────────╮
 │ pnpm add @playform/compress@^0.2.3  │
 ╰─────────────────────────────────────╯

✔ Continue? … yes
✔ Installing dependencies...

  Astro will make the following changes to your config file:

 ╭ astro.config.mjs ───────────────────────────────────────────────────────────────────────────╮
 | ...                                                                                         │
 │   experimental: {                                                                           │
 │     svg: true,                                                                              │
 │   },                                                                                        │
 │                                                                                             │
 │   integrations: [...                                                                        │
 │   ..., playformCompress()],                                                                 │
 │ });                                                                                         │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────╯

✔ Continue? … yes
  
   success  Added the following integration to your project:
  - @playform/compress

🤔 I think the Readme is mistaken, right?

[NikolaRHristov]

Hey @ADTC, thank you for the detailed report!

On pnpx vs pnpm: The README is a not mistaken, but it is worth an explanation. pnpx is an alias for pnpm dlx, which fetches a package from the registry and runs it without installing it as a local dependency. pnpm astro on the other hand runs the astro binary that is already present in your local node_modules/.bin. Both work for astro add because astro is a dependency of your project and is therefore available locally.

On which one to prefer: Using pnpm astro add @playform/compress is actually the safer choice, because it runs the exact version of astro you have installed locally. pnpx astro add and pnpm dlx astro add both fetch the latest version of astro from the registry at the time of invocation, which may differ from the version your project depends on. That mismatch is a likely source of the Invalid or outdated experimental feature error you encountered, since a newer astro CLI may a not recognize experimental flags that were valid in your installed version.

pnpx has also been deprecated since pnpm v6 in favor of pnpm dlx, and was removed as a standalone binary in pnpm v7. It survives today only as an alias.

I will update the README to use pnpm astro add @playform/compress as the recommended invocation for PNPM users, since it is the safest and most predictable option and respects the version of astro already in your project.