Weatheria - Intelligent Weather Prediction Platform 🌤️

Welcome to Weatheria, an innovative weather prediction application that harnesses the power of NASA's historical weather data to provide accurate future weather forecasts. Our unique approach analyzes a decade of historical weather patterns to deliver precise predictions.

🌐 Live Demo

Experience Weatheria in action: Live Demo

🌍 What Makes Weatheria Unique?

Weatheria stands out from traditional weather apps by:

• Analyzing 10 years of NASA's historical weather data for predictions
• Providing pattern-based forecasts using NASA's POWER API
• Offering detailed insights based on comprehensive historical analysis
• Delivering location-specific weather predictions with high accuracy

🎯 Core Features

• 📍 Precise location-based weather predictions
• 📅 Future date weather forecasts using historical patterns
• 📊 Interactive weather visualization charts
• 🔍 Detailed weather insights and analysis
• 📈 Historical weather pattern recognition
• 📱 Responsive design for all devices
• 📝 Comprehensive weather reports

🚀 Features

Location Selection

• Interactive Map: Drop a pin anywhere on the globe using Leaflet maps
• Search Function: Type location names for quick selection
• Real-time coordinates display

Weather Analysis

• Fetches historical data from NASA POWER API
• Parameters analyzed:
  • Temperature (°C)
  • Precipitation (mm/day)
  • Wind Speed (m/s)
  • Relative Humidity (%)
  • Surface Pressure (kPa)

Visualizations

• Interactive time-series charts
• Temperature trends
• Precipitation patterns
• Wind speed analysis
• Humidity variations

Predictions & Insights

• AI-driven weather predictions based on historical patterns
• Confidence levels and uncertainty ranges
• Risk assessment (Low/Moderate/High/Extreme)
• Extreme event probability calculations
• Personalized safety recommendations

Report Generation

• PDF Export: Professional formatted reports with charts
• Text Export: Detailed analysis in readable format
• Includes all metrics, predictions, and recommendations

🛠️ Technology Stack

• Frontend: React + TypeScript + Vite
• UI Framework: Shadcn/UI + Radix UI
• Styling: Tailwind CSS
• Data Management: TanStack Query
• Data Source: NASA POWER API
• Backend: Supabase
• Date Utilities: date-fns
• Build Tool: Bun

📦 Local Development Setup

Prerequisites

• Node.js (v16 or higher)
• Bun (Latest version)
• NASA API Key (Get it here)

Installation Steps

1. Clone the repository

   git clone https://github.com/Supra-tim/Weatheria.git
   cd Weatheria

2. Install dependencies

   bun install

3. Configure environment variables Create a .env file in the root directory:

   VITE_NASA_API_KEY=your_nasa_api_key_here
   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Start development server

   bun run dev

The app will be available at http://localhost:5173

� Production Build

To create a production build:

bun run build

To preview the production build locally:

bun run preview

📖 How to Use

1. Select Location

   • Use the location selector to input coordinates
   • System automatically validates the location

2. Choose Date

   • Select a future date for prediction
   • The system analyzes 10 years of historical data for the selected date

3. View Analysis

   • System processes NASA's historical weather data
   • View detailed weather predictions and patterns
   • Explore interactive charts and insights
   • Generate comprehensive weather reports

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License.

---

Built with ❤️ by Supra-tim

4. Review Results

   • Interactive charts show historical trends
   • Prediction card displays forecasted conditions
   • Insights panel provides risk assessment

5. Download Report

   • Choose PDF for formatted report with charts
   • Choose Text for detailed analysis document

🎨 Design System

Weatheria uses a professional NASA-inspired color palette:

• Primary: Deep blue (#1E40AF)
• Accent: Vibrant orange (#F97316)
• Gradients: Custom space-themed gradients
• Charts: Color-coded for each weather parameter

📊 Data Analysis Methodology

1. Historical Data Collection: Fetches 10+ years of data for selected location
2. Statistical Analysis: Calculates means, standard deviations, trends
3. Pattern Recognition: Identifies seasonal patterns and anomalies
4. Prediction Generation: Uses statistical methods to predict future conditions
5. Risk Assessment: Evaluates extreme event probabilities

🔒 Security

• NASA API key is securely stored
• No user data collection
• All processing happens client-side
• HTTPS enabled for production

🚢 Deployment

# Build for production
npm run build

# Deploy to your preferred hosting provider (Netlify, Vercel, Cloudflare Pages, or your own server)

📱 Browser Support

• Chrome (recommended)
• Firefox
• Safari
• Edge

🤝 Contributing

This is a NASA Space Apps Challenge project. For contributions:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

📄 License

This project is part of the NASA Space Apps Challenge.

🔗 Resources

• NASA POWER API Documentation
• GES DISC OPeNDAP
• Giovanni Data Portal
• Worldview Imagery

👥 Credits

Developed for NASA Space Apps Challenge by team: Cosmo-Voyager.

📧 Support

For issues or questions, please open an issue in the repository.

---

Built with ❤️ for NASA Space Apps Challenge