Final Submission: 🇮🇳 Bharat Pulse: The Living Dashboard of India’s Growth

README.md

@@ -1,289 +1,108 @@
-# 🌍 Let's Code Development Challenge: Decoding Development 🚨
-## A Data-Driven Dashboard for National Growth Metrics
-
-Welcome to our internal community coding challenge! Build an interactive dashboard that visualizes and analyzes national growth metrics across cities worldwide.
-
----
-
-## 📋 Problem Statement
-
-### Title
-**"Decoding Development: A Data-Driven Dashboard for India Growth Metrics"**
-
-### Background
-Every nation's progress depends not on one factor but on a blend of economic, social, and environmental indicators. Understanding this data holistically can drive better policy-making, awareness, and decision-making.
-
-### Objective
-Design and develop an interactive data dashboard or application that visualizes and analyzes multiple national growth metrics for various cities. The platform should allow users to explore, compare, and interpret how different cities are performing across a comprehensive set of development indicators.
-
----
-
-## ✅ Required Features
-
-### Core Data Visualization (30+ Metrics)
-Your dashboard must collect and visualize the following metrics across cities:
-
-**Economic Indicators:**
-- GDP (Gross Domestic Product)
-- GNI (Gross National Income)
-- GDP per Capita
-- Unemployment Rate
-- Inflation Rate
-- Foreign Direct Investment
-- Export/Import Ratios
-- Public Debt as % of GDP
-
-**Social Development:**
-- Human Development Index (HDI)
-- Life Expectancy
-- Infant Mortality Rate
-- Literacy Rate
-- Education Index
-- Gender Inequality Index
-- Population Growth Rate
-- Urban Population %
-
-**Health & Well-being:**
-- Healthcare Expenditure per Capita
-- Physicians per 1000 people
-- Hospital Beds per 1000 people
-- Access to Clean Water %
-- Vaccination Coverage %
-
-**Environment & Sustainability:**
-- CO2 Emissions per Capita
-- Renewable Energy %
-- Forest Area %
-- Air Quality Index
-- Environmental Performance Index
-
-**Governance & Infrastructure:**
-- Corruption Perceptions Index
-- Internet Penetration %
-- Mobile Phone Subscriptions
-- Infrastructure Quality Index
-- Political Stability Index
-
-**Economic Equality:**
-- Gini Coefficient (Income Inequality)
-- Poverty Rate
-- Social Protection Coverage
-
-### Functional Requirements
-
-1. **Multi-Cities Comparisons**: Allow users to select and compare multiple cities simultaneously
-2. **Time Series Analysis**: Show growth/change over years (minimum 5-year span)
-3. **Search & Filter**: Enable city search and metric-based filtering
-4. **Ranking System**: Sort cities by individual metrics
-5. **Interactive Visualizations**: 
-   - Bar charts, line graphs, scatter plots
-   - Heatmaps for regional comparisons
-   - Interactive world maps
-   - Correlation matrices
-
-### Key Insights to Display
-- Top 10 cities in HDI
-- Regions with highest inequality (Gini)
-- Cities with best healthcare systems
-- Environmental leaders and laggards
-- Custom insight generation based on user selections
-
-### Technical Requirements
-- **Responsive Design**: Must work seamlessly on desktop, tablet, and mobile
-- **Performance**: Fast loading and smooth interactions
-- **Accessibility**: Follow WCAG guidelines for inclusive design
-
----
-
-## 🎯 Bonus Features (Optional)
-
-1. **AI-Powered Analytics**:
-   - Trend prediction for selected metrics
-   - Anomaly detection in city performance
-   - Correlation analysis between different indicators
-
-2. **Export Capabilities**:
-   - Generate custom PDF reports
-   - Export data as CSV/Excel
-   - Share visualizations as images
-
-3. **Policy Insights**:
-   - Display policy suggestions for underperforming cities
-   - Show success stories and best practices
-   - Highlight cities with similar profiles
-
-4. **Advanced Interactions**:
-   - City clustering based on performance
-   - Scenario analysis ("What if" modeling)
-   - Goal tracking (e.g., SDG progress)
-
----
-
-## 🏆 Judging Criteria
-
-Your submission will be evaluated based on:
-
-1. **Data Accuracy & Completeness (25%)**
-   - Correct implementation of all required metrics
-   - Data validation and error handling
-   - Use of reliable data sources
-
-2. **UI/UX Design and Interactivity (25%)**
-   - **Unique and innovative design** ⭐ (Special emphasis)
-   - Intuitive user experience
-   - Smooth animations and transitions
-   - Mobile responsiveness
-
-3. **Functional Excellence (20%)**
-   - All required features working properly
-   - Performance optimization
-   - Cross-browser compatibility
-
-4. **Code Quality & Documentation (15%)**
-   - Clean, readable, and maintainable code
-   - Proper documentation and comments
-   - Good project structure
-
-5. **Innovation & Impact (15%)**
-   - Creative features and insights
-   - Problem-solving approach
-   - Overall usefulness for target users
-
----
-
-## 🚀 How to Participate
-
-### Submission Steps:
-
-1. **Star this repository**
-   ```bash
-   git clone https://github.com/Lets-code-with-us/Letscode-Community-Challenge-1.git
-   ```
-
-2. **Build Your Solution**
-   - Use any tech stack you prefer (React, Vue, Angular, Vanilla JS, Python, etc.)
-   - Implement all required features
-   - Focus on unique UI design and user experience
-
-3. **Create your github Repo**
-   - Upload your source in the github repo and make it live.
-
-4. **Document Your Work**
-   - Create a comprehensive README (see template below)
-   - Include demo link, screenshots, and setup instructions
-   - Highlight your unique features
-
-5. **Submit Your Entry**
-   - Ensure all files are included in the github repo and demo link works
-   - And then fill this form(compulsory) - [Submission form](https://forms.gle/VV7Gu5JUKa1TmQd77)
-
-6. **Join the Discussion group for any doutbs**
-   - [WhatsApp group link](https://chat.whatsapp.com/Lfp0vamaQe8I1YkXQ2qZQH)
-   - [Github discussion](https://github.com/Lets-code-with-us/Letscode-Community-Challenge-1/discussions/2)
-
----
-
-## 📝 README Template for Your Submission
-
-```markdown
-# [Your Project Name]
-*Submitted by: [Your Name]*
-
-## 🌟 Live Demo
-🔗 **[View Live Demo](your-demo-link-here)**
+🇮🇳 Bharat Pulse: The Living Dashboard of India’s Growth
+Submitted by: Riya Upadhyay
 
-## 📸 Screenshots
-![Dashboard Overview](./demo-images/dashboard-overview.png)
-![Cities Comparison](./demo-images/cities-comparison.png)
-![Mobile View](./demo-images/mobile-view.png)
-
-## 🛠️ Tech Stack
-- Frontend: [e.g., React, Vue.js, Angular]
-- Backend: [if applicable]
-- Database: [if used]
-- Visualization: [e.g., D3.js, Chart.js, Plotly]
-- Deployment: [e.g., Vercel, Netlify, Heroku]
-
-## ✨ Unique Features
-- **[Feature 1]**: Brief description of what makes it special
-- **[Feature 2]**: How it enhances user experience
-- **[Feature 3]**: Technical innovation implemented
-
-## 🚀 Getting Started
+Track: Data for Development
+Challenge: Build an insightful and interactive dashboard showcasing India’s growth using real metrics.
 
-### Prerequisites
-- Node.js (v14+)
-- [Any other requirements]
+🌟 Live Demo
+🔗 https://letscode-community-challenge-1-60srgemdr-riya-742005s-projects.vercel.app/
 
-### Installation
-```bash
-# Clone and navigate to project
-cd submissions/[your-name]
-
-# Install dependencies
-npm install
+📸 Screenshots
+![one state - multiple metrics](https://github.com/user-attachments/assets/5a06fbc6-aa0c-4926-8d86-186caec221c3)
+
+![two city comparision](https://github.com/user-attachments/assets/ce5e2a28-44d6-495d-a7d6-55781282745b)
+
+
+![graph-comparision](https://github.com/user-attachments/assets/1e94d065-874e-44ac-82c0-be1dbbff9c9c)
+
+
+![Ranking](https://github.com/user-attachments/assets/2836e71b-e563-440b-882d-a1c590d1fff8)
 
-# Start development server
-npm start
-```
 
-## 📞 Contact
-- Email: letscode@lets-code.co.in
 
----
 
-## 📅 Timeline
 
-- **Challenge Launch**: 16 June 2025
-- **Submission Deadline**: 22 June 2025
-- **Winner Announcement**: 25 June 2025
+🔍 About the Project
+Bharat Pulse is an interactive, real-time visual dashboard that reflects the heartbeat of India's growth story. It simplifies complex development metrics into accessible, meaningful insights through clean UI, city comparisons, rankings, and AI-driven interpretations.
 
---- 
+It aims to support citizens, researchers, and policymakers in understanding where Indian cities stand — economically, environmentally, and socially.
 
-## 🏅 Prizes & Recognition
+🛠️ Tech Stack
+Frontend: React.js
 
-- **1st Place**: Winner Certificate + Goodies
-- **2nd Place**: Runnerup Certificate + Goodies
-- **3rd Place**: Runnerup Certificate + Goodies
-- **For Everybody**: Participants Certificate
+Data Visualization: Chart.js, Recharts, React Simple Maps
 
+Styling: CSS Modules
 
-## ❓ FAQ
+Deployment: Vercel
 
-**Q: Can I use external libraries and frameworks?**
-A: Yes! Use any tech stack, libraries, or frameworks you're comfortable with.
+Others: CountUp.js, react-select, react-spring
 
-**Q: Do I need to implement all 30+ metrics?**
-A: Yes, all required metrics should be included for full consideration.
+✨ Unique Features
+🔄 Dynamic Metric Selection: Choose from development indicators like GDP, HDI, CO₂ Emissions, Literacy Rate, etc., and visualize city-wise performance.
 
-**Q: Can I work in a team?**
-A: This is an individual challenge, but you can seek help and guidance from the community.
+🏆 Auto-Ranking System: Cities are automatically ranked based on selected metrics — helping users quickly identify top and bottom performers.
 
-**Q: What if I can't access certain data sources?**
-A: Use mock data or alternative sources, but ensure data accuracy and mention this in your README.
+🌍 Heatmap & Geographic Insights: Location-based development via interactive map visuals — visual clustering & disparities made easy to spot.
 
----
+🤖 Insight Generator : One-click insights summarize what's happening in the data — giving a narrative layer to the numbers.
 
-## 📞 Support
+📱 Fully Responsive
 
-- **Community Discord**: [Link](https://discord.com/invite/XRBheB9QF9)
-- **Challenge Discussion**: [GitHub Discussions Link](https://github.com/Lets-code-with-us/Letscode-Community-Challenge-1/discussions/2)
-- **WhatsApp group**: [Link](https://chat.whatsapp.com/Lfp0vamaQe8I1YkXQ2qZQH)
-- **Technical Help**: [Twitter](https://x.com/shubham007913)
+🚀 Getting Started
+📦 Prerequisites
+Node.js (v14 or later)
 
----
+Git
+
+🧰 Installation
+bash
+Copy
+Edit
+# Clone the repository
+git clone https://github.com/riya-742005/Letscode-Community-Challenge-1.git
+
+# Navigate to your submission folder
+cd Letscode-Community-Challenge-1/submissions/riya-upadhyay
+
+# Install required dependencies
+npm install
+
+# Start the local dev server
+npm start
+📄 Project Folder Structure
+plaintext
+Copy
+Edit
+submissions/
+└── riya-upadhyay/
+    ├── public/
+    ├── src/
+    │   ├── components/
+    │   ├── data/
+    │   ├── pages/
+    │   └── utils/
+    ├── demo-images/
+    ├── README.md
+    └── package.json
+📈 Future Improvements
+Add backend for dynamic metric updates
 
-## 🎉 Let's Build Something Amazing!
+User login & custom dashboard saving
 
-Ready to decode development and create insights that could impact how we understand global progress? 
+Integrate with live government open data APIs
 
-**Fork this repo and start building!** 🚀
+Add timeline-based visualizations (metric trends over years)
 
+💡 Inspiration
+India is evolving — but growth isn’t uniform. This dashboard aims to make that difference visible, understandable, and actionable.
 
-*Good luck to all participants! May the best dashboard win! 🏆*
+🙌 Acknowledgements
+Let's Code Community for organizing this challenge
 
+Open data initiatives like Data.gov.in
 
-## Note: Using AI tools like Cusor, Windsurf, and Bolt is mandatory.
+Chart.js & Recharts for seamless data viz
 
+Judges & reviewers who support open innovation
 
-Check our website for placement resources - [Lets Code](https://www.lets-code.co.in/)

submissions/riya-upadhyay/.gitignore

@@ -0,0 +1 @@
+node_modules

submissions/riya-upadhyay/Letscode-Community-Challenge-1.git/objects/info/packs

@@ -0,0 +1,2 @@
+P pack-f00715db060fdbcd068541558ffca90ddacb7fd8.pack
+

submissions/riya-upadhyay/Letscode-Community-Challenge-1.git/packed-refs

@@ -0,0 +1,2 @@
+# pack-refs with: peeled fully-peeled sorted 
+d66746df0a4808c67bfb659e7e6f4e22bda0089a refs/heads/main