ideas.md

ideas.md

Auto-synced mirror · last updated 2026-06-09

# ŚUBHAKĀLA — IDEAS & ROADMAP
# Living document. Updated continuously.
# Last updated: May 23 2026 — R-26 (custom login page) logged
#
# STAGES:
#   💡 Raw       — mentioned, not yet scoped
#   🔍 Scoping   — being defined, effort/revenue being assessed
#   📋 Roadmap   — scoped, assigned to a phase, ready to build
#   🔄 Building  — in active development
#   ✅ Done      — shipped
#
# HOW TO USE:
#   Claude logs new ideas here automatically when mentioned in any session.
#   Weekly ideation session (Saturdays recommended) reviews Raw → promotes to Scoping/Roadmap.
#   Run sync_context.py after updates to push to shubhakala.com.

---

## WEEKLY IDEATION CADENCE

- Session: once per week (Saturday recommended, ~45 min)
- Format: Claude acts as PM — brings ideas, challenges assumptions, prioritises
- Trigger phrase: "ideation session" or "let's brainstorm"
- Output: Raw ideas get promoted, roadmap items get sequenced

---

## ✅ SHIPPED

| Idea | Detail | Shipped |
|------|--------|---------|
| Stotrams library | 23 stotrams, bilingual prose (Hindi + English), Kadence tabs | Jan–Apr 2026 |
| Soundarya Laharī | 100-verse Devī stotram, single accordion page | May 2026 |
| Pañcāṅga v1 | 365 static pages, Bengaluru, Swiss Ephemeris, Lāhirī | May 2026 |
| Chandrabalam + Tarabalam | On every Pañcāṅga page, guest dropdowns, localStorage | May 2026 |
| Calendar widget | Desktop month grid + mobile week strip with Tithi | May 2026 |
| Flask API | panchanga.py wrapped, deployed on Railway.app | May 2026 |
| Social media image generator | 1080×1080 + 1080×1920 PNG, HarfBuzz Devanāgarī shaping | May 2026 |
| Membership system (PMP) | 10 tiers, Knit Pay + Razorpay live, custom profile fields | May 2026 |
| Razorpay Dāna tiers | 5 payment links (₹101–₹10,001), Support page live | May 2026 |
| Logo | Ṣaḍkoṇa (interlocked triangles), gold on dark brown | May 2026 |
| GA4 + Search Console | Tracking + sitemaps live | Apr 2026 |
| AdSense | Applied, under review | May 2026 |

---

## 📋 ROADMAP — PHASE 1 (next 2–4 weeks)

### GitHub Actions daily cron
- **What:** Auto-regenerate homepage + Pañcāṅga today-highlight at 00:05 IST daily
- **Why:** Browse This Week strip shows wrong date every day without it. Only known bug.
- **Effort:** Low — workflow file already exists (`daily_panchanga.yml`), just needs activation + GitHub Secrets
- **Blocked by:** Nothing

### Railway env vars
- **What:** Add WP_URL, WP_USER, WP_PASS, RAZORPAY_WEBHOOK_SECRET to Railway dashboard
- **Why:** Unlocks Razorpay webhook → auto user provisioning on payment
- **Effort:** 10 min manual step
- **Blocked by:** Nothing

### Razorpay webhook auto user provisioning
- **What:** Payment → webhook → Flask API → create WP user + assign PMP tier automatically
- **Why:** Zero manual work on signups; scales immediately
- **Effort:** Code written, just needs Railway env vars + webhook URL in Razorpay dashboard
- **Blocked by:** Railway env vars above

### Early Access auto-downgrade to Śiṣya
- **What:** After 6 months, Early Access members drop to free Śiṣya tier
- **Why:** Keeps tier integrity; Early Access is time-limited by design
- **Effort:** 5 min WP Admin — Membership Levels → Early Access → set expiry action

### Pañcāṅga date picker ✦ promoted from R-17
- **What:** Calendar selector widget on every Pañcāṅga page — jump to any date directly
- **Why:** Current prev/next navigation is unusable beyond ±3 days. Every extra click = drop-off.
- **Effort:** Low — JS datepicker + redirect to /panchanga-bengaluru-YYYY-MM-DD/
- **UX principle:** Minimum clicks to destination. Non-negotiable.

### Amānta label on Pañcāṅga pages
- **What:** Tooltip/footnote: "This site follows Amānta (South Indian) system — month ends on Amāvasyā"
- **Why:** Prevents confusion for North Indian users used to Pūrṇimānta naming
- **Effort:** Low — template change + bulk update

---

## 📋 ROADMAP — PHASE 2 (1–2 months)

### Tithi-based stotram surfacing ✦ promoted from R-19
- **What:** On each Pañcāṅga page, surface relevant stotrams for that day's Tithi automatically
- **Example:** Ekādaśī → Viṣṇu stotrams; Navamī → Devī stotrams; Pradoṣa → Śiva stotrams
- **Why:** Drives stotram page views organically. Makes the site feel alive, not static. Zero extra clicks.
- **Effort:** Low — Tithi-to-stotram mapping table + a "Today's Stotrams" strip on the page
- **Tier:** Free — this is a discovery feature, not a gating feature

### Plan Your Week widget ✦ promoted from R-20
- **What:** 7-day mini-table on the Pañcāṅga index showing Tithi + CB verdict per day, colour-coded green/amber/red
- **Why:** Creates a daily habit loop. Highly shareable on WhatsApp. Free users see the grid; remedies + detail = paid.
- **Effort:** Medium — needs CB pre-computation for 7 days, simple table UI
- **Tier:** Grid = free; drill-down + remedies = Sādhaka+
- **Email hook:** "Your week ahead — Chandrabalam forecast" as weekly Sādhaka email is the best upgrade driver we have

### Smart Rāśi onboarding ✦ promoted from R-21
- **What:** On first visit, a single gentle prompt: "Enter your Janma Rāśi to personalise your Pañcāṅga" — one dropdown, no signup
- **Critical refinement:** "I don't know my Rāśi" link opens a mini birth-detail form (DOB + TOB + place) → calculates and pre-fills Rāśi + Lagna instantly
- **Why:** Immediate personalisation without friction. "This is *my* site" feeling from visit one.
- **Stored in:** localStorage (guest) → user profile (on signup)
- **Effort:** Medium — birth detail mini-form needs Flask API call for Rāśi/Lagna calculation
- **Note:** Lagna field must be added to PMP profile fields before this ships — currently missing

### Daily Jyotiṣa Briefing ✦ promoted from R-14/15/16
- **What:** Combined section on each Pañcāṅga page: Moon-Lagna house analysis + CB+TB verdict + remedial guidance + 7-day forecast
- **Free tier:** CB + TB verdict only (already live)
- **Paid tier (Sādhaka+):** Moon-Lagna house activated today, what to focus on/defer, remedies, 7-day forward view
- **Prerequisite:** Lagna must be added to user profile fields (currently missing — add alongside Smart Rāśi onboarding)
- **Effort:** Medium-High — house calculation logic + remedies content + 7-day pre-computation

### Suggested stotrams ✦ promoted from R-24
- **What:** "Chanted together" recommendations on each stotram page — 2–3 related stotrams surfaced at the bottom
- **Examples:** Hanumān Cālīsā → Rāma Rakṣā Stotram, Śrī Sūktam → Kanakadhārā, Mahāmṛtyuñjaya → Rudrāṣṭakam
- **Why:** Increases pages-per-session directly → better AdSense revenue + SEO dwell time. Low effort, high return.
- **Effort:** Low — static mapping table per stotram + a "Chant Together" strip at page bottom
- **Tier:** Free — discovery feature

### Vedic birthday calculator
- **What:** Enter DOB → get Tithi birthday (when Moon is in same tithi as birth)
- **Tiers:** Tithi calculation = free; nakṣatra birthday, solar return, full Vedic birthday details = paid
- **Why:** Viral potential — every Hindu family wants this. High search volume.
- **Effort:** Medium — panchanga.py + date-range search algorithm

