1. Project Overview
Project Title: WeatherAI – Smart Weather Forecast & AI Assistant
Objective: Build a full-stack website where users can search for a city, view live weather and forecasts, save favourite locations, and ask an AI assistant questions about the weather.
Problem It Solves
Weather information is often spread across multiple screens and can be difficult to interpret. WeatherAI brings forecast details and simple, conversational explanations together in one unified, interactive interface.
Project Scope Summary
Prepared as a mini-project concept and development plan for BTech CSE students, fulfilling requirements for modern frontend, API integration, database schemas, and AI assistance.
2. Technology Stack
| Technology |
Role in the Project |
| HTML5 | Semantic page structure and accessible content. |
| CSS3 | Layout, responsive styling, visual glassmorphism effects and animations. |
| JavaScript / WebGL | Application logic, events, Three.js 3D rendering and API response handling. |
| React.js | Reusable frontend components and interactive dashboard. |
| Node.js | JavaScript runtime for the server. |
| Express.js | Backend routes, API requests and server-side logic. |
| MySQL | Persistent storage for users, favourites and search history. |
| Weather API | Live conditions and forecast data via Open-Meteo. |
| AI API | Natural-language weather explanations and practical recommendations. |
3. Main Features
• Live weather: Show current temperature, weather condition and key measurements.
• 7-day forecast: Display expected conditions for the next seven days.
• Hourly forecast: Show how temperature and conditions change during the day.
• City search: Find a location and retrieve its weather information instantly.
• Weather details: Display humidity, wind speed, wind direction, and UV index.
• Search history: Save previously searched cities for quick access.
• AI weather assistant: Answer natural-language questions about the forecast.
• Smart suggestions: Practical prompts such as carrying an umbrella or clothing tips.
• Dark/light mode: Allow users to customize dashboard appearance.
4. System Architecture
The React frontend communicates with the Node.js/Express backend. The backend retrieves weather data from a weather provider, sends suitable context to the AI provider, and reads or writes user information in MySQL.
5. MySQL Database Design
Relational schema mapping users, search history, and favorite locations:
user_id PKINT AUTO_INCREMENT
nameVARCHAR(100)
emailVARCHAR(255) UNIQUE
password_hashVARCHAR(255) (Bcrypt)
created_atDATETIME DEFAULT NOW
search_id PKINT AUTO_INCREMENT
user_id FKINT (ref Users)
cityVARCHAR(100)
searched_atDATETIME DEFAULT NOW
favorite_id PKINT AUTO_INCREMENT
user_id FKINT (ref Users)
cityVARCHAR(100)
created_atDATETIME DEFAULT NOW
6. API Integration
Weather Data: Open-Meteo API
Open-Meteo is a proven provider for forecast and geocoding data. Its standard forecast access can be used without a key for non-commercial projects, providing hourly forecasts, 7-day outlooks, and minute-by-minute solar angles.
AI Assistant: OpenAI / Natural Language API
An AI API generates conversational explanations and tailored advice. The API key is stored securely in environment variables on the backend, preventing exposure in client-side code.
Suggested Request Flow
User searches city ➔ Backend resolves geolocation ➔ Backend requests weather data ➔ Frontend renders 3D Globe & Dashboard ➔ User asks AI assistant to interpret conditions.
7. Seven-Day Development Plan
Day 1
Set up React, HTML structure & CSS styling
Result: Basic responsive dashboard.
Day 2
Connect weather and geocoding API
Result: City search and live weather telemetry.
Day 3
Create Node.js and Express backend routes
Result: Backend API working with route validation.
Day 4
Set up MySQL and connect backend
Result: Persistent search history and user favourites.
Day 5
Integrate AI assistant through backend
Result: Context-aware weather Q&A feature.
Day 6
Add 3D globe, animations, theme switch & mobile layout
Result: Polished user interface with interactive 3D WebGL.
Day 7
Test, fix issues and prepare documentation
Result: Demo-ready BTech CSE mini-project.
8. Final Deliverables & Project Scope
✔️ Complete frontend source code with Three.js 3D Earth Globe and Weather Particles.
✔️ Node.js / Express backend architecture & Python server runner.
✔️ MySQL schema for Users, Search_History, and Favorites.
✔️ Open-Meteo REST API integration for live global forecasts.
✔️ AI Assistant with contextual suggestions and natural-language Q&A.
✔️ Comprehensive project documentation and system architecture diagrams.