Skip to content

feat: add docs for paas native cfe support#2350

Merged
Micha Hobert (Isengo1989) merged 6 commits into
mainfrom
paas-native-cfe-support
Jul 9, 2026
Merged

feat: add docs for paas native cfe support#2350
Micha Hobert (Isengo1989) merged 6 commits into
mainfrom
paas-native-cfe-support

Conversation

@tombojer

Copy link
Copy Markdown
Contributor

Summary

Related links

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
  • I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
  • Any required dependent changes in downstream modules have already been merged and published.
  • This pull request is ready for review.

Notes

@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Jun 24, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: 88b8690
Preview: https://developer-documentation-d6ekese8u-shopware-frontends.vercel.app
Workflow run: #4437

@renaudhager

Copy link
Copy Markdown
Member

A few missing point:

  • We support and encourage ISR (Incremental Static Regeneration), which means some header configuration is required. On page that needs to be cached at the CDN level the following header is required:
"Surrogate-Control": "max-age=86400, stale-while-revalidate=86400",

Here is an example.

For routes that should not be cached:

"Cache-Control": "no-cache, no-store, must-revalidate"
"Surrogate-Control": "no-store"

Here is an example.

  • We do a full cache purge after each deployment.

@tombojer

Copy link
Copy Markdown
Contributor Author

Renaud Hager (@renaudhager) I added a section based on your feedback.

Comment thread products/paas/shopware/composable-frontends/index.md
@tombojer Tom Bojer (tombojer) force-pushed the paas-native-cfe-support branch 2 times, most recently from 55a27e9 to 8e99ab6 Compare June 25, 2026 06:53
@tombojer Tom Bojer (tombojer) marked this pull request as ready for review July 8, 2026 12:33
Copilot AI review requested due to automatic review settings July 8, 2026 12:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds Shopware PaaS Native documentation for deploying Composable Frontends (CFE), and updates the PaaS FAQ accordingly, including spellcheck wordlist adjustments for newly introduced terminology.

Changes:

  • Update the PaaS FAQ to clarify that general custom apps aren’t supported, while composable frontends are supported with a Node.js runtime.
  • Add a new “Composable Frontends” documentation page covering application.yaml setup, runtime requirements, deployment, Fastly, and ISR caching.
  • Extend .wordlist.txt with new terms used by the added documentation.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
products/paas/shopware/faq.md Updates FAQ answer to point readers to composable frontend support and the new documentation page.
products/paas/shopware/composable-frontends/index.md New documentation page detailing how to run composable frontends on PaaS Native (config, runtime, deploy, CDN/cache).
.wordlist.txt Adds terms needed for spellcheck to accept new documentation wording.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread products/paas/shopware/composable-frontends/index.md
Comment thread products/paas/shopware/composable-frontends/index.md Outdated
Comment thread products/paas/shopware/composable-frontends/index.md Outdated
Comment thread products/paas/shopware/composable-frontends/index.md
Comment thread products/paas/shopware/faq.md
@Isengo1989

Copy link
Copy Markdown
Contributor

Please check the comments by Copilot , if ready and solved assign me or Su (@sushmangupta) to review.

Copilot AI commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Please check the comments by Copilot , if ready and solved assign me or Su (@sushmangupta) to review.

Addressed in ae64123. The remaining actionable Copilot feedback is resolved, and the updated docs passed the repository spellcheck. This is ready for review by you or Su (@sushmangupta).

Comment thread products/paas/shopware/composable-frontends/index.md

@Isengo1989 Micha Hobert (Isengo1989) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thx for the PR Tom Bojer (@tombojer) 👍

Comment thread products/paas/shopware/composable-frontends/index.md
@Isengo1989 Micha Hobert (Isengo1989) merged commit 9f60e5b into main Jul 9, 2026
9 checks passed
@Isengo1989 Micha Hobert (Isengo1989) deleted the paas-native-cfe-support branch July 9, 2026 13:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants