# Arctic Species 2025 Frontend
**Work in Progress!**

A collaborative project between:
- School of Humanities and Social Sciences
  - Thomas Barry
  - Dean of School
- Magnus SMari Smarason
  - AI Project Manager
University of Akureyri

A comprehensive web application for tracking and analyzing Arctic species data, including CITES trade records, IUCN assessments, and conservation status. This project is part of the Arctic Species 2025 initiative.

## Features

- **Arctic Species Search & Details**
  - Search by scientific name or common name
  - Detailed species information including taxonomy
  - Multiple common names support
  - Arctic subpopulation tracking
  - Region-specific conservation status
  - High-quality species images from iNaturalist
  - Interactive image viewer with attribution

- **CITES Information**
  - Complete CITES listing history
  - Current CITES status
  - Detailed trade records with filtering
  - Historical trade data analysis
  - Arctic-specific trade patterns
  - Interactive trade visualizations
  - Filterable trade records table

- **IUCN Assessments**
  - Latest IUCN Red List status
  - Historical assessment tracking
  - Population trend analysis
  - Arctic region-specific assessments
  - Color-coded status indicators

- **Timeline View**
  - Chronological view of species events
  - CITES listing changes
  - IUCN assessment updates
  - Trade record history
  - Arctic conservation milestones

- **Data Visualization**
  - Trade records over time
  - Top importers and exporters
  - Distribution of traded terms
  - Trade purposes and sources
  - Interactive charts and graphs

## Tech Stack

- **Frontend**: React + TypeScript + Vite
- **UI Components**: Shadcn/ui
- **Styling**: Tailwind CSS
- **Database**: Supabase (PostgreSQL)
- **State Management**: React Query
- **Routing**: React Router
- **Charts**: Recharts
- **Image Integration**: iNaturalist API

## Getting Started

### Prerequisites

- Node.js (v18 or higher)
- npm or yarn
- Supabase account and project

### Environment Setup

1. Clone the repository:
   ```bash
   git clone https://github.com/yourusername/arctic-species-2025-frontend.git
   cd arctic-species-2025-frontend
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Create a `.env` file in the root directory with your Supabase credentials:
   ```
   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
   ```

4. Start the development server:
   ```bash
   npm run dev
   ```

The application will be available at `http://localhost:5173`

## Database Schema

The application uses the following main tables:

- `species`: Core species information
- `common_names`: Alternative names for species
- `subpopulations`: Species subpopulation data
- `iucn_assessments`: IUCN Red List assessments
- `cites_listings`: CITES listing history
- `cites_trade_records`: CITES trade data
- `timeline_events`: Chronological events

## Data Sources

- **Species Images**: iNaturalist API (https://api.inaturalist.org/)
- **CITES Data**: CITES Trade Database (https://trade.cites.org/)
- **IUCN Data**: IUCN Red List (https://www.iucnredlist.org/)
- **Species Information**: Arctic Species Database

## Contributing

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

## License

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

## Acknowledgments

- CITES Secretariat for trade data
- IUCN Red List for assessment data
- iNaturalist for species images
- Arctic Council for regional guidance
- All contributors and maintainers