@haruspex-guru/react

Drop-in React components for Haruspex stock scores and insights. Built for Lovable but works in any React 18+ / 19+ app (Next.js, Vite, CRA, etc.).

Install

npm install @haruspex-guru/react

Quick start

import { HaruspexProvider, ScoreCard, ScoresGrid, ArticlesFeed } from "@haruspex-guru/react";
import "@haruspex-guru/react/styles.css";

export default function App() {
  return (
    <HaruspexProvider embedKey={import.meta.env.VITE_HARUSPEX_KEY}>
      <ScoreCard symbol="AAPL" />
      <ScoresGrid symbols={["AAPL", "MSFT", "NVDA"]} layout="grid" />
      <ArticlesFeed symbol="TSLA" limit={5} />
    </HaruspexProvider>
  );
}

Get an embed key from the Haruspex admin. The key auto-allowlists Lovable's three default domains: *.lovable.app, *.lovable.dev, and *.lovableproject.com (preview host).

API

`<HaruspexProvider embedKey theme? baseUrl?>`

Wraps a subtree. Theme is "dark" (default) or "light".

`<ScoreCard symbol onClick? />`

Single live score for a US ticker.

`<ScoresGrid symbols layout? hideBranding? />`

Up to N tickers (3 free / 10 pro / 25 gold).

`<ArticlesFeed symbol? category? limit? displayMode? showImages? showExcerpt? showCategory? showDate? hideBranding? />`

Recent Haruspex Insight articles.

Lovable docs + knowledge prompt

See PROMPT.md — paste it into your Lovable project's Knowledge tab so the agent knows how to use these components.

JSPM