Skip to content

JSX Article Publishing PoC: Put a React Visual Article Under Blog

For / Key Points

This is for readers who want to publish a React visual article without breaking existing blog URLs, tags, or search. The Markdown page stays as the entry point, while the article experience is rendered from the JSX artifact.

Text Summary

This PoC verifies the publishing workflow for placing JSX/React visual articles under the SmartScope blog.

  • The reader-facing URL is still created by docs/blog/<slug>.md.
  • JSX implementation lives under apps/blog/<slug>/.
  • CI adds the JSX artifact under site/apps/blog/<slug>/ after the MkDocs build.

Open the JSX artifact directly if you want the full viewport.

Summary

JSX articles do not need to replace Markdown routing immediately. The Markdown file remains the public entry point, while the visual body moves to JSX. This keeps blog listings, tags, search, and the GitHub Pages publishing flow intact while allowing React-based articles.