# Nigeria Conflict Geospatial Dashboard
An interactive geospatial dashboard for visualizing and analyzing conflict statistics in Nigeria, including killings, insurgency, kidnappings, and other forms of violence.
## Features
- **Real-Time Data Integration**: Fetches data from ACLED API and other sources
- **Interactive Map**: Powered by Mapbox GL JS with custom style
- **Heatmap Visualization**: Visual representation of conflict intensity across Nigeria
- **Advanced Filtering**: Filter by date range, event type, and region
- **Statistics Dashboard**: Comprehensive analytics and metrics
- **Regional Analysis**: Analysis of conflict patterns and regional connections
- **References**: Curated list of data sources and research papers
## Setup
1. Install dependencies:
```bash
npm install
```
2. Set environment variables:
```bash
# Required
MAPBOX_ACCESS_TOKEN=your_mapbox_token
MAPBOX_STYLE_URL=your_mapbox_style_url
# Optional - for ACLED API access
ACLED_API_KEY=your_acled_api_key
ACLED_EMAIL=your_email
```
3. Run development server:
```bash
npm run dev
```
4. Build for production:
```bash
npm run build
```
## Data Sources
### ACLED (Armed Conflict Location & Event Data Project)
- **API Access**: Sign up at
developer.acleddata.com
- **Data Format**: JSON/CSV exports
- **Coverage**: Real-time conflict events with geospatial coordinates
### Alternative Data Sources
- Human Rights Watch Reports
- U.S. State Department Country Reports
- FES Nigeria Violent Conflict Monthly Bulletins
- Academic research papers
## API Configuration
### ACLED API Setup
1. Register at
developer.acleddata.com
2. Get your API key and email
3. Add to `.env`:
```
ACLED_API_KEY=your_key
ACLED_EMAIL=your_email
```
The dashboard will automatically use ACLED API if credentials are provided, otherwise it will use enhanced sample data based on real conflict patterns.
## Mapbox Configuration
The dashboard uses Mapbox for map rendering:
- Access Token: Required in environm …