137 lines
3.7 KiB
Markdown

# 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