Skip to content

majdnasra2/pivot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

388 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pivot

Mobile-first 360° virtual tour creation using just your phone

Pivot is a lightweight platform for capturing, generating, and sharing immersive 360° walkthroughs of real estate spaces—no special hardware or technical skills required. Designed with short-term rental hosts, subletters, and real estate agents in mind, Pivot lets users scan their space room-by-room using their smartphone, automatically generate 360° views, and instantly share a complete virtual tour via link.

Unlike traditional solutions like Matterport, Pivot is fast, affordable, and accessible to everyday users.


🚀 Why Pivot?

The Problem

Creating professional virtual tours today is:

  • Expensive (e.g. Matterport costs hundreds of dollars per property)
  • Equipment-heavy (special cameras or contractors)
  • Out of reach for smaller hosts and renters

Our Solution

Pivot democratizes tour creation:

  • No hardware — just your phone. 20–40 images per room.
  • No stitching/editing — fully automated within minutes
  • No friction — built-in sharing, mobile/web/VR viewing

🧪 Demo

Example Tour Walkthrough

A sample walkthrough generated entirely using Pivot’s guided photo capture and auto-stitch pipeline. GIF compressed due to Github size constraints.


🔍 Key Features

Project Page
Project Page: Upload & organize photos, stitch 360° images, arrange room layout, annotate, and manage project settings
Explore Page
Explore Page: Browse tours created by users with your email domain (e.g., Stanford housing discovery)
  • Structured Projects – Set up projects, define rooms, and manage tour settings in one place
  • Flexible Photo Input – Capture guided 360° shots or upload your own panoramic images
  • Auto Tour Builder – Automatically stitches images and connects rooms into smooth, navigable walkthroughs
  • Interactive 360° Viewer – Pan, zoom, and transition between rooms on mobile or desktop
  • Floor Plan Editor – Visually arrange rooms to reflect real spatial layout
  • Custom Room Labels & Annotations – Name rooms and tag features (e.g., dishwasher, balcony) with icons or notes
  • Explore by Organization – Discover public tours made by others with your domain (e.g., @stanford.edu)
  • Privacy Controls & Sharing – Public, private, or password-protected tours with link/embedding options

🛠️ Tech Stack

  • Frontend (Web): React + TypeScript
  • Mobile App: React Native
  • Backend: Supabase (RLS-secured), PostgreSQL
  • Image Processing: AWS + PTGui CLI (stitching 20–40 smartphone photos into 360° images in minutes)
  • Authentication & Sharing: Supabase Auth + storage rules to support:
    • Public links
    • Org-only access (e.g., @stanford.edu)
    • Private/internal tours

🎮 VR Viewer

This folder contains the Unity project that allows users to experience a 360° walkthrough of their space in virtual reality.


📊 Competitive Snapshot

Pivot Matterport
Hardware Required No Yes
Cost Free $$$ per tour
Time to Publish Minutes Hours/days
Skill Required None Moderate
Shareability Web, mobile, VR Web, mobile, VR
Ideal For Small hosts, renters, student housing Enterprise, realtors

Pivot isn’t trying to replace Matterport for luxury listings—it’s unlocking virtual tours for the 90% of the market they can’t serve.


🎓 Project Info

This prototype was developed as part of a Stanford CS210 senior project.

Contributors:

Special thanks to our TA Natalie Greenfield and instructor Jay Borenstein


📁 Repo Structure

.
├── README.md             # Project overview and media
├── archive/              # Legacy or in-progress code
├── img/                  # Media assets for README
├── mobile_app/           # React Native capture app
├── vr_viewer/            # Unity-based VR walkthrough viewer
└── webapp/               # Web-based project/tour management interface

## 📎 Additional Resources

- 📘 [Team Wiki Page](https://github.com/cs210/Pivot/wiki)  
- 📐 [Team Coding Standards](https://github.com/cs210/Pivot/wiki/Team-Coding-Standards)  
- 📄 [Product Requirements Document](https://docs.google.com/document/d/1jG3TpzOdq8mq9hlyTwwn-EBwxiXAfL_b9FL28QPo6WE/edit?tab=t.0#heading=h.p6o1yo1yd1du)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors