106 lines
2.8 KiB
Markdown
106 lines
2.8 KiB
Markdown
# Arctic Species 2025 Frontend
|
|
|
|
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
|
|
|
|
- **CITES Information**
|
|
- Complete CITES listing history
|
|
- Current CITES status
|
|
- Detailed trade records with filtering
|
|
- Historical trade data analysis
|
|
- Arctic-specific trade patterns
|
|
|
|
- **IUCN Assessments**
|
|
- Latest IUCN Red List status
|
|
- Historical assessment tracking
|
|
- Population trend analysis
|
|
- Arctic region-specific assessments
|
|
|
|
- **Timeline View**
|
|
- Chronological view of species events
|
|
- CITES listing changes
|
|
- IUCN assessment updates
|
|
- Trade record history
|
|
- Arctic conservation milestones
|
|
|
|
## Tech Stack
|
|
|
|
- **Frontend**: React + TypeScript + Vite
|
|
- **UI Components**: Shadcn/ui
|
|
- **Styling**: Tailwind CSS
|
|
- **Database**: Supabase (PostgreSQL)
|
|
- **State Management**: React Query
|
|
- **Routing**: React Router
|
|
|
|
## 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
|
|
|
|
## 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
|
|
- Arctic Council for regional guidance
|
|
- All contributors and maintainers |