@geenius/tools

Standalone Geenius tooling families for shared utilities, environment validation, typed errors, logging, performance instrumentation, developer overlays, and Convex-safe helpers.

Installation

pnpm add @geenius/tools

Export Map

import { cn, retry, timeout } from '@geenius/tools'
import { cn, parseDate, slugify } from '@geenius/tools/shared'
import { validateEnv, getEnv } from '@geenius/tools/env'
import { GeeniusError, ValidationError } from '@geenius/tools/errors'
import { ErrorBoundary, useErrorHandler } from '@geenius/tools/errors/react'
import { ErrorBoundary as CssErrorBoundary } from '@geenius/tools/errors/react-css'
import { createErrorHandler } from '@geenius/tools/errors/solidjs'
import { createErrorHandler as createCssErrorHandler } from '@geenius/tools/errors/solidjs-css'
import { createLogger, metricsStore } from '@geenius/tools/logger'
import { usePerformanceLog } from '@geenius/tools/logger/react'
import { createPerformanceLog } from '@geenius/tools/logger/solidjs'
import { PerfTracker } from '@geenius/tools/perf'
import { PerformanceDashboard } from '@geenius/tools/perf/react'
import { PerformanceDashboard as CssPerformanceDashboard } from '@geenius/tools/perf/react-css'
import { createPerformanceMetrics } from '@geenius/tools/perf/solidjs'
import { createPerformanceMetrics as createCssPerformanceMetrics } from '@geenius/tools/perf/solidjs-css'
import { FeatureFlagManager } from '@geenius/tools/devtools'
import { DevToolbar } from '@geenius/tools/devtools/react'
import { DevToolbar as CssDevToolbar } from '@geenius/tools/devtools/react-css'
import { DevToolbar as SolidDevToolbar } from '@geenius/tools/devtools/solidjs'
import { DevToolbar as SolidCssDevToolbar } from '@geenius/tools/devtools/solidjs-css'
import { auditLogFields, writeAudit } from '@geenius/tools/convex'

Basic Usage

import { validateEnv } from '@geenius/tools/env'
import { createLogger, LogLevel } from '@geenius/tools/logger'
import { GeeniusError, ErrorCode } from '@geenius/tools/errors'

const env = validateEnv({
  API_URL: z.string().url(),
})

const logger = createLogger({ level: LogLevel.INFO })

try {
  logger.info('Booting service', { apiUrl: env.API_URL })
} catch (error) {
  throw new GeeniusError({
    code: ErrorCode.INTERNAL_ERROR,
    message: 'Application boot failed',
    cause: error,
  })
}

Storybook Review Apps

Each UI-facing tooling family ships paired React and SolidJS Storybook review apps that use the shared @geenius/storybook shell bridge and render Tailwind and Vanilla CSS variants side by side for parity review.

• Errors Storybook apps
• Perf Storybook apps
• Devtools Storybook apps

Package Contract

• Root exports expose the shared @geenius/tools contract plus explicit family leaf exports.
• UI-facing families (errors, perf, devtools) maintain parallel React, React-CSS, SolidJS, and SolidJS-CSS surfaces.
• Nested Storybook apps are development-only and stay outside the root build, lint, test, and publish flows.
• Versioning and publishing are managed through Changesets.

See PACKAGE_GOLDEN_STANDARD.md for the full repository standard.

License

FSL-1.1-Apache-2.0 for the free tier, with a proprietary commercial license available for paid usage.