immersive2/ROADMAP.md
Michael Mainguy 0e053bf69c Add Quest VR onboarding flow with auto-entry prompt
Implemented comprehensive VR onboarding experience for Quest users:

- Add demo database template with pre-built architecture diagram
- Implement automatic demo template loading on first visit
- Create VREntryPrompt component for seamless VR mode entry
- Add device detection utilities for Quest/VR headset identification
- Integrate export/import functionality for diagram templates
- Add About page with device-aware CTA and VR benefits
- Remove legacy tutorial and FirstVisitVr modal for demo flow
- Add upgrade prompts and tiered feature configuration

Quest users now see prominent VR entry prompt when navigating to /db/** paths,
providing one-tap entry into immersive mode after scene initialization.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 10:47:28 -06:00

6.7 KiB

Immersive - Product Roadmap

Vision

Transform immersive into an accessible, intuitive WebXR diagramming platform that delivers a frictionless onboarding experience and sustainable growth path.


Phase 1: Onboarding & User Experience (Q1 2025)

1.1 Frictionless Entry

Goal: Reduce barriers to entry for new users

  • Redesign landing page to clearly guide users to immersive experience
  • Create one-click "Enter VR" / "Try Demo" workflow
  • Optimize initial load time and progressive loading
  • Add clear device compatibility messaging (desktop/VR)
  • Implement guest mode with no sign-in required for basic exploration

1.2 Marketing Content

Goal: Communicate value proposition effectively

  • Create 3-5 demo videos showcasing key features (30-60 seconds each)
    • Creating a basic diagram
    • VR interaction showcase
    • Collaboration features
    • Template usage
  • Develop tutorial video (2-3 minutes) explaining core workflows
  • Autoplay video carousel on landing page
  • Write marketing copy for landing page
    • Hero section with clear value proposition
    • Feature highlights
    • Use case examples
    • Call-to-action

1.3 In-Experience Tutorial

Goal: Replace external tutorial with immersive learning

  • Remove existing external tutorial system
  • Design in-VR tutorial experience with interactive steps
  • Implement progressive disclosure (teach as users interact)
  • Add contextual tooltips and hints in 3D space
  • Create "first-time user" detection and guided walkthrough
  • Add skip/replay tutorial options

1.4 Template System

Goal: Provide starting points for new users

  • Design template/example diagram system
  • Create 5-10 starter templates:
    • Simple organizational chart
    • Project workflow diagram
    • Concept mapping example
    • Architecture diagram
    • Spatial layout example
  • Build template browser UI (2D and VR)
  • Implement "New from Template" workflow
  • Add template preview/thumbnail generation

Phase 2: Collaboration & Sync (Q2 2025)

2.1 Cross-Device Sharing

Goal: Enable seamless content sharing between desktop and Quest

  • Research device-to-device sync options (WebRTC, local network)
  • Design sync architecture without backend dependency
  • Implement user content sync for signed-in users
  • Add fallback to server-based sync when needed
  • Create device pairing UI/workflow
  • Test sync reliability across desktop ↔ Quest
  • Add conflict resolution for simultaneous edits

Phase 3: Immersion & Environment (Q2-Q3 2025)

3.1 Audio Integration

Goal: Enhance presence with ambient soundscapes

  • Source/create ambient audio assets
    • Nature sounds (birds, wind, water)
    • Office ambience
    • Abstract/focus music
  • Implement spatial audio system
  • Add audio settings (volume, on/off, environment selection)
  • Create audio manager for seamless transitions
  • Add positional audio for collaboration (optional user voices)

3.2 Environment System

Goal: Provide varied immersive environments

  • Design environment switching architecture
  • Create environment presets:
    • Outdoor/nature scene
    • Modern office
    • Abstract/minimal space
    • Workshop/studio
  • Implement skybox and lighting variations
  • Build environment selector UI (2D and VR)
  • Optimize environment assets for performance
  • Add environment-specific audio pairing

Phase 4: User Feedback & Polish (Q3 2025)

4.1 In-VR Feedback Mechanism

Goal: Enable users to provide feedback without leaving VR

  • Design in-VR feedback form/interface
  • Implement voice-to-text option (VR accessibility)
  • Add screenshot/recording attachment capability
  • Create feedback submission backend
  • Build feedback review dashboard
  • Add "Report Bug" quick action in VR menu

4.2 Keyboard Improvements

Goal: Improve text input experience

  • Test system keyboard integration (Quest/desktop)
  • Evaluate custom keyboard vs. native keyboard UX
  • Implement system keyboard fallback where supported
  • Optimize keyboard positioning in VR space
  • Add keyboard shortcuts for power users (desktop)

Phase 5: Growth & Monetization (Q4 2025)

5.1 Marketing Roadmap

Goal: Build sustainable user acquisition

  • Define target audience segments
    • Educators
    • Remote teams
    • Designers/architects
    • Knowledge workers
  • Create content marketing strategy
    • Blog posts on use cases
    • Social media showcase
    • Community building (Discord/Reddit)
  • Develop SEO optimization plan
  • Plan partnership outreach (VR communities, productivity tools)
  • Create referral/sharing incentives
  • Build analytics dashboard for user metrics

5.2 Monetization Strategy

Goal: Establish path to sustainability

Potential Revenue Streams:

  • Freemium model research
    • Free tier: Limited diagrams, basic features
    • Pro tier: Unlimited diagrams, advanced features, collaboration
  • Team/Enterprise pricing
    • Private deployment options
    • Admin controls
    • Priority support
  • Template marketplace
    • Premium templates
    • Community submissions (revenue share)
  • Educational licensing
    • Institutional pricing
    • Classroom management features

Implementation:

  • Define pricing tiers and feature gates
  • Integrate payment processing (Stripe)
  • Build subscription management UI
  • Implement feature flags for tier differentiation
  • Create upgrade prompts and conversion flow
  • Add usage analytics for pricing optimization

Success Metrics

Phase 1-2 (Onboarding)

  • Time to first diagram creation < 2 minutes
  • Tutorial completion rate > 60%
  • Return user rate (7-day) > 30%

Phase 3-4 (Engagement)

  • Average session duration > 15 minutes
  • User satisfaction score > 4/5
  • Feedback submission rate (active users) > 10%

Phase 5 (Growth)

  • Monthly active users growth > 20% MoM
  • Free-to-paid conversion rate > 5%
  • Customer acquisition cost < lifetime value

Technical Debt & Infrastructure

Ongoing Priorities

  • Migration from legacy ConfigType to AppConfig
  • Performance optimization (target 90fps in VR)
  • Accessibility improvements (WCAG compliance)
  • Testing coverage > 70%
  • Documentation for contributors
  • CI/CD pipeline enhancements

Notes

Dependencies:

  • Auth0 for user authentication
  • PouchDB/CouchDB for data persistence
  • BabylonJS 8.x for rendering
  • Vite for build tooling

Platform Support:

  • Desktop browsers (Chrome, Firefox, Edge)
  • Meta Quest 2/3/Pro
  • Future: PSVR2, Vision Pro (evaluate demand)

Review Cadence: Quarterly roadmap review and adjustment based on user feedback and metrics.


Last Updated: 2025-11-19