Nexus Ecosystem

A modular microfrontend orchestration platform designed for scale, performance, and developer experience.

Core Architecture

Architecture

Shell & Fragments

The Nexus platform uses an iframe-based microfrontend pattern with Penpal for secure, typed communication between the host and modules.

Inter-App

Message Bus

Standardized events for cross-module communication using a centralized Window Messenger strategy to avoid global namespace pollution.

Development Workflow

Scaffolding a New Module

To integrate a new module into the Nexus ecosystem, follow these steps:

  1. Create a Vite-powered application in the /iframe directory.
  2. Update platform/src/config/menuItems.ts with the new route.
  3. Register the iframe URL in platform/src/App.tsx.
  4. Import shared styles from /shared/styles for visual consistency.

Design System

Tokens

Refer to shared/styles/tokens.css for HSL-based color variables, spacing, and transition speeds.

Components

Common utility classes like .glass-card and .stat-card are available in shared/styles/components.css.