Skip to content

mahmudcfo/world-on-the-go

Repository files navigation

🌍 World on the Go

A modern web application for exploring and experiencing the world — wherever you are, whenever you’re ready.

🚀 Getting Started

Follow these steps to set up and run the project locally:

1. Clone the Repository

git clone https://github.com/mahmudhasan123/world-on-the-go.git
cd world-on-the-go

2. Install Dependencies

npm install

3. Run the Development Server

npm run dev

4. Open in Browser

Visit the application in your browser at:

http://localhost:5173

💡 Note: The port may vary depending on your local setup.

🛠️ Tech Stack

  • Framework: React
  • Styling: Tailwind CSS
  • Language: JavaScript (ES6+)
  • Package Manager: npm

✨ Features

  • 🌍 Explore world countries
  • ⚡ Lightning-fast development with ReactJS
  • 🎨 Modern, fully responsive UI powered by Tailwind CSS
  • 🔗 Built for seamless API integration

📂 Project Structure

world-on-the-go/
├── public/          # Static assets (images, fonts, etc.)
├── src/             # Source code
│   ├── components/  # Reusable UI components
│   ├── pages/       # Application pages
│   ├── styles/      # Global and utility styles
│   └── utils/       # Helper functions and utilities
├── package.json     # Project dependencies and scripts
└── README.md        # Project documentation (you are here!)

🤝 Contributing

We welcome contributions! Whether you're fixing a bug or adding a new feature:

  1. Open an Issue — Report bugs or suggest enhancements.
  2. Submit a Pull Request — Share your improvements with the community.

All contributions will be reviewed and appreciated! 🙌

About

React app displaying 250 countries data using fetched API data.

Topics

Resources

Stars

Watchers

Forks