Ship a feature this weekend

Small, working starters built on the API. Clone the idea, swap in your key, ship.

1 · AI astrology chatbot

~40 lines

Grounded answers from real charts — the LLM never invents a position.

TypeScript
import { AstroClient } from '@astrovibe/client';

// Ship an astrology chatbot in one file.
const astro = new AstroClient({ apiKey: process.env.ASTRO_API_KEY });

export async function answerBirthChart(question: string, user: { name: string; date: string; time: string; tz: string; lat: number; lon: number }) {
  const chart = await astro.postVedicPlanetaryPositions({
    datetime: new Date(user.date + 'T' + user.time + ':00').toISOString(),
    latitude: user.lat, longitude: user.lon, timezone: user.tz,
  });
  const lagna = chart.positions.find(p => p.body === 'Lagna')?.sign;
  const sun = chart.positions.find(p => p.body === 'SUN')?.sign;
  return `Here's what I see, ${user.name}: your lagna is in ${lagna} and your Sun is in ${sun}.`;
}

2 · Vedic kundli app

4 endpoints

Sidereal chart, dashas, vargas and yogas — the complete kundli stack.

TypeScript
// Free MIT template: Vedic kundli app (frontend + API)
// POST /v1/vedic/planetary-positions -> sidereal planets
// POST /v1/vedic/dasha/current       -> mahadasha/antardasha
// POST /v1/vedic/divisional-chart    -> D1..D60 vargas
// POST /v1/vedic/yogas/detect        -> classical yogas
const chart = await astro.postVedicPlanetaryPositions({ ...birth });
console.log(chart.positions.map(p => `${p.body}: ${p.longitude.toFixed(2)}° ${p.isRetrograde ? 'R' : ''}`));

3 · Daily horoscope widget

1 endpoint

A per-sign daily reading — embed anywhere.

TypeScript
// Daily horoscope widget — GET /v1/western/horoscope/:sign/daily
// Or transit-aware readings via POST /v1/horoscope/reading
const daily = await fetch(
  `https://astro-vibe-engine.gauravapproved.workers.dev/v1/western/horoscope/aries/daily`,
  { headers: { 'x-api-key': process.env.ASTRO_API_KEY } }
).then(r => r.json());
console.log(daily.overview);
More starters coming — tarot app, numerology calculator, dream journal. Want one first? Tell us.