🏡 Real Scout – Real Estate App

A modern cross-platform real estate application built with React Native, designed for browsing, searching, and managing property listings with ease.

📋 Table of Contents

1. 🤖 Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🤸 Quick Start
5. 📞 Contacts
6. 🚀 Show Your Support

---

🤖 Introduction

Real Scout is a full-stack real estate mobile app built using React Native, Expo SDK 52, Appwrite, Tailwind CSS, and TypeScript.
It allows users to search, filter, and view property details, save favorites, and manage their profiles — all in one seamless and visually appealing interface.

---

⚙️ Tech Stack

• Expo – Expo is an open-source platform for building universal native apps (Android, iOS, web) using JavaScript/TypeScript and React Native. It features file-based routing via Expo Router, fast refresh, native modules for camera/maps/notifications, over-the-air updates (EAS), and streamlined app deployment.
• React Native – React Native is a framework for building mobile UIs with React. It enables component‑based, cross-platform development with declarative UI, deep native API support, and is tightly integrated with Expo for navigation and native capabilities.
• Appwrite – Appwrite is an open-source backend-as-a-service platform offering secure authentication (email/password, OAuth, SMS, magic links), databases, file storage with compression/encryption, real-time messaging, serverless functions, and static site hosting via Appwrite Sites—all managed through a unified console and microservices architecture.
• TypeScript – TypeScript is a statically-typed superset of JavaScript providing type annotations, interfaces, enums, generics, and enhanced tooling. It improves error detection, code quality, and scalability—ideal for robust, maintainable projects.
• NativeWind - NativeWind brings Tailwind CSS to React Native and Expo, allowing you to style mobile components using utility-first classes for fast, consistent, and responsive UI design.
• Tailwind CSS – Tailwind CSS is a utility-first CSS framework enabling rapid UI design via low-level classes. In React Native/Expo, it’s commonly used with NativeWind to apply Tailwind-style utilities to mobile components.

🎨 UI/UX Design

The entire interface of Real Scout – Real Estate App was designed with a focus on delivering a seamless and engaging property-browsing experience.
From the onboarding screens to property detail views, every element follows a clean, modern, and user-friendly design system that enhances both functionality and aesthetics.

✨ Crafted with attention to detail to ensure a smooth user journey across Android and iOS platforms.

---

🔋 Features

• 🔐 Google Authentication – Secure login for users.
• 🏠 Home Page – Shows latest and recommended properties with search and filter.
• 🌎 Explore Page – Browse all property types with an intuitive UI.
• 🏡 Property Details Page – View photos, pricing, and full property information.
• 👤 Profile Page – Manage profile details and preferences.
• ⚡ Centralized Data Fetching – Inspired by TanStack’s useQuery for efficient API calls.

---

🤸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

• Git
• Node.js
• npm (Node Package Manager)

Cloning the Repository

git clone https://github.com/Itssanthoshhere/Real-Scout.git
cd Real-Scout

Installation

npm install

Set Up Environment Variables

Create a new file named .env.local in the root of your project and add the following content:

EXPO_PUBLIC_APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
EXPO_PUBLIC_APPWRITE_PROJECT_ID=
EXPO_PUBLIC_APPWRITE_DATABASE_ID=
EXPO_PUBLIC_APPWRITE_GALLERIES_COLLECTION_ID=
EXPO_PUBLIC_APPWRITE_REVIEWS_COLLECTION_ID=
EXPO_PUBLIC_APPWRITE_AGENTS_COLLECTION_ID=
EXPO_PUBLIC_APPWRITE_PROPERTIES_COLLECTION_ID=

Replace the values with your actual Appwrite credentials. You can obtain these credentials by signing up & creating a new project on the Appwrite Dashboard.

Start the app

 npx expo start

In the output, you'll find options to open the app in a

• development build
• Android emulator
• iOS simulator
• Expo Go, a limited sandbox for trying out app development with Expo

You can start developing by editing the files inside the app directory. This project uses file-based routing.

---

🙌 Special Thanks

Inspired by JavaScript Mastery’s tutorials, but built with my own improvements, custom UI, and bug fixes.

---

🔗 Contacts

Feel free to connect with me:

• GitHub: Itssanthoshhere
• LinkedIn: Santhosh VS

---

⭐️ Show Your Support

If you liked this project, drop a ⭐ on the repo and share it with others!