Development Roadmap
Track our progress and see what's coming next
Last updated: Jan 2, 2026 - v1.1.0 Learning Center & Navigation Enhancement
Version History
v1.1.0- Learning Center & Navigation Enhancement
Jan 2, 2026- Ten Gods (十神) comprehensive section - all 10 gods with traits & careers
- Heavenly Stems (天干) detailed section - all 10 stems Yin/Yang
- Earthly Branches (地支) section - all 12 branches by season
- Day Master Strength (日主強弱) analysis guide
- Branch Combinations (地支合沖) - Clashes, Harmonies, Three Combos
- Stem Combinations (天干合) transformation guide
- CollapsibleSection component with priority-based styling
- SectionNav floating navigation with scroll tracking
- QuickSummaryDashboard sticky summary bar
- Section config with localStorage persistence
- Calculator results: 10 collapsible sections with navigation
- Comprehensive UX/UI & Market Demographic audit
v1.0.0- Navigation & User Flow Overhaul
Dec 30, 2025- Simplified navigation (5 user-focused tabs: Home, AI, My Charts, Calendar, Learn)
- Settings dropdown for dev tools (Sandbox, Roadmap)
- My Charts page with favorites, search, filters
- Returning user detection with skip landing option
- Quick access bar for returning users
- Footer links for developer tools
- Mobile-responsive navigation with horizontal scroll
- Chart loading from My Charts page
v0.9.0- B2C UX & Monetization
Dec 30, 2025- Usage limits service (3 free readings)
- Pricing tiers (Basic, Premium $9.99/mo, Lifetime $49.99)
- Pricing modal component
- Usage banner & paywall overlay components
- Integrate usage limits into Chat page
- Skeleton loading components
- AI typing indicator
- Testimonials section
- Reading counter & trust badges
- Form validation UX (progress bar, real-time feedback, auto-focus)
- Landing page with Hero, Stats, How It Works, Features, CTA
v0.8.0- Epic 1 Full Reading Features
Dec 29, 2025- PRD.md with Epic 1 & 2 requirements
- Element Knowledge Base (colors, directions, seasons)
- Golden Pillar Time analysis
- BaZi Color Theory section
- FAQ Section with self-reflection quiz
- Wealth/Billionaire Potential analysis
- Partner Compatibility analysis
- Relationship Stability analysis
- Monthly DO/DON'Ts calendar (Epic 2)
- Daily Element Visualization (Epic 2)
v0.7.0- Simple Reading View & UX Improvements
Dec 29, 2025- Simple Reading View (one-page summary)
- Four Pillars mini display in header
- Stars calculation for Luck Pillars
- View mode toggle (Simple/Detailed)
- Element Balance quick view
- Day Pillar Spirit/Mascot display
- Enhanced Luck Pillar with progress bar
- Key Insight callout box
- UX Iteration Round 1
- UX Iteration Round 2
v0.6.0- Branch Relationships & Symbolic Stars
Dec 28, 2025- Branch Relationships KB complete (Clashes, Harmonies, Harms, etc.)
97b8996 - Symbolic Stars database (40+ stars with calculations)
- Integrate clashes/stars into Calculator UI
- Ten Gods Deep Knowledge Base (all 10 gods)
v0.5.0- Foundation Complete
Dec 28, 2025- Fix Hidden Stems Root Qi data
588684a - Add verification tests for all calculations
0dcac41 - Complete 60 Jiazi Pillars (100%)
e0a6a37 - Add ROADMAP.md tracking
43f40d0
v0.4.0- Pokemon Gallery
Dec 28, 2025- All 60 Jiazi Pillars with mascots, personalities, careers
- Pokemon-style gallery on Learning page
- CTA buttons between Learning and Calculator
v0.3.0- Core Calculator
Earlier- BaZi Calculator with JDN formula
- Ten Gods calculation (10/10)
- Twelve Phases calculation
- Hidden Stems data (all 12 branches)
- Solar Terms calculation
- Luck Pillars calculation (9 pillars)
Currently Working On
Now — an accurate chart, free
The calculation everything else rests on. Free, and it stays free.
Now — your Storybook
One chart, written as a book you keep. The depth behind the free reading.
Next — the calendar
Your own timing, month by month. After the book is good.
Later — name reading
What your name adds to your chart. Built, and parked until the book is done.
Later — teams and reviews
Reading a team the way you read a person. A different job, so it waits its turn.
Not building — the AI chat
A chatbot guesses, and a wrong guess about a person is worse than no answer. Removed on purpose.
Completed Features
Simplified navigation (5 user-focused tabs)
My Charts page with favorites, search, filters
Returning user detection with skip landing option
Settings dropdown for dev tools
Mobile-responsive navigation
Landing page with Hero, Stats, How It Works, Features, Testimonials, CTA
Form validation UX with progress bar and real-time feedback
Auto-focus on first field with animated validation states
Smart date validation (days in month)
Usage limits service (3 free readings tracking)
Pricing tiers (Basic free, Premium $9.99/mo, Lifetime $49.99)
PricingModal component with beautiful B2C design
UsageBanner component (shows remaining free readings)
PaywallOverlay component for premium content gates
Usage limits integrated into Chat page
Skeleton loading components (TypingIndicator, MessageSkeleton)
AI typing indicator with bouncing dots animation
Testimonials section with mini testimonial card
Reading counter with 12,800+ social proof
Trust badges (Secure, Expert, Verified)
Golden Pillar Time analysis (best luck periods)
BaZi Color Theory (lucky colors, directions, seasons)
FAQ Section with 10-question self-reflection quiz
Wealth/Billionaire Potential analysis
Element Knowledge Base (5 elements comprehensive data)
Simple Reading View (one-page summary)
View Mode Toggle (Simple/Detailed)
Four Pillars mini display in header
Day Pillar Spirit/Mascot display
Element Balance quick view
Current Luck Pillar with progress bar
Key Insight callout box
Stars calculation for Luck Pillars
Four Pillars (Year, Month, Day, Hour)
Ten Gods (十神) - all 10 relationships
Hidden Stems (藏干) - all 12 branches (fixed)
Twelve Phases (十二長生) - all cycles
Na Yin (納音) - 60 Jiazi sounds
Luck Pillars (大運) - 9 pillars
60 Jiazi Pillars with mascots & personalities
Branch Relationships (六沖, 六合, 三合, etc.)
Symbolic Stars (40+ stars with calculations)
Calculator UI with clashes & stars display
Ten Gods Deep Knowledge Base (all 10 gods)
Pokemon-style gallery on Learning page
True Solar Time adjustments
Equation of Time corrections
Element distribution analysis
Day Master strength calculation
Yong Shen (用神) analysis
Beautiful modern UI with animations
Responsive design for mobile and desktop
Planned Features
Famous People Database (50+ birth charts)
Pillar Lore & Stories
Detailed Reading UI (post-calculation)
Annual Pillars (流年) analysis
Monthly Pillars (流月) for precise timing
Special Chart Structures (从格, 化气格)
Chart comparison mode (synastry)
PDF export for professional reports
Multi-language support (EN/中文)
Mobile app (iOS & Android)
# Dev Notes - Branch Relationships
六沖 Clashes: 子↔午, 丑↔未, 寅↔申, 卯↔酉, 辰↔戌, 巳↔亥 六合 Harmonies: 子丑→土, 寅亥→木, 卯戌→火, 辰酉→金, 巳申→水, 午未→火 三合 Frames: 申子辰→水, 寅午戌→火, 亥卯未→木, 巳酉丑→金 三會 Seasonal: 寅卯辰→木, 巳午未→火, 申酉戌→金, 亥子丑→水