Skip to content

sohamkoltecc-ai/VirtualHomeTour

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

10 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ  Virtual House Tour

A modern Flutter-based 360ยฐ Virtual House Tour App that allows users to explore a property using immersive panoramic images and an interactive floor map.

Users can start from a floor plan, select a room, and navigate naturally through the property using hotspot-based movement similar to real-world virtual tour experiences.


โœจ Features

๐ŸŒ 360ยฐ Panorama Viewing

  • Smooth panoramic image viewing
  • Drag to look around
  • Mobile-friendly experience
  • Immersive room exploration

๐Ÿ“ Interactive Hotspots

  • Clickable navigation points inside panoramas
  • Move between connected rooms
  • Custom room routing system
  • Easily expandable to larger properties

๐Ÿ—บ Interactive Floor Map

  • View property layout
  • Zoom and pan support
  • Click room markers to jump directly into a room
  • Quick navigation across the property

๐Ÿšช Room-to-Room Navigation

Current demo includes:

  • Entrance
  • Bathroom
  • Hall
  • Corner Area
  • Kitchen Entrance
  • Kitchen

๐Ÿ“ฑ Responsive Flutter Application

  • Android support
  • iOS support
  • Windows support
  • Web support (experimental)

๐ŸŽจ Modern UI

  • Clean user interface
  • Smooth transitions
  • Interactive navigation
  • Simple and intuitive experience

Tutorial

Tutorial.mp4

๐Ÿ“ธ Screenshots

Screenshot_1782561252
Screenshot_1782561257
Screenshot_1782561266
Screenshot_1782561283

๐Ÿ›  Built With

  • Flutter
  • Dart
  • panorama_viewer

๐Ÿ“‚ Project Structure

lib/
โ”‚
โ”œโ”€โ”€ main.dart
โ”‚
โ”œโ”€โ”€ data/
โ”‚   โ””โ”€โ”€ tour_data.dart
โ”‚
โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ panorama_node.dart
โ”‚   โ””โ”€โ”€ room_hotspot.dart
โ”‚
โ”œโ”€โ”€ screens/
โ”‚   โ”œโ”€โ”€ home_screen.dart
โ”‚   โ”œโ”€โ”€ map_screen.dart
โ”‚   โ””โ”€โ”€ panorama_screen.dart

๐Ÿš€ Getting Started

Prerequisites

  • Flutter SDK
  • Android Studio / VS Code
  • Android Emulator or Physical Device

Installation

Clone the repository:

git clone https://github.com/sohamkoltecc-ai/virtual-house-tour.git

Move into project:

cd virtual-house-tour

Install dependencies:

flutter pub get

Run the application:

flutter run

๐Ÿ“ฆ Dependencies

Add the following package:

dependencies:
  panorama_viewer: ^2.0.4

Install packages:

flutter pub get

๐Ÿ–ผ Asset Structure

assets/
โ”‚
โ”œโ”€โ”€ floor_map.png
โ”‚
โ”œโ”€โ”€ panoramas/
โ”‚   โ”œโ”€โ”€ 1.jpg
โ”‚   โ”œโ”€โ”€ 2.jpg
โ”‚   โ”œโ”€โ”€ 3.jpg
โ”‚   โ”œโ”€โ”€ 4.jpg
โ”‚   โ”œโ”€โ”€ 5.jpg
โ”‚   โ””โ”€โ”€ 6.jpg
โ”‚
โ””โ”€โ”€ icon/
    โ”œโ”€โ”€ app_icon.png
    โ””โ”€โ”€ bg.png

๐Ÿ— How It Works

Floor Map Navigation

Users start by selecting a room from the floor map.

Floor Map
     โ†“
Select Room
     โ†“
Open Panorama

Panorama Navigation

Each panorama contains hotspots that connect to other rooms.

Entrance
   โ”œโ”€โ”€ Bathroom
   โ””โ”€โ”€ Hall

Hall
   โ”œโ”€โ”€ Corner
   โ”œโ”€โ”€ Kitchen Entrance
   โ””โ”€โ”€ Back

Kitchen Entrance
   โ”œโ”€โ”€ Kitchen
   โ””โ”€โ”€ Back

Room Graph

Entrance
โ”œโ”€โ”€ Bathroom
โ””โ”€โ”€ Hall
     โ”œโ”€โ”€ Corner
     โ””โ”€โ”€ Kitchen Entrance
             โ””โ”€โ”€ Kitchen

๐Ÿ”ฎ Future Improvements

  • Minimap inside panorama view
  • Animated hotspot indicators
  • Floor switching support
  • Multiple property support
  • Property information page
  • Guided tour mode
  • VR mode support
  • Cloud-based property loading
  • Real estate listing integration
  • Multi-language support

๐ŸŽฏ Use Cases

  • Real Estate Property Tours
  • Interior Design Showcases
  • Virtual Museums
  • Educational Tours
  • Architecture Presentations
  • Hotel Room Exploration
  • Apartment Walkthroughs

๐Ÿค Contributing

Contributions, issues, and feature requests are welcome.

Feel free to fork the project and submit a pull request.


โญ Support

If you found this project useful, consider giving it a star on GitHub.

It helps others discover the project and supports future development.


Credits

Assets shown Here Belong to its original Devloper @StylArts.


๐Ÿ“„ License

This project is licensed under the MIT License.

Feel free to use, modify, and distribute it for personal or commercial projects.

About

๐Ÿ  Flutter-based 360ยฐ Virtual House Tour app with panorama navigation, interactive hotspots, and floor-map based room exploration.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors