https://github.com/koadt/hate-crimes-map
This project aims to visualize hate crime data to bring visibility to crimes that are often invisible or normalized by society.
https://github.com/koadt/hate-crimes-map
data-visualization homophobia mapbox nextjs open-data racism social-impact tailwindcss typescript xenophobia
Last synced: 2 months ago
JSON representation
This project aims to visualize hate crime data to bring visibility to crimes that are often invisible or normalized by society.
- Host: GitHub
- URL: https://github.com/koadt/hate-crimes-map
- Owner: kOaDT
- License: unlicense
- Created: 2025-01-26T21:54:45.000Z (5 months ago)
- Default Branch: develop
- Last Pushed: 2025-03-23T08:02:36.000Z (3 months ago)
- Last Synced: 2025-03-23T09:18:26.257Z (3 months ago)
- Topics: data-visualization, homophobia, mapbox, nextjs, open-data, racism, social-impact, tailwindcss, typescript, xenophobia
- Language: TypeScript
- Homepage: https://www.hatecrimesmap.org/
- Size: 4.75 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: security.md
Awesome Lists containing this project
README
# Hate Crimes Map
## Project Goal
The **Hate Crimes Map** project aims to visualize hate crime data to bring visibility to crimes that are often invisible or normalized by society. By making this data accessible and visual, we hope to contribute to a better understanding of these issues.
To learn more about the project creation process, please refer to [this article](https://koadt.vercel.app/blog/hate-crimes-map-visualizing-hate-crime-data-for-greater-awareness/).
## Data Source
The data displayed in this project is sourced from the official OSCE Hate Crime Reporting database, which can be accessed here: [https://hatecrime.osce.org/hate-crime-data](https://hatecrime.osce.org/hate-crime-data).
If you notice that the data is outdated, we invite you to contribute! Convert the `.xlsx` file from the source into a `.json` file and upload it to the following path in the repository: `/public/data/hcrw_incidents_all-report.json`. Don’t forget to create a pull request after updating the file.
## Caution
Please note that this data should be interpreted with caution. The data only includes participating OSCE member states and the number and nature of reported hate crimes can vary significantly between countries due to:
- Limited geographical coverage (OSCE participating states only)
- Varying levels of freedom of expression
- Different reporting mechanisms and practices
- Cultural and social factors affecting reporting
## Disclaimer
This project is not affiliated with the OSCE or any other organization.
## Technologies Used
This project is built using the following technologies:
- **Next.js**
- **TypeScript**
- **Tailwind CSS**
### Additional Tools
- **Mapbox**: Used for rendering the interactive map. To use the project locally, you will need a Mapbox API key. You can obtain one by signing up here: [https://www.mapbox.com/](https://www.mapbox.com/).
- **Recharts**: For displaying graphical representations of the data.
- **Vercel**: The project is hosted on Vercel's free tier and uses Vercel Analytics for tracking performance.
## Responsive Design
The project prioritizes responsive design to ensure a seamless experience across devices, including desktops, tablets, and smartphones.
## Contributing Guidelines
We welcome contributions to improve this project! Here are some ways you can help:
1. **Update Data**: If the dataset is outdated, follow the instructions above to convert and upload the updated file.
2. **Report Issues**: Open an issue if you encounter bugs or have suggestions for improvement. Template to follow: [Issue Template](https://raw.githubusercontent.com/kOaDT/hate-crimes-map/refs/heads/develop/.github/ISSUE_TEMPLATE/bug_report.md).
3. **Feature Requests**: Suggest new features or enhancements to make the platform more impactful. Template to follow: [Feature Request Template](https://raw.githubusercontent.com/kOaDT/hate-crimes-map/refs/heads/develop/.github/ISSUE_TEMPLATE/feature_request.md).
4. **Pull Requests**: Feel free to fork the repository and submit your changes via pull requests. Ensure your code follows best practices and includes necessary documentation. Template to follow: [Pull Request Template](https://raw.githubusercontent.com/kOaDT/hate-crimes-map/refs/heads/develop/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md).
More information can be found in the [CONTRIBUTING.md](CONTRIBUTING.md) file.
### Open-Source Licensing
This project is completely open-source. You are free to reuse, modify, or distribute the code as long as you provide appropriate credit by citing the original source (this repository).
More information can be found in the [LICENSE](LICENSE) file.
---
## How to Get Started
1. Clone the repository:
```bash
git clone https://github.com/your-username/hate-crimes-map.git
```
2. Install dependencies:
```bash
npm install
```
3. Add your Mapbox API key:
- Create a `.env.local` file in the root directory.
- Add the following line:
```
NEXT_PUBLIC_MAPBOX_API_KEY=your_mapbox_api_key
```
4. Run the development server:
```bash
npm run dev
```
5. Access the project at [http://localhost:3000](http://localhost:3000).
---
Thank you for supporting this initiative!