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.

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.

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/.
• 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.
3. Feature Requests: Suggest new features or enhancements to make the platform more impactful. Template to follow: Feature Request Template.
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.

More information can be found in the 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 file.

---

How to Get Started

1. Clone the repository:

   git clone https://github.com/your-username/hate-crimes-map.git

2. Install dependencies:

   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:

   npm run dev

5. Access the project at http://localhost:3000.

---

Thank you for supporting this initiative!