SPFx deloyment docs error

[Neutrino-Sunset]

Target SharePoint environment

SharePoint Online

What SharePoint development model, framework, SDK or API is this about?

not applicable

Developer environment

Windows

What browser(s) / client(s) have you tested

• 💥 Internet Explorer
• 💥 Microsoft Edge
• 💥 Google Chrome
• 💥 FireFox
• 💥 Safari
• mobile (iOS/iPadOS)
• mobile (Android)
• not applicable
• other (enter in the "Additional environment details" area below)

Additional environment details

Describe the bug / error

This page here states to package your solution using

gulp package-solution

And then goes on to state

The JavaScript files, CSS, and other assets are packaged in the package when the --ship option is used. In this tutorial, however, we'll first test deployment and capabilities by hosting JavaScript files from localhost.

But the page goes on to deploy the package by uploading the sppkg to the server, which then fails to work. I presume this is because the assets are not packaged because if I then repackage the solution using

gulp package-solution --ship

...then it works.

The documentation is confusing, and doesn't work. The deployment is not hosted by localhost at all.

Steps to reproduce

Follow the documentation.
Observe a non-working web part.

Expected behavior

The documentation should describe a working process.

[Ashlesha-MSFT]

Hello @Neutrino-Sunset,
Thank you for bringing this issue to our attention. We will look into it and get back to you shortly.
If you don’t receive a reply within two working days, please use this escalation form to escalate.

[VesaJuvonen]

Hi @Neutrino-Sunset - this is a tutorial where we explicitly use localhost to test things - as explained in the documentation.

Quoting the text - "The JavaScript files, CSS, and other assets are packaged in the package when the --ship option is used. In this tutorial, however, we'll first test deployment and capabilities by hosting JavaScript files from localhost. Automated packaging and hosting option is explained in the next tutorial."

--ship indicates on how the code is served - is that served from the app catalog or is it served from the localhost as mentioned in the page.

We are happy to adjust things as needed - but would need a bit more input on what was confusing on the text. You can also suggest changes if you like as a PR.

[oakhl078-prog]

Thx.

…

On Tue, Nov 4, 2025 at 15:17 Vesa Juvonen ***@***.***> wrote: *VesaJuvonen* left a comment (SharePoint/sp-dev-docs#10463) <#10463 (comment)> Hi @Neutrino-Sunset <https://github.com/Neutrino-Sunset> - this is a tutorial where we explicitly use localhost to test things - as explained in the documentation. Quoting the text - "*The JavaScript files, CSS, and other assets are packaged in the package when the --ship option is used. In this tutorial, however, we'll first test deployment and capabilities by hosting JavaScript files from localhost. Automated packaging and hosting option is explained in the next tutorial.*" --ship indicates on how the code is served - is that served from the app catalog or is it served from the localhost as mentioned in the page. We are happy to adjust things as needed - but would need a bit more input on what was confusing on the text. You can also suggest changes if you like as a PR. — Reply to this email directly, view it on GitHub <#10463 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BYCM2IPYCXRYWR4DR5S7GNL33BVLHAVCNFSM6AAAAACLALKES2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTIOBUHAYDMOBTGY> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[Neutrino-Sunset]

I just didn't read it carefully enough.