# Open source astrology templates, clone and deploy

Production-ready apps you can clone, add your API key, and ship. All templates are open source and MIT-licensed: white label them and ship under your own brand. No domain expertise required. Multi-language support included: the full interpretation text comes back in 10+ languages, not just field labels.

## All Templates

| App | Platform | Tech | What it does |
|-----|----------|------|-------------|
| [AI Spiritual Companion](https://github.com/RoxyAPI/ai-spiritual-companion) | Web | Next.js 16, Supabase, pgvector, Vercel AI SDK v7, Remote MCP | AI companion that remembers every user: semantic recall over the full chat history, with the natal chart computed once and kept. Gemini, Claude, GPT. |
| [AI Astrology Chatbot](https://github.com/RoxyAPI/astrology-ai-chatbot) | Web | Next.js 16, Vercel AI SDK v6, MCP | AI chatbot with real readings across 18+ domains. Gemini, Claude, GPT. |
| [Practitioner Website](https://github.com/RoxyAPI/spiritual-practitioner-website-template) | Web | Next.js 16, @roxyapi/sdk, @roxyapi/ui-react | Bookable practitioner site: services, blog, and free birth chart, tarot, and human design readings that end in a booking. |
| [AI Voice Assistant](https://github.com/RoxyAPI/spiritual-ai-voice-assistant) | Web | Next.js 16, Web Speech API, MCP | Spoken readings across every domain, plus an embeddable tap to talk widget. |
| [Vedic Astrology Kundli](https://github.com/RoxyAPI/jyotish-vedic-astrology-app) | Web | Next.js 16, @roxyapi/sdk, @roxyapi/ui-react | Kundli (D1-D60), Panchang, Gun Milan, Dasha, doshas, Shadbala, 7000+ cities. |
| [Tarot](https://github.com/RoxyAPI/tarot-starter-app) | Mobile | React Native, Expo | 78-card deck, Celtic Cross spreads, daily readings, yes/no oracle. |
| [Numerology](https://github.com/RoxyAPI/numerology-starter-app) | Mobile | React Native, Expo | Life Path, Expression, Soul Urge, compatibility, Personal Year. |
| [Western Astrology](https://github.com/RoxyAPI/astrology-starter-app) | Mobile | React Native, Expo | Natal charts, zodiac compatibility, daily horoscopes, transits. |
| [Vedic Astrology](https://github.com/RoxyAPI/vedic-astrology-starter-app) | Mobile | React Native, Expo | Birth charts (D1/D9), Gun Milan, Dasha, doshas, 300+ yogas. |
| [Dreams](https://github.com/RoxyAPI/dreams-starter-app) | Mobile | React Native, Expo | Dream journal with 2,000+ symbol interpretations, pattern tracking. |

## How to use a template

```bash
git clone https://github.com/RoxyAPI/tarot-starter-app.git
cd tarot-starter-app
npm install
cp .env.example .env
# Add your API key to .env
npm start
```

All templates deploy in under 30 minutes. Browse all at [roxyapi.com/templates](/templates).

## Next steps

- [AI Prompts](/docs/prompts): build a custom app with AI instead
- [Domain Guides](/docs/guides/astrology): understand the APIs you are using