floors.js

Product Introduction

1. Definition: floors.js is a zero-configuration JavaScript library (technical category: real-time engagement SDK) that transforms static websites into interactive 3D chat environments. It uses WebSockets and WebGL to create isometric rooms where visitors appear as avatars.
2. Core Value Proposition: It solves visitor disengagement by converting static pages into Habbo Hotel-style chat rooms, enabling real-time conversations without signups or backend setup. Primary keywords: real-time website chat, 3D visitor avatars, zero-config engagement tool.

Main Features

1. Auto-Generated Isometric Rooms: Scans site navigation to turn each page into a unique 3D room (walls, floor, windows) using Three.js. No manual routing config; override via data-pages attribute.
2. Real-Time Avatar Presence: Visitors instantly become pseudonymous 3D avatars with random names (e.g., "Bold Fox"). WebSocket connections track movement (click-to-walk) and sync positions across tabs.
3. Frictionless Chat System: Speech bubbles appear above avatars for real-time messaging. Supports pinned messages per room, link/promo blocking (data-no-links, data-no-promo), and Discord notifications via webhooks.
4. SPA/SSR Compatibility: Hooks into pushState/popstate for React, Next.js, Vue, and Shopify. Auto-reconnects on route changes; disables on excluded paths (data-exclude="/login").
5. Privacy-First Analytics: GDPR-compliant by default—uses localStorage for random IDs, zero cookies, and no IP logging.

Problems Solved

1. Pain Point: Static websites suffer from anonymous traffic (high bounce rates, zero conversions) due to lack of real-time engagement. Traditional chat widgets require logins or complex setups.
2. Target Audience:
   • Indie developers launching SaaS landing pages.
   • E-commerce owners (Shopify) needing live sales support.
   • Content marketers reducing drop-offs on blogs/documentation.
3. Use Cases:
   • Customer support during pricing page visits.
   • Virtual events on product launch pages.
   • Collaborative browsing for B2B demos.

Unique Advantages

1. Differentiation vs. Competitors: Unlike Intercom or Drift, floors.js requires no authentication, uses 0 cookies, and gamifies UX via 3D environments. Outperforms analytics tools by enabling live intervention.
2. Key Innovation: Dynamic room generation from existing HTML structure—no pre-defined 3D models or manual routing. WebSocket efficiency handles 100 concurrent users/site with auto-queuing.

Frequently Asked Questions (FAQ)

1. Does floors.js work with Shopify or WordPress?
   Yes. Embed the script tag in theme footers. Auto-detects routes; supports SPAs like Next.js via pushState integration.

2. How are visitor limits enforced?
   At 100 concurrent users, new visitors queue automatically. Slots free upon tab closure/navigation. No impact on active chatters.

3. Is floors.js GDPR compliant?
   Absolutely. Zero cookies, pseudonymous localStorage IDs, and no IP/personal data collection. Exceeds compliance by design.

4. Can I customize rooms or avatars?
   Partial customization: Add owner badges (data-owner-name), accent colors (data-accent="#FF6B00"), and per-room pinned messages. Avatars are auto-generated 3D blocks.

5. What if Cloudflare blocks floors.js?
   Whitelist floorsjs.com and wss://floorsjs.onrender.com in CSP headers. Disable "inline scripts" blocking in Cloudflare security settings.