feat: add intro to web platform blog #248

PupilTong · 2025-07-10T09:14:39Z

add en/zh blog about web platform
update docs about the lynx-view element for web platform

Change-Id: I07af86b21f2da1a477404a73ccfa3f5888d32708

netlify · 2025-07-10T09:14:44Z

✅ Deploy Preview for lynx-doc ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`eb1ae27`
🔍 Latest deploy log	https://app.netlify.com/projects/lynx-doc/deploys/68ff189994f0dd000870e201
😎 Deploy Preview	https://deploy-preview-248--lynx-doc.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot

Pull Request Overview

This PR introduces a new blog post ("Intro to the Lynx's Web Platform") in both English and Chinese, updates the author list, and enriches the web integration guide with <lynx-view> documentation.

Added two new authors (haoyang.wang, aihao) for blog avatars
Updated both zh/en integration guides: renamed sections, added core dependency, and documented <lynx-view> properties/events/methods
Added the new blog files and updated blog indexes and metadata

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/components/blog-avatar/authors.json	Add two new author entries
docs/zh/guide/start/fragments/web/integrating-lynx-with-web.mdx	Rename section, fix link, add `<lynx-view>` docs
docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx	Rename sections, grammar fixes, add `<lynx-view>`
docs/zh/blog/lynx-intro-to-web-platform.mdx	Add new Chinese blog post
docs/en/blog/lynx-intro-to-web-platform.mdx	Add new English blog post
docs/zh/blog/index.mdx	Register new blog in Chinese index
docs/en/blog/index.mdx	Register new blog in English index
docs/en/blog/_meta.json	Add new blog slug to metadata array
cspell.json	Add new author names for spell-check

Comments suppressed due to low confidence (3)

docs/zh/guide/start/fragments/web/integrating-lynx-with-web.mdx:14

The link to '快速开始' is missing a leading slash; it should be (/guide/start/quick-start) for consistency with other guides.

我们假设已经阅读并按照[快速开始](guide/start/quick-start)创建了一个 Lynx 项目。

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx:53

Grammar: change 'a existing' to 'an existing'.

## 2. Integrate with a existing Web App

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx:57

[nitpick] This sentence is unclear—consider rewriting to 'Configuration may vary for different bundlers.'

Configure may various for different bundlers

Sherry-hue · 2025-07-11T06:29:22Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+```
+
+#### updateGlobalProps
+


See Update GlobalProps

Sherry-hue · 2025-07-11T06:32:16Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+// ...existing code...
+
+### `<lynx-view>` properties


Can this be a standalone article? This article is included under integrate-with-existing-apps and is only for the quick-start

Sherry-hue · 2025-07-11T06:36:21Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+Required. Setting this property starts the rendering logic. Other properties must be set before `url` to take effect.
+
+#### globalProps


add https://lynxjs.org/api/lynx-api/lynx/lynx-global-props.html

Sherry-hue · 2025-07-11T06:40:53Z

docs/zh/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### updateData
+
+See [Update Data](https://lynx.bytedance.net/api/lynx-native-api/lynx-view/update-data.html)


It is better to use a relative path, otherwise it will point to the English document

Sherry-hue · 2025-07-11T06:41:30Z

docs/zh/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### Uncaught SecurityError: Failed to construct 'Worker': Script at '...' cannot be accessed from origin '...'.
+
+This error usually occurs when the worker script is not served from the same origin as the main page. Ensure that your worker script is accessible from the same domain, protocol, and port as your web application.


Sherry-hue · 2025-07-11T06:44:46Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### overrideLynxTagToHTMLTagMap
+
+Allows overriding the mapping from Lynx tags to HTML tags.


It needs to be explained that it must be a custom element

Sherry-hue · 2025-07-11T06:46:56Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### nativeModulesMap
+
+Custom NativeModules.


add intro: https://lynxjs.org/guide/use-native-modules.html

Sherry-hue · 2025-07-11T06:50:42Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### url
+
+Required. Setting this property starts the rendering logic. Other properties must be set before `url` to take effect.


No introduction to the meaning of url? It is the remote file path of Lynx Web Platform build artifact

Sherry-hue · 2025-07-11T06:53:02Z

docs/en/guide/start/fragments/web/integrating-lynx-with-web.mdx

+
+#### customTemplateLoader
+
+By default, the JSON file corresponding to the URL is loaded using `fetch` with GET. Assigning this property allows for a custom loading method.


It is better to use the build artifact instead of the JSON file

* add en/zh blog about web platform * update docs about the lynx-view element for web platform Change-Id: I07af86b21f2da1a477404a73ccfa3f5888d32708

Change-Id: Icf1fa0b3b7e462d72904027c0d5fe8b15b645f74

Signed-off-by: Haoyang Wang <[email protected]>

PupilTong · 2025-10-27T07:01:11Z

/cherry-pick release/3.5, release/3.4

github-actions · 2025-10-27T07:01:23Z

✅ Cherry-pick operation is running! Check the progress in this action:

Workflow Run

github-actions · 2025-10-27T07:01:36Z

❌ Cherry-pick operation did not create any PRs, please check if the target branches exist or if there are conflicts.

PupilTong force-pushed the p/hw/improve-web-doc branch from 3754296 to 6547ff6 Compare July 10, 2025 09:18

PupilTong requested a review from Copilot July 10, 2025 09:18

Copilot AI reviewed Jul 10, 2025

View reviewed changes

PupilTong added this to Lynx for Web Jul 10, 2025

PupilTong moved this to In Progress in Lynx for Web Jul 10, 2025

Sherry-hue reviewed Jul 11, 2025

View reviewed changes

PupilTong force-pushed the p/hw/improve-web-doc branch 2 times, most recently from 18b8afd to e831f5d Compare July 14, 2025 03:45

PupilTong force-pushed the p/hw/improve-web-doc branch from 00fdad8 to f8b566d Compare September 26, 2025 18:27

PupilTong added 5 commits October 27, 2025 14:59

feat: add intro to web platform blog

061bbac

* add en/zh blog about web platform * update docs about the lynx-view element for web platform Change-Id: I07af86b21f2da1a477404a73ccfa3f5888d32708

add my social media link

043d3af

Change-Id: Icf1fa0b3b7e462d72904027c0d5fe8b15b645f74

update

64e97a5

chn gpt-5

72fad4c

fix

d5b23d5

PupilTong force-pushed the p/hw/improve-web-doc branch from ab517bf to d5b23d5 Compare October 27, 2025 06:59

Merge branch 'main' into p/hw/improve-web-doc

eb1ae27

Signed-off-by: Haoyang Wang <[email protected]>

Copilot AI mentioned this pull request Nov 12, 2025

Comprehensive review of 22 open PRs with prioritized recommendations #528

Draft


		Required. Setting this property starts the rendering logic. Other properties must be set before `url` to take effect.

		#### globalProps


		#### updateData

		See [Update Data](https://lynx.bytedance.net/api/lynx-native-api/lynx-view/update-data.html)


		#### Uncaught SecurityError: Failed to construct 'Worker': Script at '...' cannot be accessed from origin '...'.

		This error usually occurs when the worker script is not served from the same origin as the main page. Ensure that your worker script is accessible from the same domain, protocol, and port as your web application.


		#### overrideLynxTagToHTMLTagMap

		Allows overriding the mapping from Lynx tags to HTML tags.


		#### url

		Required. Setting this property starts the rendering logic. Other properties must be set before `url` to take effect.


		#### customTemplateLoader

		By default, the JSON file corresponding to the URL is loaded using `fetch` with GET. Assigning this property allows for a custom loading method.

feat: add intro to web platform blog #248

Are you sure you want to change the base?

feat: add intro to web platform blog #248

Uh oh!

Conversation

PupilTong commented Jul 10, 2025

Uh oh!

netlify bot commented Jul 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for lynx-doc ready!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

PupilTong commented Oct 27, 2025

Uh oh!

github-actions bot commented Oct 27, 2025

Uh oh!

github-actions bot commented Oct 27, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify bot commented Jul 10, 2025 •

edited

Loading