docs: Refactor installation and CDN hosting documentation [skip chromatic] by mariohamann · Pull Request #3239 · solid-design-system/solid

mariohamann · 2026-08-06T18:26:04Z

Description:

This pull request updates the documentation to clarify that Solid Design System does not provide a public CDN and to guide users toward self-hosting or npm-based installation. All references to a Solid-managed CDN have been removed or replaced with instructions for using your own CDN or npm. The documentation now includes a new, comprehensive "CDN Hosting" guide and consolidates installation instructions for clarity.

Closes#3217

Definition of Reviewable:

Documentation is created/updated
Migration Guide is created/updated

relevant tickets are linked

- Simplified multi-theming instructions in migration guide. - Updated installation documentation for components, styles, and tokens to emphasize npm usage. - Removed CDN installation examples and consolidated CDN hosting information into a new dedicated document. - Improved clarity on the differences between `cdn/` and `dist/` file structures. - Added a new section on CDN hosting responsibilities and available artifacts. - Enhanced usage examples for theme imports and OS-level preference handling.

changeset-bot · 2026-08-06T18:26:08Z

🦋 Changeset detected

Latest commit: 0213351

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
@solid-design-system/components	Patch
@solid-design-system/docs	Patch
@solid-design-system/mcp	Patch
@solid-design-system/styles	Patch
@solid-design-system/tokens	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

martascorreia · 2026-08-07T15:07:01Z

Is the "Standard Release from Main Branch" section in the general CONTRIBUTING.md page still accurate?
https://solid-design-system.fe.union-investment.de/docs/?path=/docs/docs-general-contributing--docs

Co-authored-by: Marta Correia <48736172+martascorreia@users.noreply.github.com>

github-actions · 2026-08-14T13:15:01Z

🚀 Storybook has been deployed for branch remove-cdns-from-docs

View Storybook

mariohamann added 4 commits August 3, 2026 13:02

Merge branch 'next' into remove-cdns-from-docs
2b343a3

Merge branch 'next' into remove-cdns-from-docs
1cbd206

add jsdeliver docs
44ed7fa

github-project-automationBot added this to Solid Design System Project Board Aug 6, 2026

github-project-automationBot moved this to 📋 Backlog in Solid Design System Project Board Aug 6, 2026

mariohamann changed the title ~~Refactor installation and CDN hosting documentation~~Refactor installation and CDN hosting documentation [skip chromatic]Aug 6, 2026

mariohamann assigned martascorreia, rahulsuvarna18, balco0110 and auroraVasconcelos Aug 7, 2026

mariohamann added 2 commits August 7, 2026 14:42

Merge branch 'next' into remove-cdns-from-docs
8c96731

add migration guide
34f5454

mariohamann had a problem deploying to github-pages August 7, 2026 12:54 — with GitHub Actions Failure

mariohamann had a problem deploying to github-pages August 7, 2026 13:38 — with GitHub Actions Failure

mariohamann had a problem deploying to github-pages August 7, 2026 13:44 — with GitHub Actions Failure

martascorreia reviewed Aug 7, 2026
View reviewed changes

Comment threadpackages/docs/src/stories/docs/general/07-CDN Hosting.mdx Outdated

Apply suggestion from@martascorreia
61fdca5
Co-authored-by: Marta Correia <48736172+martascorreia@users.noreply.github.com>

balco0110 had a problem deploying to github-pages August 13, 2026 08:14 — with GitHub Actions Failure

balco0110 changed the title ~~Refactor installation and CDN hosting documentation [skip chromatic]~~docs: Refactor installation and CDN hosting documentation [skip chromatic]Aug 13, 2026

Merge branch 'next' into remove-cdns-from-docs
6303ec1

balco0110 had a problem deploying to github-pages August 14, 2026 08:47 — with GitHub Actions Failure

Merge branch 'next' into remove-cdns-from-docs
2be96a0

balco0110 had a problem deploying to github-pages August 14, 2026 11:06 — with GitHub Actions Failure

chore: fixed and updated the docs
0bd2351

balco0110 temporarily deployed to github-pages August 14, 2026 13:11 — with GitHub Actions Inactive

balco0110 moved this from 📋 Backlog to 👀 In review in Solid Design System Project Board Aug 14, 2026