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 linesGrounded 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 endpointsSidereal 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 endpointA 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.