🏠 DomeLink — AI-Powered Architect Discovery & Project Intelligence Platform

Connecting Homeowners with the Right Architects using AI, Real-Time Insights, and Immersive UX

---

🚀 Overview

DomeLink is a full-stack, AI-enhanced platform that intelligently connects homeowners with architects through data-driven matching, immersive 3D experiences, and role-aware dashboards.

The platform simulates a real startup-grade product with:

• 🤖 AI assistance across workflows
• 🧠 intelligent architect recommendations
• 📊 rich analytics dashboards
• 🏗️ interactive 3D architectural experience
• 🔐 secure dual-role authentication
• 💬 AI chatbot copilot

Built to demonstrate production-level full-stack engineering + premium UX execution.

---

✨ Key Highlights

🧠 AI-Driven Intelligence

• Smart architect matching engine
• AI cost estimation assistant
• Contextual AI insights across dashboards
• Floating AI chatbot copilot

🏗️ Immersive Experience

• Interactive 3D home hero (React Three Fiber)
• Premium motion system (Framer Motion)
• Depth-based UI interactions
• Smooth page transitions

👥 Dual Role System

• Homeowner experience
• Architect professional portal
• Role-aware navigation
• Protected routes & JWT auth

📊 Production-Grade Dashboards

• Activity analytics
• Engagement metrics
• Review intelligence
• Notification center
• Financial tracking

---

🧩 Feature Matrix

Feature	Homeowner	Architect	AI Powered
Smart Matching	✅	—	✅
Portfolio System	—	✅	—
Project Brief Wizard	✅	—	✅
Analytics Dashboard	✅	✅	—
Review System	✅	✅	✅
AI Chatbot	✅	✅	✅
3D Experience	✅	✅	—
Notification Center	✅	✅	—

---

🧠 System Architecture

Client (React + Vite)
        ↓
API Layer (React Query)
        ↓
Node.js + Express Backend
        ↓
MongoDB Database
        ↓
OpenAI Services

Frontend

• React + TypeScript
• Tailwind + shadcn/ui
• Framer Motion
• React Query
• React Three Fiber

Backend

• Node.js + Express
• TypeScript
• MongoDB + Mongoose
• JWT Authentication
• OpenAI Integration
• Modular MVC structure

---

🎬 Demo Accounts

Use these to explore the full experience:

🏠 Homeowner Demo

Email: demo.homeowner@domelink.com
Password: Demo@123

🧑‍🎨 Architect Demo

Email: demo.architect@domelink.com
Password: Demo@123

✔ Dashboards fully populated ✔ Analytics visible ✔ Messages & notifications seeded ✔ Portfolio & reviews populated

---

📊 UX & Motion Philosophy

DomeLink follows a premium restrained motion system:

• Spring-based micro-interactions
• Staggered data reveals
• Depth-aware hover states
• Non-blocking 3D rendering
• Skeleton-first loading

Goal: feel expensive, not flashy.

---

⚡ Performance Optimizations

• React Query caching strategy
• Memoized heavy components
• DPR-capped 3D rendering
• Lazy-loaded scenes
• Intersection-observer reveals
• Minimal re-render surfaces

---

🔐 Security & Auth

• JWT access control
• Role-based route guards
• Protected API middleware
• Secure password hashing (bcrypt)
• Environment-based secrets

---

🛠️ Local Development Setup

1️⃣ Clone the repo

git clone https://github.com/Krish00711/DomeLink.git
cd DomeLink

---

2️⃣ Backend setup

cd domelink/backend
npm install

Create .env:

MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_secret
OPENAI_API_KEY=your_key
PORT=5000

Run:

npm run dev

---

3️⃣ Frontend setup

cd ../frontend
npm install
npm run dev

---

🧪 Demo Data

Seed script included:

npm run seed

Populates:

• users
• projects
• reviews
• analytics
• notifications
• messages

---

🎯 Why DomeLink Stands Out

✅ Full production architecture ✅ AI deeply integrated (not superficial) ✅ Immersive 3D experience ✅ Role-aware product design ✅ Realistic seeded ecosystem ✅ Premium motion system ✅ Scalable backend structure

Built to reflect real startup engineering standards.

---

🚀 Future Enhancements

• Real-time WebSocket chat
• Architect bidding engine
• AI floor-plan analyzer
• Email notification pipeline
• Multi-tenant architecture

---

👨‍💻 Author

Krish

Engineering student building production-grade AI web platforms.

---

⭐ If you found this impressive, consider starring the repo!