Logo

Command Palette

Search for a command to run...

Portal Embeds Guide

Embed Zhu Li portal surfaces in external sites using the hosted iframe URLs from your workspace.

Pick a Surface

Each workspace exposes embed routes by portalId:

  • Overview: /embed/[portalId]
  • Issues: /embed/[portalId]/issues
  • Features: /embed/[portalId]/features
  • Changelog: /embed/[portalId]/changelog
  • Docs: /embed/[portalId]/docs

HTML Snippet Example

Use this for static sites and CMS blocks:

<iframe
  src="https://zhuli.aevr.space/embed/your-portal-id/issues"
  style="width:100%;min-height:720px;border:0;"
  loading="lazy"
></iframe>

React JSX Snippet Example

Use this for React and Next.js components:

<iframe
  src="https://zhuli.aevr.space/embed/your-portal-id/issues"
  style={{ width: "100%", minHeight: "720px", border: 0 }}
  loading="lazy"
/>

Best Practices

  • Set a minimum height to reduce internal scrolling.
  • Keep loading="lazy" for performance.
  • Use full-width iframes inside responsive containers.
  • Prefer section-specific embeds for focused pages (for example, changelog-only pages).

How to Copy Quickly

From the Portal Hosting dashboard:

  1. Choose HTML or React JSX under Iframe snippets.
  2. Select the surface tab (overview/issues/features/changelog/docs).
  3. Use Copy iframe or Copy all snippets.

Security and Access

Embedded portal pages are public-facing by design. Do not put private internal data in public portal content.

Related Guides