Skip to content

chore(core): nx plugin submission @hyperfrontend/features - #36555

Open
AndrewRedican wants to merge 1 commit into
nrwl:masterfrom
AndrewRedican:master
Open

chore(core): nx plugin submission @hyperfrontend/features#36555
AndrewRedican wants to merge 1 commit into
nrwl:masterfrom
AndrewRedican:master

Conversation

@AndrewRedican

Copy link
Copy Markdown
Contributor

Community Plugin Submission

@hyperfrontend/features

hyperfrontend is a vendor-agnostic micro-frontend runtime: independently deployed "features" run inside sandboxed iframes and talk to their host through a versioned cross-origin handshake with typed contracts, contract validation, lifecycle heartbeats, host-measured presentation modes (inline, dialog, popup), and capability-scoped permissions. @hyperfrontend/features is its SDK, CLI, and dev server — and it ships a first-class Nx plugin surface so an Nx workspace can scaffold, serve, and build these features natively.

The plugin is focused on technology and tooling (micro-frontend authoring) and provides generators and executors (no graph plugin):

Kind Name What it does
Generator init Declares @hyperfrontend/features in the workspace; wired to run automatically via nx add @hyperfrontend/features.
Generator feature Scaffolds a complete hyperfrontend feature project (contract, hostee entry, dev-server config) through the SDK.
Executor build Builds a feature's distributable shell package via the SDK.
Executor serve Runs the feature dev server for local development.

Manifests: generators.json · executors.json

Author: Andrew Redican, who also maintains the hyperfrontend monorepo the plugin is developed in. Current users: the live demos on the project site (hyperfrontend.dev) are real features built and embedded with this SDK/plugin; adoption beyond the author's projects is early-stage.

Links

Requirements checklist

  • Automated e2e tests in the repository. A dedicated e2e project (apps/package-e2e/features) tests the plugin the way a consumer experiences it: it creates a real Nx workspace with the official create-nx-workspace (pinned to Nx 22.7.8), installs the packed tarball exactly as nx add installs a plugin, then drives the workspace-local nx CLI and asserts on nx list, generator output, and executor behavior. See nx-plugin.spec.ts, nx-plugin-callbacks.spec.ts, and the harness support/nx-workspace.ts. The suite runs in CI as part of the e2e jobs in ci-pr.yml and ci-main.yml, alongside format, lint, typecheck, build, and unit-test-with-coverage gates.
  • repository.url in the plugin's package.json. The published manifest declares "repository": { "type": "git", "url": "git+https://github.com/AndrewRedican/hyperfrontend.git" } — verifiable via npm view @hyperfrontend/features repository.
  • ⚠️ @nx/devkit as a dependency. Deliberately not a runtime dependency: the plugin vendors devkit-compatible types and uses the consumer workspace's own @nx/devkit for formatting and installs when present, falling back to built-in equivalents. This keeps the package installable in non-Nx workspaces (it is also a standalone SDK/CLI) without forcing a devkit version onto consumers. Compatibility is not assumed — it is proven by the tarball e2e suite above against a real Nx workspace. Happy to add @nx/devkit as a peerDependency/dependency if the maintainers consider it a hard requirement for listing.

Registry entry

  {
    "name": "@hyperfrontend/features",
    "description": "SDK, CLI, and dev server for building, embedding, and orchestrating hyperfrontend micro-frontend features.",
    "url": "https://github.com/AndrewRedican/hyperfrontend/tree/main/libs/features"
  },

@AndrewRedican
AndrewRedican requested a review from a team as a code owner August 4, 2026 07:40
@netlify

netlify Bot commented Aug 4, 2026

Copy link
Copy Markdown

👷 Deploy request for nx-docs pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 993fa85

@netlify

netlify Bot commented Aug 4, 2026

Copy link
Copy Markdown

👷 Deploy request for nx-dev pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 993fa85

@nx-cloud

nx-cloud Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 993fa85


☁️ Nx Cloud last updated this comment at 2026-08-04 15:54:45 UTC

@AndrewRedican

Copy link
Copy Markdown
Contributor Author

@FrozenPandaz Any joy with accepting this as a community plugin or do you have any feedback for me?

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.

1 participant