Skip to content

aelng/Shop3D

 
 

Repository files navigation

3D Store Visualizer

A Shopify app that generates 3D models from product photos and provides interactive 3D product visualization for customers.

Overview

We aim to take one step closer to making ecommerce more "real". Seeing your products in 3D instead of as flat PNGs provides a more immersive shopping experience beyond traditional online stores.

This app enables Shopify merchants to:

  • Auto-generate 3D models from product images using AI
  • Display interactive 3D viewers on product pages
  • Allow customers to rotate, zoom, and inspect products in 3D
  • Support product variants with different models

Untitled design (2)

GPU Requirement Note

It is important to understand that TripoSR requires significant computational power. It is recommended that you use a >3000 series NVIDIA GPU with >12GB of VRAM if running the entire system in real time.

Here is an example of what happens when you use a GPU with less than optimal VRAM and older architecture (My old GTX 1080):

image

Architecture

┌───────────┐     ┌───────────────────┐     ┌───────────┐
│ Frontend  │ --> │      Backend      │ --> │   Worker  │
│  (React)  │     │ (Node.js + Rails) │     │  (Python) │
└───────────┘     └───────────────────┘     └───────────┘
                            │                     │
                            ▼                     ▼
  ┌────────────────────────────────────────────────┐
  │             Supabase (DB + Storage)            │
  └────────────────────────────────────────────────┘

image

Services

  1. Frontend - React + TypeScript + Shopify Polaris + Three.js
  2. Backend - Node.js + Express + Shopify API
  3. Worker - Python + Celery + TripoSR
  4. Rails Webhooks - Ruby on Rails + HMAC verification (optional)
  5. Theme Extension - Vanilla JS + Three.js for storefront

Tech Stack

  • Frontend: React, TypeScript, Vite, Shopify Polaris, React Three Fiber
  • Backend: Node.js, TypeScript, Express, Shopify API
  • Worker: Python, FastAPI, Celery, TripoSR, PyTorch
  • Webhooks: Ruby on Rails (minimal API-only)
  • Storage: Supabase (PostgreSQL + Object Storage)
  • Queue: Redis

Quick Start

Prerequisites

  • Node.js 20+
  • Python 3.11+
  • Ruby 3.2+ (optional)
  • Redis
  • Shopify Partner account
  • Supabase account

Setup

See SETUP.md for detailed configuration instructions.

About

Convert 2D store images to interactive 3D experiences in real time

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 42.1%
  • Python 32.5%
  • JavaScript 9.4%
  • CSS 5.8%
  • Ruby 5.2%
  • Liquid 4.1%
  • Other 0.9%