A modern web application inspired by Astra Life Advice, providing AI-powered life guidance through astrological insights. Built with React, TypeScript, and Material-UI.

• AI-Powered Advice: Get personalized guidance on relationships, career, personal growth, and more
• Compatibility Analysis: Discover cosmic connections with others through detailed compatibility reports
• Dream Interpretation (Premium): Unlock the mysteries of your subconscious mind
• Astrological Insights: Personalized cosmic guidance based on birth chart data
• User Onboarding: Seamless setup process to create your astrological profile

• Unlimited AI advice questions
• Advanced dream interpretation with symbol analysis
• Detailed compatibility reports
• Priority customer support
• Export reports as PDF
• Early access to new features

• Node.js 16+
• npm or yarn

1. Clone the repository:

git clone <repository-url>
cd LunaScopeAI

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

4. Open your browser and navigate to http://localhost:3000

• React 18 - UI framework
• TypeScript - Type safety
• Material-UI (MUI) - Component library
• Framer Motion - Animations
• Zustand - State management
• React Router - Navigation
• Vite - Build tool

The app integrates with existing astrology libraries:

• Kerykeion - Python astrology library for calculations
• AstroChart - JavaScript chart generation

src/
├── components/           # Reusable UI components
│   ├── common/          # Common components (Navbar, Sidebar)
│   ├── charts/          # Astrology chart components
│   ├── advice/          # Advice-related components
│   ├── onboarding/      # User onboarding components
│   └── subscription/    # Subscription components
├── pages/               # Main application pages
├── services/            # API and business logic
├── store/               # Zustand store configuration
├── types/               # TypeScript type definitions
├── utils/               # Utility functions
└── assets/              # Static assets

• HomePage - Landing page with features and testimonials
• OnboardingPage - Multi-step user registration and profile setup
• DashboardPage - Main user dashboard with quick actions
• AdvicePage - AI-powered advice system with category selection
• CompatibilityPage - Relationship compatibility analysis
• DreamsPage - Dream interpretation (Premium feature)
• SubscriptionPage - Pricing and subscription management
• ProfilePage - User profile and settings management

• AIService - Mock AI service for generating advice, dream interpretations, and compatibility analysis
• Store Management - Zustand-based state management for user data, advice history, and app state

• 8 advice categories: Relationships, Career, Personal Growth, Health, Finance, Spirituality, Family, Dreams
• Contextual question input with category-specific guidance
• Astrological insights integrated with AI responses
• Action steps and related topics for each advice session
• Complete advice history with expandable details

• Partner information input (name, birth date, time, location)
• Overall compatibility scoring (0-100%)
• Category breakdown: Romantic, Friendship, Business, Communication
• Strengths and challenges identification
• Personalized advice for relationship improvement
• History of previous compatibility analyses

• Dream recording with title, description, date, and emotions
• AI-powered symbol recognition and interpretation
• Main themes identification
• Emotional significance analysis
• Life connections and reflection points
• Dream journal with search and filtering

• Responsive design for all screen sizes
• Dark theme with cosmic gradient accents
• Smooth animations and transitions
• Progressive onboarding experience
• Intuitive navigation with collapsible sidebar

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run test - Run tests
• npm run lint - Lint code
• npm run type-check - TypeScript type checking

The app uses Zustand for state management with persistence:

interface AppState {
  user: User | null;
  isAuthenticated: boolean;
  adviceRequests: AdviceRequest[];
  adviceResponses: AdviceResponse[];
  dreams: Dream[];
  compatibilityAnalyses: CompatibilityAnalysis[];
  // ... actions
}

Currently uses mock AI services that simulate real API calls:

• 2-5 second response delays
• Realistic response generation
• Category-specific advice templates
• Astrological insight generation

• Primary: Purple (#8B5CF6) - Spiritual, mystical
• Secondary: Amber (#F59E0B) - Cosmic energy, warmth
• Background: Dark navy (#0F0F23) - Night sky
• Surface: Dark purple (#1A1A2E) - Depth

• Headers: Playfair Display (serif) - Elegant, mystical
• Body: Inter (sans-serif) - Modern, readable

• Glass morphism effects with backdrop blur
• Gradient borders and backgrounds
• Subtle animations and micro-interactions
• Consistent spacing and layout grid

npm run build

The build folder will contain the optimized production files.

Create a .env file for configuration:

VITE_API_URL=your_api_url
VITE_STRIPE_PUBLIC_KEY=your_stripe_key

• Real AI API integration (OpenAI, Claude, etc.)
• Payment processing (Stripe/PayPal)
• Social features and community
• Mobile app (React Native)
• Advanced chart visualizations
• Transit predictions and alerts
• Personalized daily horoscopes
• Voice-powered dream recording

• Real-time notifications
• Offline support with PWA
• Advanced caching strategies
• Performance optimizations
• Accessibility improvements
• Multi-language support

This project is licensed under the MIT License - see the LICENSE file for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

For support and questions:

• Create an issue in the repository
• Contact: [email protected]

Built with ❤️ and cosmic energy ✨