Skip to Content
Baseera Docs

Installation

Install the Baseera packages, their peer dependencies, and the stylesheet.

Browser packages

pnpm add @baseera/react @baseera/ui @baseera/core lucide-react zod

Then import the stylesheet once, near the root of your app:

import "@baseera/ui/baseera.css";

Server package

pnpm add @baseera/node

@baseera/node has no peer dependencies. It also installs the baseera command, which runs an agent's eval suites from CI.

Peer dependencies

PackagePeer dependencies
@baseera/coreNone.
@baseera/reactreact 18 or later, zod 4 (^4.0.0). It depends on @baseera/core directly.
@baseera/uireact 18 or later, react-dom 18 or later, lucide-react, @baseera/core. @baseera/react is optional: you need it only for the connected components in @baseera/ui/connected.
@baseera/nodeNone.

Zod 4 is required by useBaseeraTool, which turns a z.object(...) schema into the JSON Schema the model sees.

Supported versions

RuntimeSupported
React18 and 19
Next.jsApp Router. The demo app runs on Next.js 15.
ViteAny version that serves a React app.
Node (server)20 or later for @baseera/node and @baseera/core.
Node (build tooling)18 or later for @baseera/react and @baseera/ui.

@baseera/core also runs in browsers, workers and edge runtimes that have fetch.

Entry points

ImportWhat you get
@baseera/uiProps-only components: Baseera, ApprovalCard, ToolStatus, ChatTranscript, label helpers.
@baseera/ui/connectedComponents wired to @baseera/react: BaseeraSurface, BaseeraApprovals, BaseeraToolActivity, BaseeraField, BaseeraKnowledgeUpload.
@baseera/ui/staticBaseeraStaticChat and the static review pieces. No provider, no network.
@baseera/ui/baseera.cssThe stylesheet. @baseera/ui/styles.css is the same file.

Every built file in @baseera/react and @baseera/ui starts with "use client", so you can import them from a client component in the Next.js App Router.

Environment variables

You need three values from the Baseera console, plus the URL of your runtime:

ValueWhere it lives
Publishable key (pk_ and 48 hex characters)The browser. A NEXT_PUBLIC_ or VITE_ variable is fine.
Secret key (sk_ and 64 hex characters)Your server only. A normal environment variable.
Agent id (a uuid)Your server, for verifyFinish, knowledge and the CLI.
Runtime URLBoth. baseUrl is required until a hosted runtime exists.

On this page