Skip to content

An interactive travel tracker built with React — featuring real-time mapping (Leaflet), global state management, custom hooks, and a modern component architecture.

Notifications You must be signed in to change notification settings

s1mer-ddc/worldwise

Repository files navigation

React License: MIT Platform

A smart travel companion built with React, designed to help you keep track of the places you’ve visited around the world.

🚀 Features

  • 🗺️ Interactive Map (using Leaflet)
  • 🧭 Add & Manage Locations
  • 📍 Track Visited Cities and Countries
  • 🔄 Global State Management with Context API
  • 🧠 Custom Hooks for Logic Reuse
  • 🧩 Clean Component Architecture
  • Fast, Modern UI with React 18

🧠 Tech Stack

  • React 18
  • React Router v6
  • Context API for global state
  • Leaflet for interactive maps
  • Styled Components / CSS Modules
  • Vite / Create React App

🛠️ Installation

Clone the repository and install dependencies:

git clone https://github.com/your-username/worldwise.git
cd worldwise
npm install

💡 Usage

To start the app in development mode:

npm run dev

Then open your browser and go to:

http://localhost:5173

🧱 Project Structure

worldwise/
├── src/
│   ├── components/       # Reusable UI components
│   ├── contexts/         # Global state management
│   ├── hooks/            # Custom React hooks
│   ├── pages/            # App pages (Homepage, App, etc.)
│   ├── services/         # API and data fetching
│   ├── styles/           # Global styles
│   ├── App.js            # Main app component
│   └── main.jsx          # Entry point
└── package.json

⚙️ Requirements

  • Node.js ≥ 18
  • npm ≥ 9
  • Modern browser with ES2020+ support

🧰 Troubleshooting

Map not loading?
Check your Leaflet setup and ensure proper CSS import.

Cities not saving?
Verify local storage permissions or mock API endpoint if applicable.


📜 License

MIT License
Copyright (c) 2025


👤 Author

s1mer-ddc
🔗 GitHub Profile


🧠 Description

A modern, interactive travel tracker built with React — featuring real-time mapping, global state management, and elegant UI design.

About

An interactive travel tracker built with React — featuring real-time mapping (Leaflet), global state management, custom hooks, and a modern component architecture.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published