🤖✨ Good News by Place & Time

An AI-powered frontend platform that delivers positive news based on a selected location 📍 and year 🕰️. Powered by Google AI Studio (Gemini), this app explores historical timelines and surfaces good news with real sources — because the world has always had hope 🌍💛

---

🌟 What This App Does

• 🗺️ Pick any location on an interactive map
• 🕰️ Choose a year from history
• 🤖 Fetch positive / good news from that place and time using Google AI Studio
• 📰 View summaries with real article sources
• 📱 Fully mobile-first & responsive
• 🎨 Calm, modern, premium UI

No mock data. Real AI-powered insights.

---

🧠 Powered By

• Google AI Studio (Gemini) – timeline-aware AI responses
• Next.js (React) – frontend framework
• Tailwind CSS – styling
• Framer Motion – smooth animations
• Google Maps / Mapbox – location selection

---

🚀 Getting Started

1️⃣ Clone the Repository

git clone <your-repo-url>
cd good-news-by-place-time

---

2️⃣ Install Dependencies

Make sure Node.js is installed, then run:

npm install

---

3️⃣ Setup Environment Variables

Create a .env.local file and add your Google AI Studio API key:

NEXT_PUBLIC_GEMINI_API_KEY=your_google_ai_studio_api_key

🔐 Never commit your API key.

---

4️⃣ Run the App

npm run dev

Open your browser and go to:

http://localhost:3000

---

🧭 How It Works (Flow)

1. User selects a location 📍 on the map

2. User selects a year 🕰️

3. Frontend sends a prompt to Google AI Studio (Gemini)

4. Gemini returns:

   • Positive news summaries
   • Real article sources

5. UI displays results as beautiful, readable cards

---

⚠️ Disclaimer

• News summaries are AI-generated
• Sources are provided by Google AI Studio
• Content accuracy depends on available historical data

---

✨ Why This Project?

In a world full of breaking news and negativity, this app focuses on hope, progress, and positivity — grounded in real history.

Good news exists. Sometimes we just need to look for it.

---

👨‍💻 Author & Architect

Paras Panchal 🧠 Concept • Architecture • UI Vision

This project is an original idea designed and architected by Paras, combining AI, history, and human-centered design.

---

🛠️ Future Enhancements

• ⭐ Save favorite stories
• 🌐 Shareable links
• 📊 Multiple news results per year
• 🎙️ Voice-based exploration

---

Just say the word 🚀