Thanks to visit codestin.com
Credit goes to github.com

Skip to content

mersy-28/worldwander

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WorldWander 🌎

WorldWander Logo React

WorldWander is an interactive web application for exploring countries around the world and creating your personalized travel bucket list.

🌟 Features

  • Interactive World Map: Explore countries on an interactive SVG-based world map
  • Country Explorer: Browse through countries from all around the world
  • Detailed Information: Access details about each country including capital, population, languages, and currencies
  • Search & Filter: Find countries by name or filter by region
  • Bucket List: Create and maintain your travel bucket list
  • Persistent Storage: Your bucket list is saved between sessions
  • Responsive Design: Beautiful user interface that works on desktop and mobile devices
  • Region Navigation: Filter countries by their continental regions

🖥️ Usage

Home Page

Browse through a collection of countries from around the world using either the interactive world map or the grid view. Use the controls to switch between views and filter by region.

Interactive Map

The interactive world map allows you to:

  • Click on countries to view their details
  • Hover over countries to see quick information
  • Filter countries by region
  • Zoom and pan the map for better navigation
  • Identify bucket list countries which are highlighted

Country Details

Click on any country to view detailed information including:

  • Capital city
  • Population
  • Region and subregion
  • Languages
  • Currencies
  • And more!

Bucket List

Add countries to your bucket list by clicking the "Add to Bucket List" button on the country details page. View and manage your bucket list from the "My Bucket List" page accessible from the navigation menu.

🛠️ Technology Stack

  • Frontend Framework: React 19.1
  • Routing: React Router 7.8
  • Styling: Custom CSS with modern design principles
  • State Management: React Hooks
  • API Integration: REST Countries API
  • Data Persistence: Browser's Local Storage

🌐 API Integration

WorldWander integrates with the REST Countries API to fetch up-to-date information about countries. The application implements proper error handling and loading states for a smooth user experience.

🚧 Future Enhancements

  • Interactive World Map: Replace the grid view with an interactive world map
  • Trip Planning: Add functionality to plan trips to bucket list countries
  • Social Features: Share bucket lists with friends
  • Dark Mode: Implement light/dark theme toggle
  • More to Come!

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b <feature/amazing-feature>)
  3. Commit your changes (git commit -m '<some amazing feature>')
  4. Push to the branch (git push origin <feature/amazing-feature>)
  5. Open a Pull Request

📬 Contact


Made with ❤️ and React

About

Explore destinations, pin favorites, and plan trips you'll totally take someday.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published