Skip to content

docs: add SAPUI5 framework integration guide#13806

Open
ilhan007 wants to merge 5 commits into
mainfrom
docs/sapui5-frameworks
Open

docs: add SAPUI5 framework integration guide#13806
ilhan007 wants to merge 5 commits into
mainfrom
docs/sapui5-frameworks

Conversation

@ilhan007

@ilhan007 ilhan007 commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new article under Frameworks → SAPUI5 documenting how to use UI5 Web Components inside a SAPUI5 (and OpenUI5) application.

See the preview (available until the PR is merged) here:
https://pr-13806--ui5-webcomponents-preview.netlify.app/docs/frameworks/SAPUI5/

The page covers:

  • Build once, reuse across frameworks — the strategy of authoring each UI element once as a Web Component and reusing it across React, Angular, Vue, SAPUI5, etc.
  • How to Integrate — step-by-step: scaffold a SAPUI5 app (generator-easy-ui5), install ui5-tooling-modules, install the @ui5/webcomponents-* packages, and use the components in XML views and controllers.
  • When to Use — guidance on reaching for Web Components for capabilities SAPUI5 doesn't ship, rather than replacing existing basic controls.
  • API Mapping — how Web Component properties, slots, events, and methods surface as SAPUI5 properties, aggregations, events, and methods.

Links out to the official SAPUI5 "Using Web Components" topic and the ui5-tsapp-webc showcase for full details.

Notes

  • Docs-only change; new file docs/3-frameworks/05-SAPUI5.md.

Add a new article under Frameworks describing how to use UI5 Web
Components inside a SAPUI5 (and OpenUI5) application: when to use them,
how to scaffold and integrate a project via ui5-tooling-modules, the
API mapping to SAPUI5 concepts, and the build-once-reuse-everywhere
strategy.
@ilhan007 ilhan007 temporarily deployed to netlify-preview July 9, 2026 12:44 — with GitHub Actions Inactive
@ilhan007 ilhan007 temporarily deployed to netlify-preview July 9, 2026 12:47 — with GitHub Actions Inactive
@sap-ui5-webcomponents-release

Copy link
Copy Markdown

Verified the integration guide end-to-end against a real scaffolded
app. Fixes found during verification:

- Step 1: 'npx generator-easy-ui5 project' fails ('could not determine
  executable to run') because generator-easy-ui5 is a Yeoman generator
  with no npx bin. Use 'npx -p yo -p generator-easy-ui5 yo easy-ui5
  project' instead (no global install needed).
- Drop the 'TypeScript' wording since the default template scaffolds a
  JS app; point to the UI5 CLI Getting Started guide.
- Use the canonical ui5-community/generator-easy-ui5 repo link.
- Relax the -rte note: missing yaml files are skipped, so the
  multi-file form is safe even with only ui5.yaml.
@ilhan007 ilhan007 temporarily deployed to netlify-preview July 9, 2026 13:16 — with GitHub Actions Inactive
Switch Step 1 to the officially documented 'npm install -g yo
generator-easy-ui5 && yo easy-ui5 project' form, matching the npm
readme and UI5 CLI Getting Started guide. Keep the npx one-liner as a
subtle inline fallback for those who prefer no global install.
@ilhan007 ilhan007 temporarily deployed to netlify-preview July 10, 2026 06:36 — with GitHub Actions Inactive
Move the framework-agnostic 'build once, reuse everywhere' idea to the
common Frameworks landing page, where it applies to all frameworks.
Trim the SAPUI5 article's intro to a single sentence about components
being delivered as Web Components to avoid duplication.
@ilhan007 ilhan007 temporarily deployed to netlify-preview July 10, 2026 07:30 — with GitHub Actions Inactive
@ilhan007 ilhan007 requested a review from nnaydenow July 10, 2026 07:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants