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

Clone the repository:

git clone https://github.com/yourusername/arctic-species-2025-frontend.git
cd arctic-species-2025-frontend

Install dependencies:
```
npm install
```

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

Start the development server:
```
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

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
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