{"id":27444731,"url":"https://github.com/furkanunsalan/travelmap","last_synced_at":"2026-02-11T07:03:42.350Z","repository":{"id":245163233,"uuid":"817277374","full_name":"furkanunsalan/TravelMap","owner":"furkanunsalan","description":"📍Interactive map for tracking and visualizing travel destinations","archived":false,"fork":false,"pushed_at":"2025-02-23T18:19:16.000Z","size":110368,"stargazers_count":2,"open_issues_count":8,"forks_count":0,"subscribers_count":1,"default_branch":"prod","last_synced_at":"2025-08-09T12:43:41.356Z","etag":null,"topics":["axios","context","firebase","maptiler","open-source","react","single-page-applications","traveling","vitejs"],"latest_commit_sha":null,"homepage":"https://map.furkanunsalan.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/furkanunsalan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-19T11:26:40.000Z","updated_at":"2025-03-01T08:17:35.000Z","dependencies_parsed_at":"2024-11-13T16:23:41.063Z","dependency_job_id":"0f802847-1555-4570-9ad1-8461390c72c1","html_url":"https://github.com/furkanunsalan/TravelMap","commit_stats":null,"previous_names":["furkanunsalan/travelmap"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/furkanunsalan/TravelMap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkanunsalan%2FTravelMap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkanunsalan%2FTravelMap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkanunsalan%2FTravelMap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkanunsalan%2FTravelMap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/furkanunsalan","download_url":"https://codeload.github.com/furkanunsalan/TravelMap/tar.gz/refs/heads/prod","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkanunsalan%2FTravelMap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29329492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T06:13:03.264Z","status":"ssl_error","status_checked_at":"2026-02-11T06:12:55.843Z","response_time":97,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","context","firebase","maptiler","open-source","react","single-page-applications","traveling","vitejs"],"created_at":"2025-04-15T03:17:09.696Z","updated_at":"2026-02-11T07:03:42.335Z","avatar_url":"https://github.com/furkanunsalan.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![opengraph-image](https://github.com/user-attachments/assets/26427285-bbb1-4140-9683-26e5f967c53d)\n\n# Travel Map\n[![Made With Love](https://img.shields.io/badge/Made%20With-Love-orange.svg)](https://github.com/chetanraj/awesome-github-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](https://opensource.org/licenses/MIT) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/furkanunsalan/TravelMap.svg)](https://GitHub.com/furkanunsalan/TravelMap/pulls/) [![GitHub issues](https://img.shields.io/github/issues/furkanunsalan/TravelMap.svg)](https://GitHub.com/furkanunsalan/TravelMap/issues/)\n\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n  - [Overview](#overview)\n  - [Features](#features)\n  - [Technologies Used](#technologies-used)\n  - [Setup Instructions](#setup-instructions)\n    - [Prerequisites](#prerequisites)\n    - [Installation](#installation)\n  - [Usage](#usage)\n    - [Adding Places](#adding-places)\n    - [Viewing Places on the Map](#viewing-places-on-the-map)\n  - [Database Structure](#database-structure)\n    - [Firestore Database Structure](#firestore-database-structure)\n    - [Storage Bucket Structure](#storage-bucket-structure)\n  - [Contributing](#contributing)\n  - [License](#license)\n  - [Contact](#contact)\n\u003c/details\u003e\n\n\n## Overview\n\nThis project is a personal tool to track and visualize travel destinations and places of interest on a map. It allows you to manage and view a list of places you plan to visit, as well as places you want to relax in. The application integrates with the MapTiler API to display interactive maps and custom markers.\n\n## Features\n\n- **Interactive Map:** Visualize locations of your landmarks on an interactive map using the MapTiler API.\n- **Custom Markers:** Add markers to the map for different landmarks with customizable popups.\n\n![screenshot](public/marker.png)\n\n- **Dynamic Tabs:** Switch between and organize different lists of landmarks using tabs.\n\n![screenshot](public/landmark.png)\n\n- **Detail Pages:** Dynamic detail pages for your landmarks.\n\n![screenshot](public/details.png)\n\n- **Submission Page:** Add your new favorite landmarks easily.\n\n![screenshot](public/submit.png)\n\n- **Rating System:** View and manage places with a rating system displayed in the popups.\n- **Responsive Design:** The interface adapts to different screen sizes for better usability on mobile devices.\n\n## Technologies Used\n\n- **React:** For building the user interface.\n- **Axios:** For sending API requests.\n- **Context:** For Global State Management \n- **Tailwind CSS:** For styling and responsive design.\n- **MapTiler SDK:** For map rendering and interaction.\n- **Vite:** For development and build tooling.\n- **Vercel:** For deployment.\n- **Firebase:** Database for storing place data and images.\n- **Framer:** For component and page animations.\n\n## Setup Instructions\n\n### Prerequisites\n\n- Node.js (v16 or later)\n- NPM\n- Vercel CLI (Required for the backend to work properly.)\n\n### Installation\n\n1. **Clone the Repository**\n\n    ```bash\n    git clone https://github.com/furkanunsalan/TravelMap.git\n    cd TravelMap\n    ```\n\n2. **Install Dependencies**\n\n    ```bash\n    npm install\n    ```\n\n3. **Set Up Environment Variables**\n\n   Create a `.env` file in the root of the project and add your MapTiler API key:\n\n    ```env\n    VITE_API_KEY=your_maptiler_api_key\n    FIREBASE_SERVICE_ACCOUNT=firebase_service_account_credential\n    AUTH_EMAIL=email_for_submit_page_admin\n    AUTH_PASSWORD=password_for_submit_page_admin\n    MAIL_PASS=your-smtp-mail-password\n    ```\n\n4. **Run the Development Server**\n\n    ```bash\n    vercel dev\n    ```\n\n5. **Open the Application in Your Browser**\n\n    App will compile on `http://localhost:3000` in your browser.\n\n## Usage\n\n### Adding Places\n\n- **Food:** list of food related places that I love visiting.\n- **Chill:** List of places to hangout with friends and family.\n- **Travel:** List of places to see around the world.\n- **Library:** List of libraries to sit and study.\n\n### Viewing Places on the Map\n\n1. Click on a marker on the map to view details in a popup.\n2. The popup will display information such as name, address, the latest visit date, and a rating with stars.\n\n## Database Structure\n\nThe project uses **Firebase Firestore** to store information about each place and **Firebase Storage** for images. Below is the structure for both of the services.\n\n### Firestore Database Structure\n\n```\n/places\n  └──1EyeJjFgzMS33jogOG2W\n        ├── address: \"Sinanpaşa, Ihlamurdere Cd. No:25A, 34022 Beşiktaş/İstanbul\"\n        ├── date: \"10-07-2024\"\n        ├── description: \"\"\n        ├── id: \"1EyeJjFgzMS33jogOG2W\"\n        ├── latitude: \"41.044224\"\n        ├── longitude: \"29.003012211640893\"\n        ├── name: \"Balta Burger\"\n        ├── rating: 4\n        ├── site: \"\"\n        ├── slug: \"balta-burger\"\n        ├── status: \"Gone\"\n        └── tag: \"Food\"\n```\n\n### Storage Bucket Structure\n\n```\n/images\n    └── /balta-burger\n            ├── cover.png\n            └── /additional\n                └── 1.jpg\n```\n\n## Contributing\n\nAfter running the project by applying the steps in [setup instructions](#setup-instructions), you can make changes, fix errors and send feature requests by the following guide:\n\n1. **Create a New Branch**\n\n    ```bash\n    git checkout -b feature/your-feature\n    # or\n    git git checkout -b fix/your-fix\n    ```\n\n2. **Make Your Changes**\n\n3. **Commit Your Changes**\n\n    ```bash\n    git add .\n    git commit -m \"feat: Add a descriptive commit message\"\n    # or \n    git commit -m \"fix: Add a descriptive commit message\"\n    ```\n\n4. **Push to Remote**\n\n    ```bash\n    git push origin feature/your-feature\n    ```\n\n5. **Open a Pull Request**\n    Open a PR on GitHub from your fork to contribute into the main branch.\n\n[![Star History Chart](https://api.star-history.com/svg?repos=furkanunsalan/TravelMap\u0026type=Timeline)](https://star-history.com/#furkanunsalan/TravelMap)\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor any questions or feedback, please reach out to:\n\n- **Furkan Ünsalan** - [hi@furkanunsalan.dev](mailto:hi@furkanunsalan.dev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffurkanunsalan%2Ftravelmap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffurkanunsalan%2Ftravelmap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffurkanunsalan%2Ftravelmap/lists"}