Home - soujanya957/arctic-map GitHub Wiki

🧭 Arctic Map

Arctic Map is a web-based tool for exploring and downloading geospatial layers, combining a lightweight frontend with a powerful spatial data backend.

This wiki contains everything you need to get started, understand the architecture, and contribute to the project.

What is Arctic Map?

Arctic Map allows users to:

  • Interactively explore spatial datasets on a Mapbox-rendered interface
  • Download zipped shapefiles on demand
  • Integrate custom shapefiles using built-in Python scripts

Tech Stack

Layer Technology
Frontend React + Vite
Backend FastAPI (2 services)
Mapping Mapbox GL JS
Scripting Python (zip utilities)
Runner Tmux-based shell script

Quick Start

  1. Clone the repository:

    git clone https://github.com/soujanya957/arctic-map.git
cd arctic-map

  2. Set up your environment: Setup & Run Instructions

  3. Run the app:

    tmux
./run_0.sh

  4. Visit the frontend: http://localhost:5173/

✅ Make sure you have a valid [Mapbox token](https://account.mapbox.com/access-tokens) saved in frontend/.env.

Wiki Pages

Contributing

Thinking of contributing? We welcome:

  • New features (e.g., map tools, UI enhancements)
  • Bug fixes and performance improvements
  • Documentation improvements

Get started:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request with a clear description of your changes

📄 License

This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).