This document outlines the planned feature set and delivery phases for Minimal Block. Items are organized by phase, roughly in priority order. The roadmap is a living document — it will be updated as the project evolves.
Current status: Active development (pre-release 0.x)
- Core monorepo structure (Nx + pnpm workspaces)
- Domain layer with ports-adapters architecture (
libs/core) - Supabase auth, database, and storage integration
- React SPA with gallery, upload, and product detail pages
- Cloudflare Worker API with Gemini 3D generation
- Initial database schema (products, conversions)
- Row-Level Security on all tables
- Basic 3D model viewer (
<model-viewer>web component) - Bilingual documentation site (English + Turkish)
- Specialized category generators (furniture, clothing, electronics, jewelry, vehicle, packaging)
- Gemini image analyzer with quality assessment
- Material inference pipeline
- Geometry classification
- Product intelligence agent (market research)
- Multi-product cluster detection
- Return risk scoring
- Product import from URL (Trendyol, IKEA, Amazon, generic)
- Import pipeline with parallel processing stages
- Multi-source adapter pattern
- AI Diagnosis Panel (pre-flight quality check)
-
readinessScorevalue object with structured quality flags -
SourceImageReadinessCardUI component -
conversion_source_assetsdatabase table
- Hotspot data model and storage
-
HotspotEditorPanel3D position picker - AI-suggested hotspot positions
- Hotspot quality metrics reference
- Brand placement configuration
-
BrandPlacementPanelUI - Performance indexes (migration 016)
- Admin dashboard with analytics
- QR code sharing
- Public product embed page
- End-to-end test suite (Playwright)
- Error boundary coverage across all pages
- Retry logic for transient Gemini API failures
- Structured logging from the Worker (Cloudflare Logpush)
- Rate limiting on the
/convertendpoint - Webhook support for conversion status updates
- Full test coverage for
libs/ai(mock-based)
- Support for OpenAI GPT-4o as an alternative AI provider
- Provider selection UI (bring-your-own-key — BYOK)
- Abstract
ModelGeneratorPortimplementations for multiple providers - Cost estimation per generation before confirming
- Team workspaces (multiple users, shared products)
- Role-based access control (owner, editor, viewer)
- Product sharing via invite link
- Comment threads on conversions
- Official JavaScript embed SDK (
<script>tag) - Customizable viewer theme (colors, controls, background)
- Embed analytics (view counts, interaction events)
- iframe embed with configurable permissions
- WordPress and Shopify plugin stubs
- Direct publishing to Trendyol product listings
- Batch import and bulk generation
- Marketplace template matching (auto-resize GLB to platform constraints)
- Scheduled publishing queues
- Public REST API with API key authentication
- API rate limits and usage dashboard
- SDKs (TypeScript, Python)
- Webhook management UI
- OpenAPI 3.1 spec generation
These items are under consideration but not committed:
- Video-to-3D: Accept short product video clips as input instead of still photos
- AR try-on: WebXR integration for augmented reality product previews
- Batch processing: Queue-based generation for large product catalogues
- On-premises deployment: Docker Compose option for air-gapped or data-sensitive environments
- 3D model editing: In-browser mesh editing (vertex manipulation, UV unwrapping)
- Format export: Export to USDZ (Apple), OBJ, FBX in addition to GLB
- Open a feature request using the Feature Request issue template
- Start a discussion in GitHub Discussions
- Submit a pull request — PRs that implement planned items are prioritized in review
Items with significant community interest (upvotes, comments) are prioritized. Items that align with the core mission — making professional 3D product previews accessible to every merchant — are more likely to be scheduled.