Skip to content

devamir99/3dglass_project

Repository files navigation

Product 3D Configurator

Live demo: devamir99.github.io/3dglass_project

An interactive 3D product configurator portfolio demo built with Three.js. Visitors customize frame, lens, and bridge colors in real time directly in the browser.

Three.js Vite License

Screenshots

3D configurator with live color customization

3D configurator demo

Landing sections — process and contact

Landing page sections

What this is

This repository is a portfolio demo showing how a physical product can be presented as an interactive 3D experience on the web. The sample model is a generic eyewear frame used for demonstration only.

Custom builds are available for brands that want their own product catalog, branding, and configurator UI.

Highlights

  • Real-time color customization with GSAP transitions
  • Style presets and per-part color swatches
  • Draco-compressed GLTF loading with progress indicator
  • Image-based lighting (RoomEnvironment + PMREM)
  • Responsive layout with mobile contact bar
  • Landing sections for features, use cases, and contact
  • Demo enterprise tools (export, AR, analytics) with inquiry flow

Quick Start

Prerequisites

  • Node.js 18+
  • A modern browser with WebGL support

Local development

git clone https://github.com/devamir99/3dglass_project.git
cd 3dglass_project
npm install
npm run dev

Open http://localhost:5173.

Production build

npm run build
npm run preview

GitHub Pages build (local test)

# PowerShell
$env:GITHUB_PAGES = "true"
npm run build:pages
npm run preview

Deploy

GitHub Pages (included workflow)

  1. Push to main or dev
  2. Enable GitHub Pages → Source: GitHub Actions
  3. The workflow in .github/workflows/deploy.yml publishes dist/

Live URL: https://devamir99.github.io/3dglass_project/

Vercel

npm run build

Deploy the dist/ folder. vercel.json is included for SPA routing.

Controls

Action Description
Mouse drag Rotate the 3D model
Scroll Zoom in/out
Configurator panel Presets, colors, view options
Locked tools Demo-only — opens contact modal

Project Structure

src/
├── config/          # product, contact, content, site, enterprise
├── three/           # Viewer, loaders, lighting, materials
├── ui/              # Configurator panel, landing, modal, toast
├── utils/           # storage, asset paths
├── main.js
├── index.html
└── style.css
static/
├── draco/
├── models/
├── robots.txt
├── sitemap.xml
├── favicon.svg
└── og-image.svg

Tech Stack

  • Three.js — 3D rendering, GLTF, DRACO, IBL
  • GSAP — UI and material transitions
  • Vite — dev server and production build

Custom Builds

Need a configurator for your product line?

Channel Link
Phone +98 920 500 7494
LinkedIn linkedin.com/in/devamir
Email devamir99@gmail.com
Website devamir.com
Telegram @devamir99

Content

LinkedIn post drafts and pitch notes: docs/content.md

License

MIT — see LICENSE.


Built by Amir Fallahi

About

An interactive 3D glasses viewer built with Three.js featuring customizable Ray-Ban models. Experience realistic 3D rendering with real-time color customization and smooth controls.

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
license.txt

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors