One unified reference merging the Phase 1 core app (12 screens), the Phase 2 ecosystem (12 modules, 116+ screens), and 6 newly-scoped modules sourced from the product roadmap. Every screen shares one design system — same tokens, typography, and components throughout.
Design consistency rule: All screens compose from the same primitives — cards (.cd), list items (.li), chips (.ch), buttons (.bt), timing pills (.tp), section labels (.sl), badges (.bg-*), screen-index grids (.si). Module-specific patterns are documented per module but built from existing tokens. No new visual language is introduced anywhere in this document.
Core App
12 screens
Splash, Onboarding, Home, Panchang, Calendar, Festival, Muhurat, Horoscope, Kundli, AI Assistant, Profile, Premium
Help Center, FAQ, Contact Us, Feedback, Bug Report
Navigation Map
How every screen connects — from first launch through the bottom-nav core app into the full ecosystem reached via the "Other" tab. Solid lines are primary navigation; dashed lines are secondary/contextual jumps (e.g. "Ask AI" buttons).
Premium pairing: scholarly serif for display, geometric sans for UI. Both fonts support excellent multilingual rendering through Flutter's Noto fallback.
Font Selection
Newsreader
Display · Headlines · Verse
Variable serif by Production Type. Optical size axis adapts stroke contrast from 6pt–72pt. Beautiful italics for Sanskrit verse. Why over Cormorant: Better readability at 14–18px.
Plus Jakarta Sans
Body · UI · Data · Labels
Modern geometric sans by Tokotype. Warmer than Inter with character in rounded terminals. Excellent tabular numerals for panchang data. Variable weight 200–800.
Indian script fallback: Flutter handles Devanagari, Gujarati, Tamil, Telugu, Kannada, Malayalam, Bengali, Marathi, Punjabi, Odia, and Urdu via Noto family.
Type Scale
Display
Shukla Trayodashi
Newsreader · 32/36 · w700 · -0.02em
H1
Today's Panchang
Newsreader · 26/32 · w600 · -0.02em
H2
Uttara Phalguni
Newsreader · 22/28 · w600 · -0.01em
H3
Shravan Masa
Newsreader · 18/24 · w600
H4
Sunrise & Sunset
Plus Jakarta Sans · 16/22 · w600 · -0.01em
Subtitle
Vikram Samvat 2083 · Drik Panchang
Plus Jakarta Sans · 15/22 · w500
Body Large
Moon transiting the 7th house brings focus to partnerships and collaborative ventures today.
Plus Jakarta Sans · 15/24 · w400
Body
Observe the vrat from sunrise to moonrise. Break fast with prasad after moonrise.
Plus Jakarta Sans · 14/22 · w400
Caption
Last updated 2 minutes ago · Ahmedabad, Gujarat
Plus Jakarta Sans · 12/16 · w400
Label Large
UPCOMING FESTIVALS
Plus Jakarta Sans · 13/18 · w600 · 0.03em
Label Small
TODAY'S PANCHANG
Plus Jakarta Sans · 10/14 · w700 · 0.2em · uppercase
Button
Get Started
Plus Jakarta Sans · 13/18 · w600 · 0.02em
Panchang Value
06:12 AM
Plus Jakarta Sans · 15/20 · w600 · tabular-nums
Sanskrit Verse
"Dharmo rakshati rakshitah" — Manusmriti 8.15
Newsreader · 15/24 · w400 · italic
SYSTEMColor Tokens
Live palette editor — pick any color and every screen on this page updates instantly. Use this to test alternate palettes before implementing in Flutter.
Change any swatch below. Every phone mockup, button, card, and badge on this page uses these tokens — your changes propagate everywhere in real time.
Surfaces
Background
--bg
Surface
--sf
Surface Container
--sf-c
Surface Hover
--sf-h
Device Border
--device-border
Device BG
--device-bg
Primary / Accent
Primary
--pr
Primary Hover
--pr-h
On Primary
--on-pr
Primary Container
--pr-c
On Primary Container
--on-pr-c
Text
On Surface
--tx
On Surface Variant
--tx2
Tertiary / Muted
--tx3
Semantic
Auspicious
--aus
Inauspicious
--inaus
Warning
--warn
Info
--info
SYSTEMComponents
Live component gallery — all variants rendered with current tokens. Change any color above and these update instantly.
Branded launch screen. Logo + tagline, subtle animation. Sets first impression before data loads.
Dark
9:41● ● ●
N
Nakshatraya
Hindu Panchang
Loading panchang data...
Splash Spec
DurationUntil DataPreloadService completes (typically 1–3s)Logo animScale 0.8→1.0, 500ms, Curves.easeOutBackText animFade in 300ms after logo completesSpinnerAppears after 400ms delay, spin .8s linear infiniteTransitionFadeTransition to Onboarding (first install) or Home, 400ms
02Onboarding
5-slide tour introducing key features. Shown once on first install. Dots indicator + Skip/Next flow.
Slide 1
9:41● ● ●
🕉
Welcome to Nakshatraya
Your personal Hindu Panchang with precise astronomical calculations.
Skip
Next
Onboarding Slides
Slide 1Welcome — OM mandala + app introSlide 2Festivals & Vrats — animated festival cards gridSlide 3Notifications — phone mockup with 3 notification cardsSlide 49 Panchang Styles — 3x3 animated gridSlide 5Location — city picker + timing summaryTransitionPageView with Curves.easeInOutCubic, 400msCompletionSets welcome_tour_shown=true, navigates to Home
03Home Dashboard
Clean, spacious layout. Panchang data displayed clearly without ornamental borders or glow effects. Gold used only on active indicators.
Dark
9:41● ● ●
Good Morning
Monday, 28 July
🔔
V
Ahmedabad · Drik
Today's Panchang
Shukla Trayodashi
Uttara Phalguni · Ends 09:18
Shukla PakshaSiddha YogaGaraja
Sunrise
06:12
Sunset
19:24
Moonrise
17:03
Rahu
07:42
Quick Actions
✦
Kundli
⏰
Muhurat
♈
Horoscope
🧭
Compass
🙏
Pandit
Upcoming
See All
15
AUG
Janmashtami
In 18 days
27
AUG
Ganesh Chaturthi
In 30 days
Today's Energy
Auspicious Day
Siddha Yoga + Shukla Paksha Strong for new beginnings
Shubh YogaTrayodashi
⏰
Best Muhurat
Abhijit — in 2h 14m
11:52 – 12:42
♉
Vrishabha · House 7
Partnerships favored today
Read →
✦
Ask Jyotish Guru...
Ask →
"Dharmo rakshati rakshitah — Dharma protects those who protect it."
— Manusmriti 8.15
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
04Panchang Detail
Clean data grid with clear label hierarchy. Inauspicious/auspicious periods marked with subtle left border accent — no heavy color fills.
Dark
9:41● ● ●
‹
Monday, 28 July 2026
Shravan · Shukla Trayodashi · VS 2083
›
Tithi
Shukla Trayodashi
Ends 14:32
Nakshatra
Uttara Phalguni
Ends 09:18 · Sun
Yoga
Siddha
Ends 22:05
Karana
Garaja
Ends 14:32
Paksha
Shukla
Vara
Somavar
Moon
Timings
Sunrise
06:12
Sunset
19:24
Moonrise
17:03
Moonset
03:42 (+1)
Inauspicious
Rahu Kaal
07:42 – 09:12
Yamaganda
10:42 – 12:12
Auspicious
Abhijit Muhurat
11:52 – 12:42
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
05Calendar
Month grid with tithi subscript. Today marked with primary fill. Festival dots as subtle indicators. Clean day-detail card below.
Dark
9:41● ● ●
‹
July 2026
›
S
M
T
W
T
F
S
1
षष्ठी
2
सप्त.
3
अष्ट.
4
नवमी
5
दशमी
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
त्रयो.
29
30
31
28 July — Today
Shubh
Shukla Trayodashi · Uttara Phalguni · Siddha Yoga
☀ 06:12🌙 19:24
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
06Festival Detail
Full-page view for a single festival — significance, rituals, timings, and reminder CTA. Reachable from Festival list and Calendar day detail.
Dark
9:41● ● ●
←
Festival
🔔
Janmashtami
जन्माष्टमी
Fri, 15 Aug 2026Krishna Ashtami
Significance
Celebrates the birth of Lord Krishna, the eighth avatar of Vishnu. Observed on the Ashtami of Krishna Paksha in Shravan.
Rituals
1
Fast until midnight (Nishita Kaal)
2
Puja with tulsi, butter, and flute offering
3
Dahi Handi celebration at dawn
Timings
Ashtami
19:32
Nishita
00:08
Parana
06:18
Set Reminder
07Muhurat
Choghadiya timeline for the current day — highlights the active period, shows all day/night slots with auspicious/inauspicious badges.
Dark
9:41● ● ●
←
Muhurat
Current Period
Shubh
07:42 – 09:12
Auspicious
Day Choghadiya
Amrit
Shubh
Rog
Kaal
Labh
Udveg
Char
All Periods
Amrit
06:12 – 07:42
Shubh
Shubh NOW
07:42 – 09:12
Shubh
Rog
09:12 – 10:42
Ashubh
Kaal
10:42 – 12:12
Neutral
08Horoscope
Vedic gochar (transit) horoscope — shows natal moon rashi, current transit house, and daily prediction with category ratings. Falls back to static zodiac rashifal if no birth profile.
Gochar View
9:41● ● ●
←
Horoscope
Your Natal Rashi
Vrishabha
Taurus · Rohini Nakshatra
Gochar House 7Moon in Virgo
Today's Transit
Moon transiting the 7th house brings focus to partnerships and collaborative ventures. A favorable day for negotiations.
Career ★★★★Love ★★★Health ★★★★★
Ask AI About This
09Kundli
Birth chart result screen — North Indian diamond-style chart via CustomPainter, planetary positions, and house details. Entry point for AI chat and matching.
Duration range100ms (micro) – 500ms (emphasis) – never over 700msEasingeaseOut (enter), easeIn (exit), easeInOut (move), elasticOut (emphasis only)Reduced motion@media prefers-reduced-motion: duration=0, no parallax, instant transitionsPerformanceOnly transform + opacity animated. Never animate layout properties.
Micro-Interactions
Page transitionSlideTransition + FadeTransition, 300ms, Curves.easeOutCubicCard pressScale 0.98 + opacity 0.7, 100ms, Curves.easeOutBottom sheetSlideTransition from bottom, 250ms, Curves.easeOutQuartChip selectBackground + border color cross-fade, 150ms, Curves.easeInOutTab switchIndicator slides to new tab, 200ms, Curves.easeOut. Content cross-fade 150ms.Like/heartScale up 1.3 → 1.0, 300ms, Curves.elasticOut. Color fill simultaneous.Pull to refreshCustom indicator: pr-colored circular progress, 60px trigger distanceSnackbarSlide up from bottom, 200ms. Auto-dismiss 4s. Swipe to dismiss.DialogFade + scale 0.95→1.0, 200ms. Backdrop fade to rgba(0,0,0,.5).Skeleton shimmerLeft-to-right gradient sweep, 1.5s, ease-in-out, infinite.
—Reusable State Patterns
Applied uniformly across all screens. Clean, minimal — no decorative elements in error or empty states.
Skeleton
Loading
Loading...
Empty
No Results
Nothing to show yet
Try Again
Error
Something went wrong
Check your connection
Retry
Offline
No Internet
Showing cached data
State Patterns — Per Module
LoadingCentered spinner (pr border-top, ol track, 32px, spin .8s). Caption below.SkeletonModule-shaped sk blocks: card skeleton for grids, list skeleton for feeds, chart skeleton for kundli.EmptyCentered: module icon (28px) + title (13px w600) + subtitle (11px tx3) + CTA button (bt-sm bt-tn).ErrorSame as empty but title in inaus color. "Retry" primary button.OfflineTop banner (sf-c, warn text, 10.5px w600). Body shows cached data or "Showing cached data" caption.
—Accessibility
WCAG 2.1 AA compliance targets. Every interactive element reachable, every state announced.
Contrast Ratios
Aa
Body text on bg
13.2:1 (dark) · 12.8:1 (light) — AAA
Aa
Text on primary
8.1:1 (dark) · 4.8:1 (light) — AA
Aa
Secondary text on surface
5.2:1 (dark) · 4.6:1 (light) — AA
Touch Targets
Min tap target48x48dp (M3 guideline)
Button height48dp primary, 36dp compact
List item height56dp minimum with 48dp icon region
Live regionsSnackbar, loading, error announcements
Exclude decorativeExcludeSemantics on shimmer, particles
Standards
Contrast (dark)#F0EDE6 on #060A14 = 16.8:1 (AAA). #9B978F on #060A14 = 6.2:1 (AA).Contrast (light)#2A2118 on #FBF8F3 = 14.1:1 (AAA). #6B5E50 on #FBF8F3 = 5.4:1 (AA).Touch targetsMinimum 44×44px for all interactive elements. List items 14px padding = 48px height.Focus states2px pr outline with 2px offset. Visible on all focusable elements.Screen readerSemantics: Kundli chart has Semantics(label: "Birth chart..."). All icons have tooltips.Text scalingSupport up to 2.0× system text scale. Layout must not break — use flexible containers.RTLUrdu, Arabic: mirror all layouts. Use Directionality widget. Padding/margin use start/end, not left/right.Reduced motionRespect MediaQuery.disableAnimations. Replace transitions with instant state changes.
E1Muhurat Center
12 life-event categories, each with best dates, time slots, checklists, FAQs, and AI suggestions. Pattern: category grid → detail with tabs.
Category Grid
9:41● ● ●
←
Muhurat Center
🔍
Find the perfect time for life's important moments
💍
Marriage
Vivah Muhurat
🚗
Vehicle
Vahan Muhurat
🏠
Property
Bhumi Muhurat
🏢
Business
Vyapar Muhurat
📚
Education
Vidya Muhurat
✈️
Travel
Yatra Muhurat
💰
Investment
Nivesh Muhurat
🏥
Medical
Chikitsa Muhurat
Muhurat Detail
9:41● ● ●
←
Marriage Muhurat
📤
Next Best Date
12 November 2026
Wednesday · 08:15 – 10:42
Shubh YogaRohini Nakshatra
Dates
Time Slots
Checklist
FAQ
12
NOV
Wednesday
08:15 – 10:42 · Rohini
Best
26
NOV
Wednesday
09:30 – 12:15 · Mrigashira
Good
04
DEC
Thursday
07:45 – 09:10 · Uttara
Fair
✦
AI Suggestion
Based on the bride and groom's nakshatras, November 12 has the strongest compatibility alignment. Consider morning muhurat for best results.
All Muhurat Categories
01Marriage (Vivah)
02Vehicle Purchase
03Property Purchase
04Housewarming (Griha Pravesh)
05Business Opening
06Education (Vidya Arambh)
07Travel (Yatra)
08Investment
09Medical Procedure
10Land Purchase
11Gold Buying
12Share Market
Detail Tab Structure (All Categories)
Tab 1: DatesChronological list with date block + nakshatra + quality badgeTab 2: Time SlotsHourly slots with auspicious/neutral/avoid color codingTab 3: ChecklistCheckbox list items — preparation steps for the eventTab 4: FAQExpandable accordion — common questions per categoryAI CardPinned below tabs — contextual AI suggestion using .cd-f patternRelatedHorizontal scroll of article cards below AI — links to Learning
Tabs: DefaultTabController with 4 tabs; lazy-load FAQ from assets JSON
E2Advanced Kundli
Full birth chart analysis with 3 chart styles, Navamsa, Dasha periods, Dosha analysis, and life-area predictions. Pattern: tabbed chart view → analysis sections.
Chart Styles
9:41● ● ●
←
Kundli
📤
Vrajal Modi
15 Mar 1997 · 08:30 · Ahmedabad
North Indian
South Indian
Western
Houses
Planets
Dasha
Dosha
Career
Finance
H1 Ascendant
Pisces · Me Ve
H4 Home
Gemini · Su
H7 Partnership
Virgo · Sa Ke
Ask AI
PDF Export
Dasha Timeline
9:41● ● ●
←
Mahadasha
Current Mahadasha
Jupiter
2019 – 2035 · 16 years
44% elapsed · 9 years remaining
Antardasha Periods
Ju
Jupiter–Jupiter
2019 – 2021
Passed
Sa
Jupiter–Saturn NOW
2024 – 2027
Active
Me
Jupiter–Mercury
2027 – 2029
Ke
Jupiter–Ketu
2029 – 2030
All Kundli Sub-Screens
01Birth Chart (North Indian)
02Birth Chart (South Indian)
03Birth Chart (Western)
04Navamsa (D9)
05Dasha Periods
06Mahadasha Timeline
07Transit (Gochar)
08Dosha Analysis
09Marriage Matching
10Career Prediction
11Finance Prediction
12Health Analysis
13Education Prediction
14Business Analysis
15Foreign Travel
16AI Summary
17PDF Export
Flutter Notes
Chart styles: KundliChartWidget already renders North Indian via CustomPainter. Add SouthIndianPainter (square grid) and WesternPainter (circular wheel).
Navamsa: Same KundliChartWidget with D9 house positions from SwephAstronomy
PDF: Use pdf package — render chart + planet table + dasha timeline to PDF, share via share_plus
Life predictions: Reusable PredictionCard widget with category icon, star rating, summary text. Data from GocharHoroscopeEngine extended with house-lord analysis.
E3AI Platform
Conversational AI across all domains — Panchang, Muhurat, Kundli, Rituals, Festivals, Sanskrit. Chat bubble pattern with suggested questions and voice.
AI Chat
9:41● ● ●
←
Jyotish Guru
🗑
Kundli AIPanchang AIMuhurat AIRitual Guide
✦
Namaste, Vrajal! Based on your Kundli, Jupiter in the 1st house gives you natural wisdom and optimism. How can I help you today?
What does my current Jupiter–Saturn dasha mean for career?
✦
Jupiter–Saturn antardasha (2024–2027) brings structured growth. Saturn disciplines Jupiter's expansiveness — expect steady career advancement through hard work rather than luck. This is excellent for...
Read more
Suggested
Marriage timing?Health outlookRemedy for Rahu
Ask Jyotish Guru...
🎤
AI Hub
9:41● ● ●
AI Assistant
⚙
✦
AI Kundli
Birth chart analysis & predictions
›
📅
AI Panchang
Explain today's panchang data
›
⏰
AI Muhurat
Find best times with reasoning
›
🙏
AI Ritual Guide
Step-by-step puja instructions
›
🪔
AI Festival Guide
Festival significance & rituals
›
🔤
Sanskrit Translator
Translate & explain shlokas
›
Recent Conversations
✦
Career outlook 2026
Kundli AI · 2 hours ago
›
🙏
Ganesh Puja guide
Ritual Guide · Yesterday
›
All AI Features
01AI Panchang
02AI Muhurat
03AI Kundli
04AI Ritual Guide
05AI Festival Guide
06AI Sanskrit Translator
07Conversation History
08Suggested Questions
09Voice Interaction
Chat Components
AI Bubblesf-c background, 4px/14px/14px/14px radius, ✦ avatar leftUser BubblePrimary fill, 14px/4px/14px/14px radius, right-alignedTyping3 pulsing dots in sf-c bubble, 350ms staggerVoiceMic button expands to waveform; 40px circular, sf-c fillSuggestedChip row below messages. ch class with category-specific promptsContext switchHorizontal chip bar below AppBar selects AI domain
E4Marketplace
Service marketplace: pandit booking, consultations, temple puja, astrologers, vastu, gemstones. Pattern: service grid → provider list → booking flow → reviews.
Service Hub
9:41● ● ●
Services
🔍
🙏
Pandit
📹
Video Consult
🛕
Temple Puja
⭐
Astrologer
🏠
Vastu
💎
Gemstones
Featured Providers
🙏
Pt. Ramesh Sharma
Ahmedabad · Puja, Havan
★★★★★(24)
Book
⭐
Dr. Meena Joshi
Mumbai · Astrology, Vastu
★★★★☆(42)
Book
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
Booking Flow
9:41● ● ●
←
Book Pandit
Pt. Ramesh Sharma
Ahmedabad · 15 years experience
Select Puja
Satyanarayan Puja
Duration: 2–3 hours
Griha Pravesh
Duration: 3–4 hours
Ganesh Puja
Duration: 1–2 hours
Preferred Date
📅Select date
Time Slot
MorningAfternoonEvening
Continue to Address
All Marketplace Screens
01Service Hub
02Book Pandit
03Video Consultation
04Temple Puja
05Home Puja
06Astrologer
07Vastu Consultant
08Numerologist
09Gemstones
10Booking Flow
11Reviews & Payments
Marketplace Components
Service cardsf-c icon area (48x48, 12px radius) + provider name + specialization + rating stars + Book btnProvider avatar48px circle, sf-c bg, centered initials (Georgia 16px w700) or imageRating displaypr-colored stars (12px) + count in parentheses (10.5px tx3)Booking statusBadge: bg-a (pending), bg-g (accepted/completed), bg-e (rejected/cancelled)Category grid2-col grid of service category cards, 56px icon + label below, sf bg with ol border
Translation: Dhritarashtra said — O Sanjaya, what did my sons and the sons of Pandu do when they assembled on the sacred field of Kurukshetra, eager to fight?
▶
0:422:15
← Prev
Next →
All Learning Screens
01Content Library (categories + search)
02Scripture Reader (shloka + translation)
03Audio Player (mantra playback)
04Bookmarks & Highlights
05Reading Progress
06Chapter Index (per scripture)
07Search Results (cross-scripture)
08Daily Shloka Card
Learning Components
Book card64x80 thumbnail (sf-c, 8px radius) + title + progress bar (3px, pr fill) + chapter infoShloka cardGeorgia serif 16px italic, center-aligned, Devanagari. Verse number below in tx3 caps.Audio playerPlay circle (36px, pr fill) + progress bar (3px) + time stamps (10px, tabular-nums)Bookmark itemStandard list item with shloka preview + chapter badge + timestamp
LayoutThumbnail (sf-c, 64×64, 12px radius) + title + duration + difficulty badgeTimerCircular progress ring (pr stroke, sf-c track). Center: remaining time. Bottom: play/pause.Temple cardMap pin icon + name + city + distance + rating. Same as Pandit card pattern.RoutineCheckbox list items with time slots. Progress ring in header showing % complete.
Beautiful Janmashtami celebration at our local ISKCON temple. The midnight aarti was mesmerizing!
♡ 42💬 8↗ Share
RP
Rajesh Patel
5 hours ago · Question
What is the significance of offering tulsi leaves to Vishnu? Is there a specific number recommended?
3 answers
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
All Community Screens
01Discussion Feed
02Questions (Q&A)
03Photos Gallery
04Events
05Challenges
06Badges & Achievements
07Leaderboards
08Temple Reviews
Community Components
Post cardAvatar (32px circle, sf-c) + name + timestamp. Body text 13px. Actions: heart + comment + share.Question badgebg-a badge showing answer count ("3 answers")Achievement badge56px circle, gradient bg, icon center. Title below. Locked = greyed out + lock icon.Event cardDate stamp left (day/month), title + location + attendees count. RSVP button right.Leaderboard rowRank (#1-3 pr color, rest tx3) + avatar + name + score. Top 3 get crown icon.
E9Watch Ecosystem
Companion for Nakshatraya wearable: dashboard, battery, firmware, accessories, warranty, repair, registration, gift packaging.
Watch Dashboard
9:41● ● ●
←
My Watch
⚙
⌚
Nakshatraya Watch
Connected · v2.1.4
Battery
78%
Steps
4,280
Sync
2m ago
Watch Features
🔔
Panchang Alerts
Tithi, nakshatra changes
🌅
Sunrise Haptic
Gentle vibration at sunrise
🕉
Mantra Reminder
Hourly mindfulness prompt
Quick Actions
🔄
Firmware Update
v2.1.5 available
New
🛍
Accessories
Bands, chargers, cases
›
🛡
Warranty
Valid until Dec 2027
›
All Watch Screens
01Watch Dashboard
02Battery & Health
03Firmware Update
04Accessories Store
05Warranty Status
06Repair Request
07Registration
08Gift Packaging
Watch Components
Watch card80px circle (sf-c, 3px ol border) icon center + name + status. Timing pills below.Battery indicatortp timing pill with color: aus (>50%), warn (20-50%), inaus (<20%)Feature toggleStandard li + sw switch. Section grouped in cd card.Firmware updatebg-a "New" badge on row. Progress bar during update (pr fill, 3px, animated).
Product card100px image area (sf-c, 10px radius) + title + subtitle + price (15px w700 pr) + Add btnCart badge14x14 circle, pr fill, on-pr text 8px w700, absolute top-right on cart iconPrice displayCurrent: 15px w700 pr. Strikethrough: 10px tx3 line-through. Discount badge: bg-a.Quantity stepperMinus + count + Plus in row, ol border, 32px height, 28px buttons
E11Premium
Subscription tiers, benefits, billing, member dashboard, exclusive content, founder sessions.
Paywall
9:41● ● ●
←
Premium
Unlock Everything
AI Kundli, advanced muhurat, ad-free experience, exclusive content, and more.
Monthly
Cancel anytime
₹149/mo
BEST VALUE
Annual
Save 40%
₹999/yr
₹1,788/yr
Lifetime
One-time payment
₹2,999
What You Get
✓Unlimited AI Kundli conversations
✓Advanced Muhurat Center
✓PDF Kundli export
✓Ad-free experience
✓Exclusive learning content
✓Founder sessions access
Start Free Trial — 7 Days
No charge until trial ends. Cancel anytime.
All Premium Screens
01Paywall (plan selection)
02Feature Comparison Table
03Member Dashboard
04Billing & Subscription Management
05Exclusive Content Hub
06Founder Sessions (live + recorded)
07Referral Program
Premium Components
Plan cardcd-p, 1.5px border (ol default, pr for selected). Price: 20px w700. Period: 12px tx3.Best value badgeAbsolute top-right, pr fill, on-pr text 9px w700, 4px radius, .06em spacingFeature checkaus color checkmark + 13px text. Horizontal row with 10px gap.Trial CTAFull-width bt primary, "Start Free Trial — 7 Days". Caption: 11px tx3 center.
E12Settings
Language, notifications, theme, accessibility, privacy, connected devices, support. Standard list pattern with section headers.
Settings
9:41● ● ●
Settings
Appearance
🌐
Language
English
›
🎨
Theme
System default
›
♿
Accessibility
Text size, contrast
›
Notifications
🔔
Push Notifications
Festivals, sunrise, vrat
›
Privacy & Security
🔒
Privacy
Data, analytics, permissions
›
Devices
⌚
Connected Devices
Nakshatraya Watch
Connected
Help
💬
Support
FAQ, contact, feedback
›
Version 2.4.0
All Settings Screens
01Settings Main
02Language Picker
03Theme Selection
04Accessibility Settings
05Notification Preferences
06Privacy & Data
07Connected Devices
08Support & FAQ
09About
Settings Components
Setting rowStandard li pattern: icon (li-ic) + title + subtitle + trailing (switch, chevron, or badge)Section headersl class: 11px w600 tx3, .08em letter-spacing, uppercase, 20px side paddingToggle switchsw class: 36x20 track, 16px thumb. On: pr fill. Off: ol stroke.Version labelCenter text, 11px tx3, below all sections. Dynamic via package_info_plus.
Responsive Rules
Four breakpoints govern layout across mobile, tablet, expanded, and desktop. Module-specific overrides listed below.
Mobile <600px
4-tab bottom nav. Single column. Full-width cards. 20px horizontal padding. Category grids: 2 columns.
Tablet 600–839px
Bottom nav persists. Category grids: 3 columns. Product grids: 3 columns. Store/Commerce: 3-col. Master-detail on chat.
Expanded 840–1199px
NavigationRail (80px). Category grids: 4 columns. Master-detail: list left, detail right. Chat: sidebar history + main chat.
Desktop 1200px+
NavigationDrawer (256px). Category grids: 4-6 columns. 3-column dashboard. Body content max 1000px centered.
Module-Specific Breakpoints
Muhurat grid2 → 3 → 4 columns at 600 / 840 / 1200Kundli chartFull width mobile → 50% with analysis panel on tablet+ → side-by-side with Navamsa on desktopAI ChatFull screen → conversation history sidebar at 840+ → 3-pane (history + chat + context) at 1200+Commerce grid2 → 3 → 4 → 5 columns. Product card image scales proportionally.Learning readerFull width → max 680px centered with side navigation at 840+ → TOC sidebar at 1200+Community feedFull width → max 600px centered → feed + trending sidebar at 1200+Premium paywallStacked plans → side-by-side 3-column plans at 840+ → with feature comparison table at 1200+
Flutter Implementation
How design tokens map to Flutter Material 3 colorScheme and architecture patterns for each module.
Token Mapping
--bgcolorScheme.surface (M3) or scaffoldBackgroundColor--sfcolorScheme.surfaceContainer--sf-ccolorScheme.surfaceContainerLow--prcolorScheme.primary--pr-ccolorScheme.primaryContainer--txcolorScheme.onSurface--tx2colorScheme.onSurfaceVariant--aus / --inausCustom extension: AppColors.auspicious / AppColors.inauspicious
Architecture per Module
Structurelib/features/{module}/ — data/, domain/, presentation/ (clean arch slice)Stateflutter_bloc for each module. Events → Bloc → States. Equatable states.DIGetIt manual registration in injection.dart. LazySingleton for services.RoutesGoRouter nested under ShellRoute. Deep-link safe paths with path params.L10nAll strings via AppLocalizations. ARB keys per module prefix (muhurat_, kundli_, ai_).
Per-Module Implementation Notes
MuhuratMuhuratBloc, PanchangEngine + KalamCalculator. Caches via SQLite. Category enum.KundliKundliBloc, SwephAstronomy FFI (skip: native test), KundliCalculator. CustomPainter chart.AI PlatformKundliChatBloc, GeminiService/OpenAiService switchable. SQLite history, ConnectivityService stream.MarketplacePanditBookingBloc, Hana backend. Filter model + search. Ownership via pandit_owner_id column.FestivalFestivalBloc, FestivalEngine + FestivalLocalDataSource. Seed v9. Dynamic tithi calculation.LearningContentBloc, local asset reader + audio_player for mantra playback. Bookmark persistence to SQLite.LifestylePer-feature blocs (MeditationBloc, YogaBloc). Timer service for guided sessions. Checklist local storage.CommunityFeedBloc + PostBloc. Paginated feed (cursor-based). Image upload via Hana storage. Real-time via FCM.WatchWatchBloc, Bluetooth LE service. Firmware OTA via background isolate. State sync on reconnect.CommerceCartBloc + OrderBloc. Razorpay/UPI integration. Order model with status enum. Wishlist local cache.PremiumSubscriptionBloc, in_app_purchase + RevenueCat. Entitlement check gates features. Receipt validation server-side.SettingsExtends existing SettingsScreen. ThemeBloc + LanguageBloc. Notification toggles → NotificationScheduler.rescheduleAll().
How Krishna's birth is celebrated from Mathura to Dwarka.
8 min read · Festival🔖
💎
Gemstone Remedies: What Vedic Astrology Actually Says
Separating tradition from marketing when choosing a remedy stone.
6 min read · Remedies🔖
☀
Home
📅
Calendar
🪔
Festival
⋯
Other
Article Detail
9:41● ● ●
←
Article
↗
Panchang
Why Rahu Kaal Matters More Than You Think
5 min read · Updated 2 days ago
Rahu Kaal is one of the most misunderstood periods in daily Panchang. Rather than avoiding all activity, the tradition specifically flags it for new beginnings — starting a journey, signing a contract, or a first day at work...
🔖 Save↗ Share💬 4 comments
All Blog Screens
01Blog Feed
02Article Detail
03Categories
04Bookmarks
05Search Results
06Trending
07Share
Blog Components
Article card64×64 thumbnail (sf-c, 10px radius) + title (13px w600) + 2-line excerpt (11px tx3) + read-time caption + bookmark iconCategory chipStandard ch/ch-on row, horizontal scroll below AppBarArticle readerCategory chip + Georgia headline (20px) + body 13px/1.7 + save/share/comments rowBookmark stateBookmark icon fills pr color when saved, tx3 outline when not
E14Notifications Center
Notification history and settings in one place. Users need to see past notifications and manage every reminder type from a single hub.
History
9:41● ● ●
←
Notifications
⚙
History
Settings
Today
🪔
Janmashtami in 18 days
Festival reminder
9:00 AM
🌅
Sunrise at 06:12
Sunrise alert
6:12 AM
🌙
Shukla Ekadashi vrat today
Vrat reminder
5:30 AM
Yesterday
📅
Today's panchang is ready
Daily update
6:00 AM
📖
New article: Gemstone Remedies
Blog
2:14 PM
Earlier
🌇
Sunset at 19:24
Sunset alert
Mon
Settings
9:41● ● ●
←
Notifications
History
Settings
Reminder Types
🪔
Festival Reminders
Evening + day-of alerts
🌅
Sunrise Alerts
30-day rolling schedule
🌇
Sunset Alerts
30-day rolling schedule
🌙
Vrat Reminders
Per-vrat toggle
📖
Blog Updates
New articles weekly
All Notification Screens
01Notification History
02Notification Settings
03Festival Reminders
04Vrat Reminders
Notification Components
Grouped listsl date-group headers (Today / Yesterday / Earlier) + cd list of li rowsNotification rowli-ic icon + title + type caption + trailing timestamp (li-tr)Settings rowStandard li + sw switch, one per NotificationScheduler-backed serviceBacking servicesMaps 1:1 to FestivalNotificationService, Sunrise/Sunset/Moon/VratNotificationService
E15Search
Global search across the entire app — festivals, panchang terms, articles, and pandits. Reached from the Home Dashboard search icon.
Search fieldtf class, full-width, 🔍 leading icon, autofocus on openResult rowli-ic + title + subtitle + trailing type badge (bg-g/bg-a) grouped under sl section headers by result typeEmpty stateStandard empty pattern: "Search festivals, panchang terms, articles..." caption + module iconDebounce300ms debounce on input; queries local SQLite (festivals, panchang terms) + Hana (pandits, articles) in parallel
E16User Dashboard
Distinct from Profile — this is about saved content, history, downloads, and achievements. Reached from Profile.
Saved
9:41● ● ●
←
My Dashboard
Saved
History
Downloads
Achievements
Saved Kundli Charts
✦
Vrajal Modi
15 Mar 1997 · Ahmedabad
›
Saved Muhurat Dates
⏰
Marriage Muhurat — 12 Nov 2026
Best · 08:15 – 10:42
›
Bookmarked Festivals
🪔
Janmashtami
Fri, 15 Aug 2026
›
Achievements
9:41● ● ●
←
My Dashboard
Saved
History
Downloads
Achievements
🔥
7 Day Streak
🙏
12 Vrats Kept
🔒
Kundli Master
🔒
30 Day Streak
All Dashboard Screens
01Dashboard Overview
02Saved Items
03History
04Downloads
05Achievements
06Badges
Dashboard Components
Tab barSame tab pattern as Kundli/Muhurat detail tabs — horizontal scroll on overflowSaved item rowStandard li pattern per content type (Kundli, Muhurat, Festival)Badge grid3-column grid, 56px circle (gradient = earned, sf-c + 🔒 + opacity .4 = locked) + label belowDownloads rowli with 📄 icon + report name + date + trailing download/share icons
E17Referral Program
Invite friends, earn rewards. Reached from Profile — referral code, rewards balance, coupons, and a leaderboard.
Invite & Earn
9:41● ● ●
←
Invite Friends
Your Referral Code
NAKSH2026
Both of you get 30 days of Premium free
Share Invite Link
Your Rewards
Credits
₹450
Coupons
2
Referrals
6
Leaderboard
9:41● ● ●
←
Leaderboard
👑
AS
Ananya Sharma
24 refs
2
RP
Rajesh Patel
19 refs
8
VM
You
6 refs
All Referral Screens
01Referral Home
02Invite Friends
03Rewards
04Coupons
05Wallet
06Leaderboard
Referral Components
Code cardGradient cd-p (sf → pr-c), dashed pr border code chip, Georgia 26px letter-spacedReward pillsStandard tp timing-pill row repurposed for Credits / Coupons / ReferralsLeaderboard rowRank (crown for #1, tx3 number otherwise) + avatar + name + count. Current user row gets pr-c background highlight.
E18Support & Feedback
WhatsApp support, feedback, and bug reporting. Reached from Settings — help center with FAQ and direct contact options.
Help Center
9:41● ● ●
←
Help & Support
💬
WhatsApp
✉️
Email
📞
Phone
Frequently Asked
Getting Started
›
Panchang
›
Kundli
›
Notifications
›
Premium
›
Feedback
9:41● ● ●
←
Send Feedback
How would you rate your experience?
★★★★☆
Tell us more — what worked, what didn't...
Submit Feedback
Report a bug instead →
All Support Screens
01Help Center
02FAQ
03Contact Us
04Feedback
05Bug Report
Support Components
Contact tile3-column cd-p grid, 22px emoji icon + 11px label, launches WhatsApp/mailto/tel intentsFAQ accordionStandard li rows with chevron; expands inline on tap, one section open at a timeRating stars26px star row, pr color filled, tap to set 1–5 ratingFeedback formtf multiline text area + full-width bt submit; bug report reuses same form with device/version metadata auto-attached
38 Sections · 159+ Screens · 1 Design System
Phase 1 core · Phase 2 ecosystem · Roadmap-grounded new modules · Clean · Calm · Trustworthy · Modern