Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/theoheneba/travel-guide
A modern web application that helps travelers discover tourist attractions, restaurants, and local hotspots in any city or country around the world.
https://github.com/theoheneba/travel-guide
javascript react typescript vite
Last synced: about 1 month ago
JSON representation
A modern web application that helps travelers discover tourist attractions, restaurants, and local hotspots in any city or country around the world.
- Host: GitHub
- URL: https://github.com/theoheneba/travel-guide
- Owner: theoheneba
- Created: 2024-12-27T18:57:07.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-27T19:11:11.000Z (about 2 months ago)
- Last Synced: 2024-12-27T20:17:52.689Z (about 2 months ago)
- Topics: javascript, react, typescript, vite
- Language: TypeScript
- Homepage:
- Size: 374 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Travel-Guide
# Travel Guide 🌎
A modern web application that helps travelers discover tourist attractions, restaurants, and local hotspots in any city or country around the world.
## Features ✨
- 🔍 Search any city or country
- 🏛️ Discover popular tourist attractions
- 🍽️ Find local restaurants and eateries
- 📍 Location-based recommendations
- 🗺️ Interactive maps
- ⭐ User reviews and ratings
- 📱 Responsive design for all devices
- 🌙 Dark/Light mode support
## Tech Stack 🛠️
- **Frontend Framework**: React
- **Build Tool**: Vite
- **Language**: TypeScript (97.1%)
- **Styling**: Tailwind CSS
- **Components**: Shadcn UI
- **Code Quality**: ESLint
- **Maps Integration**: (Add your map provider here)
## Project Structure 📁
Travel-Guide/
├── src/ # Source files
├── .bolt/ # Bolt configuration
├── components.json # UI components configuration
├── .gitignore # Git ignore file
├── eslint.config.js # ESLint configuration
├── index.html # Entry HTML file
├── package.json # Project dependencies
├── postcss.config.js # PostCSS configuration
├── tailwind.config.js# Tailwind CSS configuration
├── tsconfig.json # TypeScript configuration
└── vite.config.ts # Vite configuration
## Getting Started 🚀
1. Clone the repository:
```bash
git clone https://github.com/theoheneba/Travel-Guide.git/
cd Travel-Guide
npm install
cp .env.example .env
# Add your API keys and configuration
npm run dev
VITE_MAPS_API_KEY=your_maps_api_key
VITE_PLACES_API_KEY=your_places_api_key
Features in Development 🔄
User authentication
Saved locations
Customized itineraries
Offline access
Multi-language support
Contributing 🤝
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request
License 📝
This project is open source and available under the MIT License.
Language Distribution 📊
TypeScript: 97.1%
JavaScript: 2.0%
Other: 0.9%
Contact 📧
Theo Heneba - GitHub Profile
Project Link: https://github.com/theoheneba/Travel-Guide
Acknowledgments 🙏
React Documentation
Vite
Tailwind CSS
Shadcn UI