Skip to content

alfranz/nation-pulse

Repository files navigation

NationPulse 🌍

NationPulse is an interactive dashboard that visualizes key national statistics and indicators across economic, social, health, and crime dimensions. The project aims to make complex national data more accessible and understandable through intuitive visualizations.

Features 🚀

  • Interactive Dashboard: Clean, modern interface built with Next.js and Shadcn/UI
  • Multiple Data Categories:
    • Economic indicators (GDP, unemployment, inflation)
    • Crime statistics (violent crimes, burglaries)
    • Health metrics (coming soon)
    • Social indicators (coming soon)
  • Data Visualization: Beautiful, responsive charts powered by Recharts
  • Country Selection: Currently featuring Germany, with more countries planned

Data Sources 📊

All data is sourced from official government and international organization statistics:

  • Economic Data: Destatis (Federal Statistical Office of Germany)
  • Crime Statistics: Bundeskriminalamt (BKA) - Police Crime Statistics (PKS)
  • Health Data: Federal Health Monitoring System (GBE)
  • Social Indicators: OECD Better Life Index

Tech Stack 💻

Getting Started 🚀

  1. Clone the repository:
git clone https://github.com/alfranz/nation-pulse.git
cd nationpulse
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

  2. Run type-check:

npm run type-check

Contributing 🤝

Contributions are welcome! Here are some ways you can contribute:

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

Some areas you can contribute to:

  • Add data for more countries
  • Implement new visualizations
  • Add more statistical indicators
  • Improve documentation
  • Report bugs
  • Suggest features

License 📝

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

Acknowledgments 🙏

  • Data provided by various national statistical offices and international organizations
  • Built with amazing open-source tools and libraries

Future Plans 🔮

  • Add more countries
  • Implement more visualization types
  • Add data export functionality
  • Add comparative analysis features
  • Implement time range selection
  • Add more social and health indicators

Made with ❤️ using Next.js, Shadcn/UI, and Recharts

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published