Inspired Nation Network (INN)

Find your perfect home.

INN is a modern, feature-rich Flutter application designed to connect users with their dream homes, apartments, and rentals. Built with a focus on detailed property management, user experience, and offline-first capabilities, INN provides a seamless platform for exploring and discovering real estate.

✨ Key Features

• 🏡 Comprehensive Listings: Browse a wide range of houses and apartments with detailed descriptions, amenities, and pricing.
• 🔍 Smart Search & Filters: Precisely find what you need by filtering properties based on price range, location, and type.
• ❤️ Favorites & Collections: Save listings to your personal favorites list for quick access later.
• 🔐 Secure Authentication: Robust user management with Login and Sign Up functionality, backed by secure token storage.
• 📱 Responsive Design: Customized layouts for both Mobile and Desktop experiences.
• 🎨 Dynamic Theming: Full support for Light/Dark modes, Material You dynamic colors, and user-customizable theme seeds.
• 📶 Offline First: Built with Drift for local database caching, ensuring a smooth experience even with spotty connectivity.

📸 Screenshots

Home Page	House Details

Screenshots are placeholders. Please add home_preview.png and details_preview.png to assets/img_assets/.

🛠️ Technology Stack

• Framework: Flutter (Dart)
• State Management: Riverpod
• Navigation: GoRouter
• Local Database: Drift (SQLite)
• Networking: Dio + Retrofit
• Code Generation: Freezed & JsonSerializable
• Testing: flutter_test, integration_test, mockito

🚀 Getting Started

Prerequisites

• Flutter SDK installed.
• An IDE (VS Code or Android Studio) with Flutter/Dart plugins.

Installation

1. Clone the repository:

   git clone https://github.com/your-username/inn.git
   cd inn

2. Install dependencies:

   flutter pub get

3. Run Code Generation: This project uses code generation for models, providers, and database tables.

   dart run build_runner build -d

4. Run the App:

   flutter run

🧪 Testing

To ensure stability, run the test suite:

• Unit & Widget Tests:

  flutter test

• Integration Tests (End-to-End):

  flutter test integration_test/app_test.dart

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on our code of conduct, development process, and how to submit pull requests.

📄 License

This project is licensed under the GNU GPL v3.0. See the LICENSE file for details.