@vedika-io/react

React SDK for the Vedika Intelligence API -- hooks, provider, and utilities for astrology, tarot, numerology, and 20+ spiritual domains.

Installation

npm install @vedika-io/react @vedika-io/sdk

Quick Start

Wrap your app with VedikaProvider and use hooks anywhere inside:

import { VedikaProvider, useAskVedika, useBirthChart } from '@vedika-io/react';

function App() {
  return (
    <VedikaProvider apiKey="vk_live_...">
      <AstrologyChat />
    </VedikaProvider>
  );
}

function AstrologyChat() {
  const { data, loading, error, ask } = useAskVedika();

  const handleAsk = () => {
    ask({
      question: 'What are my career prospects this year?',
      birthDetails: {
        datetime: '1990-06-15T14:30:00+05:30',
        latitude: 28.6139,
        longitude: 77.2090,
        timezone: '+05:30',
      },
    });
  };

  return (
    <div>
      <button onClick={handleAsk} disabled={loading}>
        Ask Vedika
      </button>
      {loading && <p>Thinking...</p>}
      {error && <p>Error: {error.message}</p>}
      {data && <p>{data.answer}</p>}
    </div>
  );
}

Provider Options

<VedikaProvider
  apiKey="vk_live_..."       // Required -- your API key
  baseUrl="https://api.vedika.io"  // Optional -- custom base URL
  language="en"              // Optional -- default response language
  timeout={60000}            // Optional -- request timeout in ms
>
  {children}
</VedikaProvider>

Available Hooks

Every hook returns { data, loading, error, fetch/ask/draw/cast/send, reset }.

AI Query

Hook	Description
useAskVedika()	Natural language astrology question
useAskVedikaStream()	Streaming response (real-time chunks)
useVoice()	Voice query (audio in, audio/text out)

Vedic Astrology

Hook	Description
useBirthChart()	Generate a complete birth chart (Kundali)
useDasha()	Vimshottari Dasha planetary periods
useDosha()	Dosha analysis (Kaal Sarp, Mangal, Sade Sati)
useYoga()	Detect 300+ astrological yogas
usePanchang()	Hindu calendar data for any date
useMuhurta()	Find auspicious times for events
useTransit()	Planetary transit analysis
useCompatibility()	Ashtakoota marriage compatibility
useHoroscope()	Daily/weekly/monthly horoscope
usePrediction()	Predictions (daily to yearly)

Tarot

Hook	Description
useTarotReading()	Draw a tarot spread
useCardOfTheDay()	Daily tarot card
useTarotSpreads()	List available spreads

Chinese Astrology

Hook	Description
useChineseZodiac()	Chinese zodiac animal by year
useBaZi()	Four Pillars of Destiny chart
useFengShui()	Kua number and directions

I Ching

Hook	Description
useHexagram()	Cast a hexagram with question
useIChingDaily()	Daily hexagram

Numerology

Hook	Description
useNumerologyReport()	Full 37-calculation report
useLifePath()	Life path number
useExpression()	Expression/destiny number

Matrimony

Hook	Description
useGunaMilan()	36-point Ashtakoota matching
useDoshaCancellation()	Dosha cancellation check
useUnifiedMatch()	Combined Vedic + KP matching

Human Design

Hook	Description
useBodyGraph()	Full body graph chart
useHDType()	Type, strategy, and authority
useHDStrategy()	Alias for useHDType

Crystals

Hook	Description
useCrystalByZodiac()	Crystals for a zodiac sign
useCrystalByChakra()	Crystals for a chakra
useCrystalCatalog()	Full crystal catalog

Spiritual

Hook	Description
useMantra()	Personalized mantra recommendation
useDeity()	Recommended deity for worship
usePastLife()	Past life karmic indicators

Health

Hook	Description
useHealthVulnerabilities()	Health analysis from chart
useAyurvedicType()	Ayurvedic constitution type

Career

Hook	Description
useSuitableCareers()	Best career fields from chart
useCareerTiming()	Auspicious periods for career moves

Daily

Hook	Description
useDailyBundle()	All-in-one daily insights
useDailyHoroscope()	Daily horoscope by sign

Accessing the Client Directly

For advanced use cases, access the underlying VedikaClient:

import { useVedikaClient } from '@vedika-io/react';

function Advanced() {
  const client = useVedikaClient();
  // Use any method from @vedika-io/sdk directly
  const result = await client.getNavamsa(birthDetails);
}

Streaming Example

import { useAskVedikaStream } from '@vedika-io/react';

function StreamingChat() {
  const { data, loading, stream, abort } = useAskVedikaStream();

  return (
    <div>
      <button onClick={() => stream({ question: '...', birthDetails: { ... } })}>
        Stream Response
      </button>
      <button onClick={abort}>Stop</button>
      <div>{data}</div>
    </div>
  );
}

Error Handling

All hooks catch errors automatically. Errors from the API are typed:

import { useAskVedika } from '@vedika-io/react';

function MyComponent() {
  const { error } = useAskVedika();

  if (error) {
    // error.message contains the API error description
    // Check error type: AuthenticationError, RateLimitError,
    // InsufficientCreditsError, ValidationError, etc.
  }
}

TypeScript

Full TypeScript support. All types are re-exported from @vedika-io/sdk:

import type { BirthDetails, QuestionResponse, TarotReading } from '@vedika-io/sdk';

Links

• API Documentation
• Dashboard
• JavaScript SDK
• API Status

License

MIT