docs: add sharp cross-platform installation section

[DamianGlowala]

🔗 Linked issue

📚 Description

This might help a few Nuxt Image users in troubleshooting an error related to missing sharp binaries.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@nuxt/image@2142

commit: 6035301

[cloudflare-workers-and-pages]

Deploying nuxt-image with    Cloudflare Pages

Latest commit:	6035301
Status:	✅  Deploy successful!
Preview URL:	https://c98b7ebb.nuxt-image.pages.dev
Branch Preview URL:	https://docs-sharp-cross-platform-in.nuxt-image.pages.dev

View logs

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request updates the installation documentation file by introducing a new "Sharp Cross-Platform Installation" section that explains cross-OS binary issues and provides configuration examples for pnpm, yarn, and npm package managers. The troubleshooting section is reorganized by consolidating separate code blocks for multiple package managers into unified blocks, and adds an explicit step to run npx nuxt upgrade --force. Minor indentation and spacing adjustments are made throughout for improved readability.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title directly and clearly matches the main change: adding a documentation section about sharp cross-platform installation, which is the primary focus of the changeset.
Description check	✅ Passed	The description is related to the changeset, explaining that the addition helps users troubleshoot sharp binary errors, which aligns with the new documentation section being added.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/sharp-cross-platform-installation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (1)

docs/content/1.get-started/1.installation.md (1)

93-93: Consider adding example reinstall commands.

While the instruction is clear, you might consider adding specific examples for each package manager (e.g., pnpm install, yarn install, npm install) to make it even more actionable for users.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/content/1.get-started/1.installation.md` at line 93, Update the sentence
"After updating the configuration, reinstall dependencies to download the
additional platform binaries." to include explicit example commands for common
package managers (e.g., add "pnpm install", "yarn install", and "npm install")
so users have actionable reinstall steps; keep the phrasing concise and place
the examples inline or on the next line for clarity.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/content/1.get-started/1.installation.md`:
- Around line 56-58: Change the fenced code block that currently starts with ```
and contains the text "[500] [IPX_ERROR] Could not load the \"sharp\" module
using the linux-x64 runtime" to include a language identifier (e.g., ```text) so
the block becomes ```text ... ```; update the markdown in
docs/content/1.get-started/1.installation.md to use the language-tagged fence
for proper syntax highlighting and to satisfy the linter.
- Around line 64-89: The examples for package manager architecture config are
missing the libc dimension and additional OS entries; update the pnpm JSON under
the "pnpm" -> "supportedArchitectures" object to include os:
["current","darwin","linux","win32"], cpu: ["current","x64","arm64"] and libc:
["glibc","musl"]; update the yarn example's supportedArchitectures keys
("os","cpu","libc") to the same lists; and replace the npm examples to use the
--libc flag for each OS/CPU/libc combo (e.g., include --libc=glibc and
--libc=musl for x64 and arm64 on linux) so musl/glibc targets (Alpine) are
covered.

---

Nitpick comments:
In `@docs/content/1.get-started/1.installation.md`:
- Line 93: Update the sentence "After updating the configuration, reinstall
dependencies to download the additional platform binaries." to include explicit
example commands for common package managers (e.g., add "pnpm install", "yarn
install", and "npm install") so users have actionable reinstall steps; keep the
phrasing concise and place the examples inline or on the next line for clarity.

---

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 510f2e1 and 6035301.

📒 Files selected for processing (1)

• docs/content/1.get-started/1.installation.md