### Lalitā Sahasranāma
- **What:** 1000-name Devī stotram, green colour scheme
- **Priority:** HIGH — most searched Devī stotram after Soundarya Laharī
- **Effort:** High (1000 names with prose) — needs dedicated Claude Code session

### Durgā Saptaślokī
- **What:** 7-verse Devī stotram
- **Effort:** Low (7 verses)

### Śrī Rāma Rakṣā Stotram
- **What:** 38-verse stotram, red colour scheme
- **Effort:** Medium

### Vedic Clock widget
- **What:** Live Ghaṭikā/Vipala, Prahara, Horā, Choghaḍiyā display on Pañcāṅga pages
- **Why:** DrikPanchang has this — match + exceed
- **Tier:** Choghaḍiyā/Horā gated behind Sādhaka
- **Effort:** Medium — JS clock, sunrise-relative calculation
- **Mobile extension:** Alarm based on Vedic time unit (app only, Phase 8)

### Global language toggle ✦ promoted from R-18
- **What:** Site-wide EN/HI toggle in the nav/header — one click, persists everywhere
- **Stored in:** localStorage (guest) → user profile preference (logged-in)
- **Scope:** Controls prose, labels, navigation text only. Stotram Devanāgarī/IAST tabs are separate — those stay as tabs.
- **Why:** Per-page language is broken UX — inconsistent, error-prone, cumbersome
- **Effort:** Medium — needs all prose/label strings tagged with data-en/data-hi attributes site-wide

### Dummy test personas
- **What:** 5 WP test users: Śiṣya, Sādhaka, Jyotiṣa, Lifetime, Admin
- **Why:** QA all tier-gated features before going live
- **Effort:** 15 min

### Delete pmpro-register-helper plugin
- **What:** Plugin is now redundant (built into PMP core)
- **Effort:** 2 min WP Admin

---

## 📋 ROADMAP — PHASE 3 (2–4 months)

### Dynamic Pañcāṅga calculator
- **What:** Any date, any city — user enters parameters, gets live Pañcāṅga
- **Why:** Currently only Bengaluru + static dates. Massive UX gap.
- **Effort:** Medium — Flask API endpoint already built, needs frontend widget

### Kundlī v1
- **What:** Birth chart (D1) + D9 + Mahā/Antardaśā + basic features
- **Free tier features:** D1, D9, Chandra, Chalit, Mahā+Antardaśā, birth Pañcāṅga, Sarvāṣṭakavarga, transit D1, basic Kundlī Milan, 3 saved charts
- **Sādhaka:** + Pratyantardaśā, transit D9, detailed Milan, 20 saved charts
- **Jyotiṣa/Lifetime:** + Bhinnaṣṭakavarga, transit calendar, good/bad times predictor, KP, D2–D60, Ṣaḍbala, unlimited charts
- **Effort:** High — full multi-session project

### International pricing (USD/EUR)
- **What:** IP-detected currency; flat USD pricing ($5/$10/$20/$30/$75/$65); Stripe integration
- **Why:** Diaspora market (US, UK, Canada, Australia) is large and higher-paying
- **Tiers:** Mirror INR tiers at flat USD — Śubha $5, Sādhaka $10, Jyotiṣa $20, Kula $30, Praśna $75, Lifetime $65

### Festival calendar
- **What:** Every major festival (Diwali, Ekādaśī, Pūrṇimā, Navamī, etc.) as a landing page
- **Why:** Highest SEO multiplier — massive search volume on festival dates
- **Effort:** Medium — data + templated pages

### Daily Pañcāṅga via email/WhatsApp
- **What:** Opt-in daily Pañcāṅga digest sent at 5:30 AM IST
- **Tier:** Pro feature (Sādhaka+)
- **Tech:** WhatsApp Business API + email (Mailchimp or similar)

---

## 📋 ROADMAP — PHASE 4+ (4+ months)

### Jyotiṣa Agent
- **What:** Claude API-powered AI chatbot for Jyotiṣa Q&A
- **Tier:** Jyotiṣa tier+; query limits per tier
- **Why:** Massive differentiator — no competitor has this

