Skip to content

TBWOnboard-2024/front-end

Repository files navigation

RealtyHub 🏠

A decentralized real estate platform built on BNB Chain that enables property listing, buying, and renting with cryptocurrency payments and smart contract integration.

Features 🌟

  • Property Listing & Management
  • Buy/Rent Properties with Cryptocurrency
  • BNPL (Buy Now Pay Later) System
  • Smart Contract-based Transactions
  • Fractional Property Ownership
  • Collateralized Payments Support
  • Interactive Property Search
  • Secure Wallet Integration

Tech Stack 💻

  • Frontend: Next.js 14, TypeScript, TailwindCSS, DaisyUI
  • Blockchain: BNB Chain (BSC Testnet)
  • Web3 Integration: Wagmi, Viem, RainbowKit
  • File Storage: Pinata IPFS
  • Development Tools: Yarn, Prettier, ESLint

Getting Started 🚀

Prerequisites

  • Node.js >= 18.18.0
  • Yarn package manager
  • MetaMask or any Web3 wallet

Installation

  1. Clone the repository
git clone https://github.com/yourusername/realtyhub.git
cd realtyhub
  1. Install dependencies
yarn install
  1. Start the development server
yarn start

The app will be available at

http://localhost:3000

Project Structure 📁

packages/
├── nextjs/ # Next.js frontend application
│ ├── app/ # App router pages
│ ├── components/ # React components
│ ├── hooks/ # Custom React hooks
│ ├── public/ # Static assets
│ ├── styles/ # Global styles
│ └── utils/ # Utility functions

Roadmap 🗺️

Phase 1: Ideation and Concept Development

  • Define the project's scope, vision, and objectives.
  • Research legal and regulatory requirements for tokenized real estate transactions.
  • Design the dual marketplace architecture (Full Ownership & Fractional Ownership).
  • Draft smart contract specifications.

Phase 2: Development and Testing

  • Smart Contract Development:
    • Develop and test the Property NFT contract to tokenize real-world assets.
    • Implement the Full Ownership Marketplace with features like buy, bid, and installment plans.
    • Build the Fractional Ownership Marketplace to facilitate share-based investments using ERC-20 tokens.
  • Frontend and Backend Development:
    • Create a user-friendly frontend for property listing, purchasing, and investment management.
    • Build a scalable backend to process transactions and manage property metadata using IPFS.
    • Integrate blockchain APIs for seamless on-chain interactions and real-time updates.
    • Conduct end-to-end testing for security, usability, and compliance with blockchain best practices.

Phase 3: Alpha Launch and Feedback

  • Launch the alpha version of RealtyHub on the testnet.
  • Onboard pilot users (sellers, buyers, and investors) to gather initial feedback.
  • Monitor platform performance, resolve bugs, and improve user experience.

Phase 4: Legal and Compliance Review

  • Ensure compliance with jurisdiction-specific property and securities laws.
  • Formalize processes for real-world ownership transfer and rental income distribution.
  • Collaborate with legal advisors to align platform operations with regulatory requirements.

Phase 5: Mainnet Launch

  • Deploy RealtyHub on the blockchain mainnet.
  • Enable live transactions for both full and fractional property ownership.
  • Launch targeted marketing campaigns to onboard users and drive platform adoption.

Phase 6: Expansion and Features Enhancement

  • Add advanced features such as rental income distribution for fractional owners and DeFi integrations.
  • Partner with property management firms and real estate agencies to scale operations.
  • Expand support to multiple jurisdictions and real estate markets worldwide.

Phase 7: Community Growth and Governance

  • Establish a decentralized governance system via a DAO for community-driven decision-making.
  • Foster user engagement through incentives and token-based rewards.
  • Continuously enhance RealtyHub with new features based on market trends and user feedback.

Contributing 🤝

Contributions are welcome! Please read our Contributing Guidelines for details on our code of conduct and the process for submitting pull requests.

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

Team 👥

  • Kevo - Fullstack Developer
  • Chek - Smart Contract Developer

Support 💬

For support, please join our community channels or create an issue in the repository.


Built with ❤️ using 🏗 Scaffold-ETH 2

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published