Terra World Explorer - Full Travel, Weather & Country Discovery Flutter App Template (Riverpod 2.x)

# Terra World Explorer — Travel & Country Discovery Flutter App Template (v1.0.0)

**Terra World Explorer** is a high-quality, fully featured mobile application template designed for travel enthusiasts, world explorers, and developers looking to launch a complete travel/weather app. Built with **Flutter 3.x** and **Riverpod 2.x** reactive state management, Terra delivers a fast, responsive, and seamless experience across both **Android and iOS**.

---

## 🌟 Key Features

* 🌍 **250+ Country Profiles:** Complete info including flag, capital, population, region, languages, currencies, and ISO details.
* 🏙️ **Top Cities Discovery:** Independent loading of top cities for selected countries.
* 🌤️ **Live Weather & 5-Day Forecast:** Real-time conditions, hourly breakdown, °C/°F toggle, and night-aware UI logic.
* 📍 **Interactive Google Maps:** Smooth animated camera positioning, GPS location detection, and coordinate fallback.
* 🔍 **Explore Nearby Places:** GPS-based discovery (Restaurants, Hotels, Attractions, Cafes) with customizable search radius (1 km – 10 km) and map style toggles (Default, Satellite, Terrain).
* 🪪 **Travel Utilities:**
 * 💱 **Currency Converter:** Real-time exchange rate calculation via ExchangeRate-API.
 * 📊 **Expense Tracker:** Log travel expenses by category, view summaries, and track budgets.
 * 🗣️ **Travel Phrasebook + TTS:** Spoken pronunciation in 8 languages (English, Arabic, French, Spanish, German, Italian, Portuguese, Turkish).
* 🌙 **Dark & Light Themes:** Fully reactive theme switching persisted locally via SharedPreferences.
* 💾 **Local Persistence:** Favourites, recent search history, and user settings saved on-device.

---

## 🛠️ Technical Stack & Architecture

* **Framework:** Flutter 3.x / Dart ^3.10.1
* **State Management:** Riverpod 2.x (with code generation using `build_runner`)
* **Local Storage:** `SharedPreferences` + `flutter_dotenv` for environment management
* **Services Included:** REST Countries API, OpenWeatherMap, GeoDB Cities / RapidAPI, Google Maps SDK, ExchangeRate-API, Flutter TTS.
* **UI/UX Highlights:** Shimmer loading states, no-internet handling widgets, clean modular folder structure (`data`, `models`, `pages`, `providers`, `services`, `utils`, `widgets`).

---

## 📦 What's Included in the Purchase Package?

1. Full Flutter Source Code (Clean & Well-Structured)
2. Comprehensive Documentation & Customization Guide (PDF)
3. Pre-configured `flutter_launcher_icons` configuration for fast re-branding
4. Free Future Version Updates

---

## 🚀 Quick Setup Overview
1. Extract the package and run `flutter pub get`.
2. Add your API keys in the root `.env` file (OpenWeather, RapidAPI, etc.).
3. Insert your Google Maps API key in `AndroidManifest.xml`.
4. Run `flutter run` and enjoy your app!