v0.1.0 Release Notes¶

Release Date: 2026-04-27

Highlights¶

Initial release of CoreForge Web component library monorepo
ProductGraph telemetry integration with session management and OTel compliance
Multi-tenant primitives with organization context and tenant isolation

Overview¶

CoreForge Web is a React component library monorepo designed for building multi-tenant SaaS applications. It provides a complete set of primitives for authentication, multi-tenancy, telemetry, and UI components.

Packages¶

@coreforge/auth¶

Authentication primitives supporting JWT, OAuth 2.0, and OIDC:

AuthProvider - Authentication context provider
useAuth - Hook for accessing auth state and methods
Token management with refresh handling
Protected route utilities

@coreforge/tenant¶

Multi-tenant primitives for organization-scoped applications:

TenantProvider - Organization context provider
useOrganization - Hook for accessing current organization
Tenant switching and isolation patterns

@coreforge/api-client¶

Typed HTTP client utilities:

Request/response interceptors
Automatic token injection
Error handling and retry logic
TypeScript-first API design

@coreforge/telemetry¶

Telemetry, error tracking, and performance monitoring:

TelemetryProvider - Telemetry context with adapter support
ErrorBoundary - React error boundary with telemetry integration
Core hooks: usePageView, useActionTracker, useWebVitals
ProductGraph integration with full adapter and specialized hooks

@coreforge/shell¶

Application shell layout components:

AppShell - Main layout with sidebar, header, and content areas
Responsive design with mobile navigation
Theme-aware styling

@coreforge/pages¶

Default page components:

NotFoundPage - 404 error page
ErrorPage - 500 error page
LoadingPage - Loading state page

@coreforge/design-tokens¶

CSS custom properties for consistent styling:

Color tokens (light/dark themes)
Typography scale
Spacing system
Shadow definitions

ProductGraph Integration¶

This release includes comprehensive ProductGraph integration in @coreforge/telemetry:

ProductGraphAdapter¶

import { TelemetryProvider, ProductGraphAdapter } from '@coreforge/telemetry';

const adapter = new ProductGraphAdapter({
  projectId: 'my-project',
  endpoint: 'https://api.productgraph.io/v1/events',
  apiKey: process.env.PRODUCTGRAPH_API_KEY,
  batchSize: 20,        // Events per batch
  batchInterval: 5000,  // Flush interval (ms)
  sessionTimeout: 30 * 60 * 1000,  // 30 minutes
});

function App() {
  return (
    <TelemetryProvider config={{ adapters: [adapter] }}>
      <MyApp />
    </TelemetryProvider>
  );
}

ProductGraph Hooks¶

Hook	Purpose
`ComponentPathProvider`	Track component hierarchy
`useComponentPath`	Get current component path
`useStateTracker`	Track state changes with before/after
`JourneyProvider`	Define user journey context
`useJourneyStep`	Track journey step progression
`useScrollTracker`	Track scroll depth (25%, 50%, 75%, 90%, 100%)
`useClickTracker`	Track clicks with component context
`useAPITracker`	Track API calls with timing
`usePageLeaveTracker`	Track page exit and duration

OTel Semantic Conventions¶

ProductGraph events follow OpenTelemetry semantic conventions:

Namespace	Fields
`session.*`	Session ID, timeout
`page.*`	Path, title, URL, referrer
`ui.*`	Component name, path, action
`ui.state.*`	Key, before, after
`gen_ai.journey.*`	Journey ID, step ID, step name
`api.*`	Method, path, status, duration
`error.*`	Type, message, stack

Development Setup¶

# Clone the repository
git clone https://github.com/grokify/coreforge-web.git
cd coreforge-web

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Start development server
pnpm dev

Dependencies¶

Dependency	Version	Purpose
React	^18.0.0	UI framework
TypeScript	^5.0.0	Type safety
pnpm	^9.0.0	Package manager
Turborepo	^2.0.0	Monorepo build
Vitest	^1.0.0	Testing

Known Limitations¶

No SSR support yet (client-side only)
ProductGraph adapter requires manual initialization
No React DevTools integration for telemetry debugging

Upgrade Path¶

v0.2.0 - SSR support, backend correlation
v0.3.0 - React DevTools integration
v0.4.0 - Performance optimization, bundle splitting