Skip to content

El-swaggerito/Real-Estate

Repository files navigation

Project: RealEstate Pro

RealEstate Pro is a modern web application designed to help users find their dream properties. It offers a user-friendly interface to browse property listings, view property details, and calculate potential mortgage payments.

Features

  • Splash Screen: An engaging animated entry point to the application.
  • User Authentication: Secure login functionality for users.
  • User Profiles: Allows users to manage their profile information.
  • Property Listings: Browse a comprehensive list of available properties.
  • Detailed Property View: View in-depth information for each property, including images and specifications.
  • Mortgage Calculator: An integrated tool to help users estimate mortgage payments.
  • Responsive Design: Adapts to various screen sizes for a seamless experience on desktop and mobile devices.

Tech Stack

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

  • Node.js (v18.x or later recommended)
  • pnpm (or npm/yarn)

Installation

  1. Clone the repository: If you haven't already, clone the repository that contains this project.

    git clone <repository-url>
    cd <project-directory-name>

    (Replace <repository-url> and <project-directory-name> with the actual URL and local directory name, likely my-v0-project or v0-real-estate-p4ff5irjlx6)

  2. Install dependencies: This project uses pnpm as indicated by the pnpm-lock.yaml file.

    pnpm install

    If you prefer npm or yarn, you can delete pnpm-lock.yaml and run:

    npm install # or yarn install
  3. Run the development server:

    pnpm dev

    Or using npm:

    npm run dev

    Or using yarn:

    yarn dev

    Open http://localhost:3000 with your browser to see the result. The application will start with a splash screen and then redirect to /home.

Folder Structure

Here's a brief overview of the main project directories:

my-v0-project/
├── app/                  # Next.js App Router: contains all routes, layouts, and pages
│   ├── home/             # Home page
│   ├── login/            # Login page
│   ├── mortgage-calculator/ # Mortgage calculator page
│   ├── profile/          # User profile page
│   ├── properties/       # Property listings page
│   ├── property/[id]/    # Individual property detail page
│   ├── layout.tsx        # Root layout component
│   └── page.tsx          # Root page (splash screen)
├── components/           # Reusable React components
│   └── ui/               # UI components (likely Shadcn/UI)
├── lib/                  # Utility functions and shared logic
│   ├── properties.ts     # Property-related utilities
│   └── utils.ts          # General utilities
├── public/               # Static assets (images, fonts, etc.)
├── styles/               # Global styles (additional to app/globals.css)
├── next.config.mjs       # Next.js configuration
├── package.json          # Project metadata and dependencies
└── tsconfig.json         # TypeScript configuration

Available Scripts

The package.json includes the following scripts:

  • pnpm dev: Starts the Next.js development server.
  • pnpm build: Builds the application for production.
  • pnpm start: Starts the Next.js production server.
  • pnpm lint: Runs Next.js's built-in ESLint checks.

Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

  1. Fork the repository (if you are an external contributor).
  2. Create a new branch (git checkout -b feature/your-feature-name).
  3. Make your changes.
  4. Commit your changes (git commit -m 'feat: Add some amazing feature').
  5. Push to the branch (git push origin feature/your-feature-name).
  6. Open a Pull Request against the main branch.

The upper part of this README is automatically managed by v0.dev. The sections from "Project: RealEstate Pro" onwards provide detailed project information.

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •