3.7 KiB

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:

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

    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:

    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

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