### Ishta Devatā calculator
- **What:** From birth chart, identify Ishta Devatā (personal deity)
- **Dependency:** Kundlī must be live first
- **Note:** Parked until Kundlī v1 ships

### Social media automation
- **What:** Daily Pañcāṅga image (1080×1080) auto-posted at 05:30 IST to Instagram + Facebook + Twitter
- **Dependency:** Social accounts must be created first (parked)
- **Tech:** GitHub Actions + Meta Graph API + Twitter API; image generator already built

### Mobile app
- **What:** React Native (Android + iOS)
- **Features at launch:** Pañcāṅga, Vedic Clock, alarms, saved charts
- **Effort:** Very High — full separate project

### Eclipse data pipeline
- **What:** Pre-computed eclipse data for all visible eclipses, integrated into Pañcāṅga
- **Effort:** Medium

### Geocoded location dropdown
- **What:** City search with autocomplete (Nominatim) for dynamic Pañcāṅga
- **Effort:** Low-Medium (vanilla JS)

---

## 💡 RAW IDEAS (unscoped, logged as mentioned)

| # | Idea | Source | Date logged |
|---|------|--------|-------------|
| R-01 | Muhūrta calculator — find auspicious times for events (marriage, travel, business) | Session | May 2026 |
| R-02 | Annual Pañcāṅga PDF — downloadable yearly almanac (paid) | Session | May 2026 |
| R-03 | Kundlī Milan (compatibility) — D1 chart matching, basic + detailed | Session | May 2026 |
| R-04 | Praśna Jyotiṣa — question-based chart reading (top-tier only) | Session | May 2026 |
| R-05 | Community page — top-tier users post recommendations, earn points | Session | May 2026 |
| R-06 | Gamification — points for daily check-in, stotram reads, sharing; badges; leaderboard | Session | May 2026 |
| R-07 | Points redemption — 1000 pts = 1 month Sādhaka free | Session | May 2026 |
| R-08 | Kaladṛṣṭi platform — advanced predictive platform (very long-term) | Session | May 2026 |
| R-09 | Sārvāṣṭakavarga on Pañcāṅga pages | Session | May 2026 |
| R-10 | Planetary hour (Horā) alarm on mobile | Session | May 2026 |
| R-11 | Rāhu Kālam push notification — "starts in 15 min" | Session | May 2026 |
| R-12 | Stotram audio — pronunciation guide or audio recitation | (implied from UX) | May 2026 |
| R-13 | Amānta vs Pūrṇimānta toggle — let users pick their regional system | Session | May 2026 |
| R-14 | CB/TB extended — Moon-Lagna analysis: which life area is favoured/unfavoured on a given day | Ideation | May 23 2026 |
| R-15 | CB/TB extended — daily remedies: what to do/avoid based on CB+TB outcome | Ideation | May 23 2026 |
| R-16 | CB/TB extended — upcoming good/bad days planner: show next 7/30 days CB+TB forecast | Ideation | May 23 2026 |
| R-17 | Pañcāṅga date picker — calendar selector widget to jump to any date without click-through | Ideation | May 23 2026 |
| R-18 | Global language selector — site-wide EN/HI toggle (header/nav level), not per-page | Ideation | May 23 2026 |
| R-19 | Tithi-based stotram surfacing — show relevant stotrams on Pañcāṅga page based on today's Tithi | Ideation | May 23 2026 |
| R-20 | Plan Your Week widget — 7-day CB/TB grid on Pañcāṅga index, colour-coded, WhatsApp-shareable | Ideation | May 23 2026 |
| R-21 | Smart Rāśi onboarding — first-visit dropdown + "I don't know my Rāśi" link → mini birth form → auto-calculates Rāśi + Lagna | Ideation | May 23 2026 |
| R-22 | Stotram format uniformity — all stotrams to have consistent structure: meaning/commentary present on every page without exception | Ideation | May 23 2026 |
| R-23 | Word-level pronunciation aid — hover on complex words splits sandhi or shows pronunciation; optional audio clip per word | Ideation | May 23 2026 |
| R-24 | Suggested stotrams — "chanted together" recommendations on each stotram page, e-commerce style (e.g. Hanumān Cālīsā → Rāma Rakṣā Stotram) | Ideation | May 23 2026 |
| R-25 | Regional language support — Kannada, Telugu, Tamil tabs on stotram pages; global toggle if feasible, else per-page tabs; maintain bilingual prose quality | Ideation | May 23 2026 |
| R-26 | Custom login page — branded /login page with site design (not default WordPress login) | Session | May 23 2026 |
| R-27 | Jyotiṣa Agent with RAG over KB — Claude API powered, kb/ as knowledge source, scoped to Jyotiṣa Q&A, tier-gated (Sādhaka+) | Session | Jun 4 2026 |
| R-28 | Kundlī v1 Phase 1 — D1 chart + Rāśi/Lagna/Nakṣatra (free), planetary positions + birth Pañcāṅga (Śubha+), Viṃśottarī Daśā + D9 (Sādhaka+), predictions per daśā lord (Jyotiṣa+) | Session | Jun 4 2026 |
| R-29 | KB-driven Daśā predictions — text interpretations for each Mahādaśā lord generated from KB, not hardcoded; updatable without code changes | Session | Jun 4 2026 |
| R-30 | 'Today for you' Pañcāṅga strip — transit Moon house position relative to user Lagna + active Viṃśottarī daśā + personalised CB/TB — free feature if Lagna known, daśā interpretation gated Sādhaka+ | Session | Jun 4 2026 |
| R-31 | Kundlī v1 — D1+D9 charts, Viṃśottarī daśā, tier-gated — discovery via Pañcāṅga 'Today for you' strip, no separate nav item | Session | Jun 4 2026 |
| R-32 | Kāladṛṣṭi Phase 2 — advanced Kundlī (D2–D60, Ṣaḍbala, KP), Jyotiṣa courses, Praśna retainer, consultant bookings — migrate from Shubhakāla when professional positioning needed | Session | Jun 4 2026 |
| R-33 | Transit predictions for advanced tiers — Jyotiṣa+ section on Kundlī page showing major planet transits over natal positions with KB-driven interpretations, refreshed daily via Flask API | Session | Jun 4 2026 |
| R-34 | Universal birth detail calculator fallback — reusable inline mini-calculator (DOB+TOB+POB → Rāśi/Lagna/Nakṣatra) shown anywhere birth details are missing across the site; single component, consistent UX pattern | Session | Jun 4 2026 |
| R-35 | Astro-Vastu — accept building blueprint/floor-plan upload, score Vastu compliance (8-direction + Vāstu Puruṣa Maṇḍala + Pañca Bhūta zoning), differentiator vs commodity AI Vastu calculators = personalisation to the user's birth chart (Astro-Vastu). Tier: Jyotiṣa/Lifetime. Depends on Kundlī frontend. Phase 3. Market note: category already crowded (Grihafy, Kshetra AI, AppliedVastu, Apzok etc.) but incumbents have weak accuracy + no real Jyotiṣa engine — our moat is chart integration. | Ideation | June 9 2026 |

---

## HOW CLAUDE LOGS IDEAS

When you say something like:
- "I have an idea..."
- "What if we..."
- "Can we add..."
- "Wouldn't it be cool if..."
- "We should build..."
- "users might want..."

→ Claude adds a row to the Raw Ideas table above with date + source, then confirms.
→ No idea gets lost. Nothing goes into memory or Excel until it's been through ideation.

---

## IDEATION SESSION TEMPLATE

**When:** Weekly (Saturday recommended)
**Duration:** 45 min
**Agenda:**
1. Review Raw Ideas (10 min) — promote, discard, or keep
2. PM perspective (15 min) — Claude brings 3 unprompted ideas based on site data/trends
3. Roadmap sequencing (10 min) — what moves up, what gets deprioritised
4. Next week's build priority (10 min) — 1–2 items to ship

**Trigger:** Say "ideation session" to start.