Commit d1607b82 authored by Alfakhori's avatar Alfakhori
Browse files

Update README.md

parent 2cb2e972
## Overview ## Overview
An augmented reality navigation app that helps students and visitors move around campus efficiently. Develop a WebAR application using **Three.js** that allows users to design their own urban planning scenarios directly in AR.
The system overlays **AR arrows** for turn-by-turn guidance and integrates a playful **Tap-to-Plant** function where users can place virtual plants along their route. The system should provide a **library of 3D models (GLTF/GLB)** such as trees, benches, lamp posts, or small buildings.
Users can **select, place, and arrange models** in outdoor AR space through an interactive interface.
The app should also support **saving and retrieving scenes**, either locally (browser storage) or via a simple cloud service.
The focus is on creating a **working MVP in 2 days**: clear AR navigation + a small add-on for engagement. **Goal**: Create a working **MVP in 2 days** with model placement, scene saving, and retrieval.
--- ---
## Targets ## Targets
- **AR arrows for navigation** between selected campus POIs (classrooms, labs, cafeteria, library). - WebAR interface with **model library** (GLTF assets for urban furniture, greenery, etc.)
- **Smooth transitions** between outdoor navigation (GPS) and indoor areas (simple building model). - **Interactive placement**: users can tap to position, rotate, and scale objects
- **Tap-to-Plant feature:** users can tap the ground to add a virtual plant/tree at a POI. - **Scene management**: save and load scenes (local storage or cloud)
- **Info pop-ups (optional):** show POI name or basic info when approached. - **Simple UI** for browsing and selecting models
- (Optional) allow users to **share their designs** (export JSON or scene link)
--- ---
## Data Needs ## Data Needs
- Basic campus geodata (paths, entrances, 5–10 key POIs). - GLTF/GLB models for urban elements (trees, benches, streetlights, facades, etc.)
- Simplified building model (GeoJSON or IFC/CityGML). - Simple outdoor test area (GPS-based anchor or surface detection)
- GPS coordinates of outdoor POIs. - Basic metadata for models (name, category, scale)
--- ---
## Acceptance Criteria ## Acceptance Criteria
- Can a student follow **AR arrows** to reach a POI? - Can a user **place multiple objects** from the model library in AR?
- Are the AR arrows **legible and correctly placed**? - Can objects be **moved, rotated, and scaled** interactively?
- Can users **tap to plant** at least one virtual object in AR? - Can the scene be **saved and retrieved** successfully?
- Navigation and planting work in **WebAR (no installation)**. - Does the WebAR app run smoothly on a **mobile browser (WebXR)** without installation?
--- ---
## Environment Setup ## Environment Setup
- **Framework**: WebXR + Three.js (alternative: Babylon.js, AR.js)
**Mobile:** Android - **Mobile**: Android (Chrome with WebXR support)
**Web AR:** WebXR with Three.js / Babylon.js / AR.js - **Storage**: LocalStorage / IndexedDB / lightweight cloud DB (e.g., Firebase)
- **UI/UX**: Model browser, simple transformation controls, responsive layout
**GIS & Spatial:** QGIS (campus map prep), GeoJSON for simplified campus data - **OS for development**: Mac / Windows
**UI/UX:** Clear arrows, simple plant models, responsive AR labels
**OS:** Mac / Windows for development
--- ---
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment