Bloom AI Image Tools

React component library that exposes the ImageToolsWorkspace UI for embedding inside other apps. The Vite app in this repo is only a demo shell around the exported component.

Install & Build

Prerequisites: Vite+ (vp). On Windows install it with irm https://vite.plus/ps1 | iex, then restart your terminal or VS Code so vp is on PATH.

Vite+ manages the Node.js runtime from .node-version and the pnpm version from packageManager in package.json.

1. Install dependencies: vp install
2. Run the dev demo: vp dev
3. Build the npm package: vp run build:lib
4. Build the demo bundle (optional): vp build

Consuming the Component

pnpm add bloom-ai-image-tools

import { ImageToolsWorkspace } from "bloom-ai-image-tools";

function Example() {
	return <ImageToolsWorkspace persistence={...} envApiKey={...} />;
}

See App.tsx for a concrete integration example.

Art-style preview thumbnails rely on bundlers that support import.meta.glob (Vite/Rollup). Other bundlers fall back to text-only style selection.

Versioning & Releases

We use Changesets for semver management. Typical workflow:

1. Create a changeset describing your change: vp run changeset
2. Merge the generated PR. The Release GitHub Action will bump versions and publish to npm.
3. Manual publishing (rare): vp run release

Ensure NPM_TOKEN is configured in the repo secrets for the workflow to succeed.

Tests

• Unit tests: vp test
• E2E (Playwright): set BLOOM_OPENROUTER_KEY_FOR_PLAYWRIGHT_TESTS to your OpenRouter API key, then run vp run e2e.