Model Verse 🌌

Build Your Own Sketchfab in Minutes - A minimalist 3D model sharing platform powered by @blendviewer/core

---

✨ What is Model Verse?

A production-ready Sketchfab alternative you can deploy in 5 minutes. No backend coding, no infrastructure setup, no DevOps headaches.

Perfect for:

• 🎨 3D Artists - Build your portfolio site
• 🎮 Game Studios - Internal asset library
• 🏫 Educators - 3D model repository for students
• 🏢 Enterprises - Private 3D asset management
• 🚀 Startups - Launch your 3D marketplace MVP

---

🚀 Deploy in 3 Commands

git clone https://github.com/yourusername/model-verse.git
cd model-verse && npm install
npm run dev

That's it! Your Sketchfab-like platform is running at http://localhost:5173 🎉

---

🎯 Model Verse vs Sketchfab

Feature	Model Verse	Sketchfab
Setup Time	5 minutes	Hours (SaaS signup)
Backend Required	❌ None	✅ Complex infra
Customization	100% control	Limited
File Formats	100+	~30
Self-Hosted	✅ Your domain	❌ Sketchfab.com only
White Label	✅ Fully branded	❌ Sketchfab branding
Cost	Free (open source)	$69+/month

Model Verse = Sketchfab's features - Sketchfab's complexity

---

💡 How Does It Work?

┌─────────────────────────────────────┐
│  Your React Frontend (5 minutes)    │
├─────────────────────────────────────┤
│  @blendviewer/core (BaaS)           │
│  ├─ VisionScope (3D Viewer)         │
│  ├─ OpenBase (Database)             │
│  └─ File Storage (OSS)              │
└─────────────────────────────────────┘

No backend code needed! @blendviewer/core is like Supabase for 3D assets:

• ✅ 3D Rendering - Built-in viewer for 100+ formats
• ✅ Database - Store model metadata
• ✅ File Storage - Handle uploads automatically
• ✅ Authentication - Phone/Email/WeChat login
• ✅ CDN - Global file delivery

You just build the UI and deploy!

---

🎨 Core Features

📤 Upload & Preview

• Drag & drop GLB, FBX, OBJ, STL, BLEND files
• Auto-generate thumbnails
• Real-time 3D preview

🔍 Browse & Search

• Infinite scroll gallery
• Category filters
• Full-text search

👥 User Management

• Anonymous uploads
• Phone/Email login
• WeChat integration (China)

🎨 Developer Experience

• React 18 + Vite
• Tailwind CSS + shadcn/ui
• Clean, production-ready code
• Full TypeScript support

---

📸 Screenshots

Minimalist Homepage	One-Click Upload
Explore Gallery	Interactive 3D Viewer

---

🛠️ Customization Examples

Want to customize? It's just React:

Change Branding (30 seconds)

// src/config.js
export const SITE_NAME = "MyStudio3D"
export const PRIMARY_COLOR = "#FF6B6B"

Add Custom Categories (1 minute)

// src/constants.js
export const CATEGORIES = [
  'Characters', 'Vehicles', 'Buildings',
  'Your Custom Category' // ← Add here
]

Integrate Analytics (2 minutes)

// src/App.jsx
import { Analytics } from '@vercel/analytics'
<Analytics /> // ← Done!

Full control over every pixel!

---

🚀 Production Deployment

One command to deploy everything:

npm run deploy

That's it! @blendviewer/core handles:

• ✅ Build optimization
• ✅ CDN distribution
• ✅ SSL certificates
• ✅ Custom domain setup
• ✅ Automatic scaling

Live in 2 minutes with zero DevOps!

---

🌟 Real-World Use Cases

🎨 3D Artist Portfolio

Deploy your own gallery in minutes. No Sketchfab subscription needed.

🎮 Game Studio Asset Library

Private internal platform for sharing character models, props, environments.

🏫 Educational Platform

Build a 3D model library for architecture, biology, engineering courses.

🏢 Enterprise Asset Management

Self-hosted solution for managing 3D product catalogs, CAD files.

🚀 Launch Your 3D Marketplace

Use Model Verse as your MVP - add payments, licensing, commercial features.

---

🛠️ Tech Stack

• Frontend: React 18 + Vite
• UI: Tailwind CSS + shadcn/ui
• 3D Engine: @blendviewer/core
• BaaS: BlendViewer Cloud (built-in)
• Auth: Phone/Email/WeChat
• Storage: OSS (object storage)

Zero backend code. Zero infrastructure setup.

---

📚 Documentation

• 📖 Getting Started: Installation Guide
• 🎨 Customization: Theme & Branding
• 🔌 API Reference: @blendviewer/core Docs
• 💬 Community: Join Discord

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md

Feature Ideas:

• 🌍 Internationalization (i18n)
• 🔍 Advanced search & filters
• 🏷️ Tagging & collections
• 💬 Comments & reviews
• 📊 Analytics dashboard
• 💰 E-commerce integration

---

🎓 Who's Using Model Verse?

• 3D Artists - Personal portfolio sites
• Game Studios - Internal asset management
• Educational Institutions - 3D model libraries
• Enterprises - Product catalog systems
• Startups - 3D marketplace MVPs

---

⚡ Performance

• First Load: < 2s
• Upload Speed: < 5s for 20MB files
• 3D Rendering: 60 FPS
• Formats Supported: 100+ (GLB, FBX, OBJ, STL, BLEND, 3DS, DAE...)

---

📝 License

MIT License - Free for commercial use!

Feel free to:

• ✅ Use for your portfolio
• ✅ Build SaaS products
• ✅ White-label for clients
• ✅ Modify and redistribute

---

🙏 Acknowledgments

• Built with ❤️ using @blendviewer/core
• Inspired by Sketchfab's vision
• UI components from shadcn/ui

---

🔗 Links

• 🌐 Live Demo: model-verse.blendviewer.com
• 📖 Documentation: developer.blendviewer.com
• 💬 Community: blendviewer.com
• 🐙 GitHub: @blendviewer/core

---

⭐ Star this repo if you find it useful! ⭐

_{Build your Sketchfab in minutes, not months}

Made with ❤️ by developers, for developers