🎨 3D Asset Manager

A modern, full-stack web application for uploading, managing, and previewing 3D assets directly in the browser. Built with cutting-edge technologies and designed for scalability and ease of use.

✨ Features

• 🔐 Secure Authentication - User registration and login system
• 📤 Asset Upload & Management - Support for GLTF/GLB 3D models with metadata
• 🖼️ Interactive 3D Preview - Real-time 3D model viewing with orbit controls
• ⚡ Real-Time Updates - Live synchronization across all connected clients
• 🏷️ Smart Organization - Tag-based categorization and search functionality
• 🌐 Cloud Deployment - Production-ready with automated CI/CD pipeline
• 📱 Responsive Design - Works seamlessly on desktop and mobile devices

🛠️ Tech Stack

🚀 Quick Start

Prerequisites

• Node.js 18+
• Git

1. Clone & Install

git clone https://github.com/MarkKatsDesign/3d-asset-manager.git
cd 3d-asset-manager

2. Backend Setup

cd backend
./pocketbase serve

Open http://localhost:8090/_/ and create your admin account.

3. Frontend Setup

cd frontend
npm install
cp .env.example .env
npm run dev

Visit http://localhost:5173 to see your application running!

📂 Project Structure

3d-asset-manager/
├── frontend/                 # Svelte application
│   ├── src/
│   │   ├── lib/
│   │   │   ├── pocketbase.js
│   │   │   └── components/
│   │   └── routes/
│   ├── static/
│   └── package.json
├── backend/                 # PocketBase backend
│   ├── pocketbase           # PocketBase binary
│   ├── pb_data/             # Database & file storage
│   ├── pb_migrations/       # Database schema
│   └── Dockerfile
└── .github/workflows/       # CI/CD automation

🌐 Deployment

This project is configured for one-click deployment:

• Frontend: Automatically deploys to Vercel on push to main
• Backend: Automatically deploys to Fly.io with persistent storage
• Database: Migrations run automatically on deployment

See SETUP.md for detailed deployment instructions.

🎯 Use Cases

• Design Teams - Share and review 3D assets across team members
• Game Development - Manage game assets and prototypes
• Architecture - Preview and organize architectural models
• Education - Create 3D model libraries for courses
• E-commerce - Product visualization and management

🤝 Contributing

We welcome contributions!

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📋 Roadmap

• Drag & drop upload interface
• Automatic thumbnail generation
• Blender plugin integration
• Advanced search and filtering
• Team collaboration features
• API rate limiting
• Asset compression optimization

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

Mark Kats

• GitHub: @MarkKatsDesign
• LinkedIn: linkedin.com/in/mark-kats

⭐ Show Your Support

Give a ⭐️ if this project helped you!

Built with ❤️ using modern web technologies