diff --git a/README.md b/README.md
index eabd3651..40c635b2 100644
--- a/README.md
+++ b/README.md
@@ -1,389 +1,159 @@
-# Flutter Riverpod 2.0 Template
+# RescuPaws 🐾
+
-## A flutter template with Riverpod 2.0, Freezed, Go Router, Hive, Easy Localization and more.
+ 
-This template is a starting point for a Flutter application. It contains a lot of useful packages and best practices.
-It is also a good starting point for learning how to use Riverpod 2.0 and Freezed annotations for immutable state.
+ **Find Your Furry Soulmate in Just 2 Taps.**
+ [](https://flutter.dev/)
+ [](https://dart.dev/)
+ [](https://firebase.google.com/)
+ [](https://riverpod.dev/)
-- Using Riverpod 2.0 for state management.
-- Using Riverpod and Freezed annotations for immutable state.
-- Using Go Router for routing with fade and slide transitions.
-- Using Flutter Lints for stricter linting rules.
-- Using Hive for platform independent storage that also works for web.
-- Project structure, const constructors, extracted widgets and many more...
+
-## Pub packages
+---
-This repository makes use of the following pub packages:
+## 📖 About The Project
-| Package | Version | Usage |
-|---------------------------------------------------------------------|---------|------------------------------------|
-| [Flutter Riverpod](https://pub.dev/packages/flutter_riverpod) | ^2.3.6 | State management* |
-| [Riverpod Annotation](https://pub.dev/packages/riverpod) | ^1.0.3 | State management* |
-| [Freezed Annotation](https://pub.dev/packages/freezed_annotation) | ^0.14.2 | Immutable state* |
-| [Go Router](https://pub.dev/packages/go_router) | ^2.1.0 | Routing |
-| [Get It](https://pub.dev/packages/get_it) | ^7.2.0 | Dependency injection* |
-| [Flutter Lints](https://pub.dev/packages/flutter_lints) | ^2.0.1 | Stricter linting rules |
-| [Path Provider](https://pub.dev/packages/path_provider) | ^2.0.11 | Get the save path for Hive |
-| [Flutter Displaymode](https://pub.dev/packages/flutter_displaymode) | ^0.5.0 | Support high refresh rate displays |
-| [Easy Localization](https://pub.dev/packages/easy_localization) | ^3.0.1 | Makes localization easy |
-| [Hive](https://pub.dev/packages/hive) | ^2.2.3 | Platform independent storage. |
-| [Url Launcher](https://pub.dev/packages/url_launcher) | ^6.1.7 | Open urls in Browser |
-| [Ionicons](https://pub.dev/packages/ionicons) | ^0.2.2 | Modern icon library |
+**RescuPaws** is a modern, Tinder-style pet adoption application designed to bridge the gap between homeless pets and loving families. In a world where millions of animals are waiting for a second chance, RescuPaws makes the process of finding your new best friend seamless, fast, and engaging.
-> \* Recommended to keep regardless of your project
+We believe that **adoption should be celebrated, not complicated.** By leveraging a "swipe-right" mechanism, we bring a familiar and fun user experience to the serious and noble cause of animal rescue.
-## Using this package as a starting point
+### 🌟 Why Adopt?
+*Animal rights and welfare are at the core of our mission.*
+Every year, countless animals end up in shelters. Adopting a pet saves two lives: the one you adopt and the one who takes their place in the shelter. RescuPaws advocates for **#AdoptDontShop**, promoting the idea that love doesn't have a price tag and that every animal deserves a warm home, fast.
-After following the installation steps you can customize your project.
+---
-The screens and widgets that
-are inside the project can be easily replaced or removed. They are supposed to give the user a basic
-understanding of the relations between widgets and some good practices.
+## ✨ Key Features
-The code includes some
-comments with documentation and examples.
+* **⚡ 2-Tap Adoption:** A streamlined process designed to be as fast as possible. See a pet you love? Connect in seconds.
+* **❤️ Tinder-Like Swiping:** An intuitive, card-based interface to browse through adoptable pets near you. Swipe right to favorite, swipe left to pass.
+* **🎨 Premium UI/UX:** A visually stunning interface designed in **Figma**, featuring smooth animations, glassmorphism elements, and a vibrant color palette (using `FlexColorScheme`).
+* **🔐 Secure Authentication:** Seamless sign-in with Google, Apple, or Email via Firebase Auth.
+* **📍 Location-Based:** Find pets closest to you with integrated location services.
+* **📸 Rich Profiles:** Detailed pet profiles with multi-image galleries and essential information.
-The examples can be found by searching for "Example:"
-inside the project files.
+---
-### Changing the package and app name
+## 🛠 Technical Architecture
-You can follow the instructions in this [Stackoverflow issue](https://stackoverflow.com/a/51550358).
+RescuPaws is built with scalability and performance in mind, utilizing the latest advancements in the Flutter ecosystem.
-### State management
+* **Framework:** [Flutter](https://flutter.dev/) (SDK >=3.22.0)
+* **Architecture:** **MVVM** (Model-View-ViewModel) for clean separation of concerns and testability.
+* **State Management:** [Riverpod](https://riverpod.dev/) (v3.0.0-dev) - Leveraging the latest capabilities for robust state handling.
+* **Backend & Cloud:**
+ * **Firebase:** Authentication, Cloud Firestore (Database), Storage.
+ * **REST API:** Integrated via [Dio](https://pub.dev/packages/dio) and [Retrofit](https://pub.dev/packages/retrofit) for external data handling.
+ * **Supabase:** (Optional/Hybrid integration for backend services).
+* **Navigation:** [GoRouter](https://pub.dev/packages/go_router) for declarative routing and deep linking.
+* **Local Storage:** [Hive](https://pub.dev/packages/hive) & [GetStorage](https://pub.dev/packages/get_storage) for efficient local caching.
+* **Code Generation:** Utilizes `build_runner`, `freezed`, `json_serializable`, and `riverpod_generator` to reduce boilerplate and ensure type safety.
+* **External Assets:** Material Design 3, Ionicons, Lottie Animations.
-The project uses [Riverpod](https://pub.dev/packages/flutter_riverpod) for state management. And instead of using old fashioned Provider.of(context) it uses [Riverpod_annotation](https://pub.dev/packages/riverpod) and [Freezed_annotation](https://pub.dev/packages/freezed_annotation) for immutable state.
+---
-A new [riverpod_generator](https://pub.dev/packages/riverpod_annotation) package has been published as part of the Riverpod 2.0 release. This introduces a new @riverpod annotation API that you can use to automatically generate providers for classes and methods in your code (using code generation). To learn about it, read: [How to Auto-Generate your Providers with Flutter Riverpod Generator](https://codewithandrea.com/articles/flutter-riverpod-generator/).
+## 🚀 Getting Started
-### How can we manage state with Riverpod annotations and Freezed annotations?
+To get a local copy up and running, follow these simple steps.
-It is very simple. First, create a freezed ui model class. For example:
+### Prerequisites
-```dart
-import 'package:freezed_annotation/freezed_annotation.dart';
+* Make sure you have Flutter installed.
+ ```bash
+ flutter doctor
+ ```
-part 'counter_state.freezed.dart';
-part 'counter_state.g.dart';
+### Installation
-@freezed
-abstract class CounterUiModel with _$CounterUiModel {
- const factory CounterUiModel({
- @Default(0) int count,
- }) = _CounterUiModel;
+1. **Clone the repo**
+ ```bash
+ git clone https://github.com/yourusername/rescupaws.git
+ ```
+2. **Install packages**
+ ```bash
+ flutter pub get
+ ```
+3. **Run Code Generation**
+ Since this project uses Freezed and Riverpod Generator, you need to run the build runner:
+ ```bash
+ dart run build_runner build --delete-conflicting-outputs
+ ```
+4. **Run the App**
+ ```bash
+ flutter run
+ ```
- factory CounterUiModel.fromJson(Map json) =>
- _$CounterUiModelFromJson(json);
-}
-```
+---
-The freezed_annotation package will generate the toJson() and fromJson() methods for you. You can also use the @Default annotation to set the default value. In this case it will be 0.
-Then, create a logic for the state. For example:
+## 🤝 Contributing
-```dart
-import 'package:riverpod_annotation/riverpod_annotation.dart';
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
-import 'counter_ui_model.dart';
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
-part 'counter_logic.g.dart';
+---
-@riverpod
-class CounterLogic extends _$CounterLogic {
- @override
- CounterUiModel build() {
- /// build() is called when the provider is first initialized. This is where you can initialize your state.
- return CounterUiModel(count: 0);
- /// Note; the Default(0) in the CounterUiModel class will be used if you don't initialize the count here. So you can also just return CounterUiModel() here.
- }
+## 🕰️ Project History & Evolution
- void increment() {
- /// This is where you can update your state.
- state = state.copyWith(count: state.count + 1);
- }
-}
-```
+**From "Pati Pati" to "RescuPaws"**
-Thats it! Now you can run build_runner to generate the Providers for you instead of writing them yourself. For example:
+Every great project has a story. This application began its journey under the name **"Pati Pati"**. The original design reflected our initial vision for a friendly, warm pet adoption experience.
-```bash
-dart run build_runner build
-```
+While we transitioned to **RescuPaws** and refreshed the UI/UX to better serve a broader audience and align with new design standards, the original "Pati Pati" concept remains a core part of our DNA. We are proud of where we started and how far we've come.
-or if you want to watch for changes:
+
+
+
The original "Pati Pati" design concept.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Made with ❤️ for paw friends everywhere.
+
+ 
+ 
+ 
+ 
+ 
+