@geenius/monitoring

Monitoring primitives, dashboards, alert surfaces, and Convex helpers for the Geenius ecosystem.

Installation

pnpm add @geenius/monitoring

Install the framework packages you plan to use alongside the package:

pnpm add react react-dom
pnpm add solid-js

Imports

import {
  calcSystemOverview,
  configureMonitoring,
  formatMetricValue,
} from '@geenius/monitoring'

import {
  HEALTH_CONFIG,
  MonitoringConfigurationError,
} from '@geenius/monitoring/shared'

import { mutations, queries, schema } from '@geenius/monitoring/convex'

import {
  AlertFeed,
  MonitoringDashboardPage,
  useMonitoring,
} from '@geenius/monitoring/react'

import '@geenius/monitoring/react-css/styles.css'
import {
  AlertFeed as CssAlertFeed,
  MonitoringDashboardPage as CssMonitoringDashboardPage,
  useMonitoring as useMonitoringCss,
} from '@geenius/monitoring/react-css'

import {
  MonitoringDashboardPage as SolidMonitoringDashboardPage,
  createMonitoring,
} from '@geenius/monitoring/solidjs'

import '@geenius/monitoring/solidjs-css/styles.css'
import {
  MonitoringDashboardPage as SolidCssMonitoringDashboardPage,
  createMonitoring as createMonitoringCss,
} from '@geenius/monitoring/solidjs-css'

Usage

import { MonitoringDashboardPage } from '@geenius/monitoring/react'

export function MonitoringRoute() {
  return (
    <MonitoringDashboardPage
      services={services}
      alerts={alerts}
      errors={errors}
      onAckAlert={(alertId) => acknowledgeAlert(alertId)}
      onResolveAlert={(alertId) => resolveAlert(alertId)}
    />
  )
}

Package Surface

• @geenius/monitoring: shared monitoring helpers, config, types, formatting utilities, and default localization/SEO helpers
• @geenius/monitoring/shared: explicit alias for the shared contract, including translateMonitoring(), pluralizeMonitoring(), and buildMonitoringSeoMeta()
• @geenius/monitoring/react: Tailwind React hooks, components, and pages
• @geenius/monitoring/react-css: vanilla-CSS React hooks, components, and pages
• @geenius/monitoring/solidjs: Tailwind SolidJS primitives, components, and pages
• @geenius/monitoring/solidjs-css: vanilla-CSS SolidJS primitives, components, and pages
• @geenius/monitoring/convex: Convex schema, queries, and mutations

Storybook

The repository includes two comparison Storybook apps so maintainers can review Tailwind and vanilla-CSS variants side by side for both framework families.

pnpm --filter ./apps/storybook-react dev
pnpm --filter ./apps/storybook-solidjs dev

For production verification, build the same apps with:

pnpm --filter ./apps/storybook-react build
pnpm --filter ./apps/storybook-solidjs build

Both apps use the shared @geenius/storybook shell and render the React, React-CSS, SolidJS, and SolidJS-CSS exports against the same fixture set.

License

Commercial package. See LICENSE for the Geenius commercial terms.