boot-react

@alt-javascript/boot-react

React integration for the @alt-javascript framework. CDI services accessible via React Context and hooks.

Part of the @alt-javascript monorepo.

Install

npm install @alt-javascript/boot-react

Usage

Boot CDI and create hooks

// boot.js
import { bootCdi } from '@alt-javascript/boot-react';

export const { CdiProvider, useCdi, useBean } = await bootCdi({
  contexts: [context],
  config,
  React,
});

Wrap your app

import { CdiProvider } from './boot';

function App() {
  return (
    <CdiProvider>
      <TodoList />
    </CdiProvider>
  );
}

Use CDI beans in components

import { useBean } from './boot';

function TodoList() {
  const todoService = useBean('todoService');
  const [todos, setTodos] = useState(todoService.list());
  // ...
}

Headless mode (testing / SSR)

import { bootCdiHeadless } from '@alt-javascript/boot-react';

const ctx = await bootCdiHeadless({ contexts, config });
const svc = ctx.get('todoService');

This package does not depend on React at runtime — it creates React-bound utilities when React is available, and falls back to headless mode when it's not.

License

MIT