update docusaurus documentation with viewer editor, 3d bits apps, some clarity.

Author: matas-bitbybit-dev

docs/.gitignore

@@ -18,3 +18,5 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+
+wip

docs/learn/3d-bits/3d-assets/preparing-gltf.md

@@ -122,7 +122,7 @@ Khronos compressor tool also will show you the split screen view of original vs
 
 Once your file is ready, upload it to Shopify. Go to **Content → Files**, drag and drop your GLTF or GLB, and copy its URL if you want to use it in 3D Bits. Using Shopify’s CDN ensures your file is cached on servers close to your customers. If someone in Germany loads your product page, Shopify will serve the file from a nearby server, cutting down load times.
 
-Shopify has a 20 MB file size limit, but that’s rarely an issue with well-optimized assets. If your model is bigger than that, you can split it into multiple files - 3D Bits can load several at once. If you decide to use your own CDN instead, make sure the files are publicly accessible.
+If your model is bigger than what can be uploaded to Shopify, you can split it into multiple files - 3D Bits can load several at once. If you decide to use your own CDN instead, make sure the files are publicly accessible.
 
 # Reusing Parts with Instancing
 
@@ -137,6 +137,12 @@ GLTF files need to be valid to be properly loaded into any 3D software, 3D Bits
 ![BabylonJS Sandbox](https://ik.imagekit.io/bitbybit/app/assets/start/shopify/preparing-gltf-assets/babylonjs-sandbox.jpeg "BabylonJS Sandbox can be used to test loading your compressed 3D assets, inspect contents")
 *BabylonJS Sandbox can be used to test loading your compressed 3D assets, inspect contents.*
 
+:::caution Mobile Phone Considerations
+While well-prepared 3D GLTF files run fine on most mobile phones, it's important to take precautions. When preparing 3D models and including them in your webshops, make sure you test the page on the most popular mobile devices too. Large asset files combined with high-resolution shadows may crash mobile phone browsers. Safari browsers on iPhone are the most susceptible to crashes when Random Access Memory (RAM) limits are exceeded. Apple has set a low threshold for websites running on iPhone, and whenever that memory limit is hit, the website will experience something called an "unexpected reload". If you're not careful with your assets, skybox textures, or shadow resolutions, you run the risk of experiencing this error. Desktop browsers, iPads, and Android phones will probably not experience these issues, but we advise you to make the experience lightweight for everyone.
+
+If you're using BITBYBIT VIEWER with Viewer Editor, the 3D Bits app on Shopify also takes precautions on iOS Safari browsers. Whenever we detect that your models exceed a 70 MB limit, we stop the scene from rendering and provide an explanation of why this happens (this is subject to change in the future). This safeguard exists because loading extremely large assets (100+ MB) on high-traffic pages like homepages without proper testing can crash the browsing experience for iPhone users, potentially affecting sales and customer experience. To prevent such scenarios, we've implemented automatic size checks that disable rendering of oversized assets in iPhone Safari browsers until they're properly optimized.
+:::
+
 # Wrapping Up
 
 Preparing 3D assets for the web is a balancing act between fidelity, file size, and performance. You might start with a pristine engineering model, but to make it run smoothly in a browser, you’ll need to simplify geometry, optimize textures, merge meshes, and compress files.  

docs/learn/3d-bits/plans/subscription-plans.md

@@ -27,7 +27,9 @@ tags: [shopify, 3d-bits]
 
 ### BITBYBIT VIEWER (No-Code)
 
-The BITBYBIT VIEWER theme app extension allows you to build powerful, interactive 3D configurators without writing a single line of code. It includes an intuitive editor that lets you easily load 3D models, customize loading indicators, adjust scene settings, lighting, and camera angles, and link 3D models or materials directly to your Shopify product options. With the Basic Plan, you can parse GLTF file structures to connect different parts of your 3D model to Shopify variants. The system also detects material variants exported from Blender, allowing you to link them seamlessly to product options. The Standard Plan expands these capabilities by adding advanced features such as 3D points of interest - when you click on them camera will move in fluid cinematic motion to designated viewing position and angle. We also support multiple dimension types—including linear, angular, radial, diametral, and ordinal—automatic bounding box dimensions, and support for gradient and image backgrounds. Across all plans, you can use unlimited 3D models with full access to features like camera settings, directional lights, file size validation, GLTF and 3DGS scan formats, and customizable loading elements, making BITBYBIT VIEWER a complete no-code solution for 3D product visualization on Shopify.
+The BITBYBIT VIEWER theme app extension allows you to build powerful, interactive 3D configurators without writing a single line of code via powerful [Viewer Editor](../../getting-started//viewer-editor/intro.md) application. 
+
+It includes an intuitive editor that lets you easily load 3D models, customize loading indicators, adjust scene settings, lighting, and camera angles, and link 3D models or materials directly to your Shopify product options. With the Basic Plan, you can parse GLTF file structures to connect different parts of your 3D model to Shopify variants. The system also detects material variants exported from Blender, allowing you to link them seamlessly to product options. The Standard Plan expands these capabilities by adding advanced features such as 3D points of interest - when you click on them camera will move in fluid cinematic motion to designated viewing position and angle. We also support multiple dimension types—including linear, angular, radial, diametral, and ordinal—automatic bounding box dimensions, and support for gradient and image backgrounds. Across all plans, you can use unlimited 3D models with full access to features like camera settings, directional lights, file size validation, GLTF and 3DGS scan formats, and customizable loading elements, making BITBYBIT VIEWER a complete no-code solution for 3D product visualization on Shopify.
 
 | Feature | Base | Standard | Pro |
 |---------|-------------|------------|------------|

docs/learn/3d-bits/tutorials/getting-started/apps-for-3d-bits.md

@@ -0,0 +1,94 @@
+---
+sidebar_position: 5
+---
+
+# Third-Party Apps for 3D Bits
+
+## When Do You Need These Apps?
+
+The default Shopify variant system works well for simple product configurations. However, when you need to build **complex product configurators** that go beyond Shopify's built-in capabilities, you may need to integrate third-party product options apps with 3D Bits.
+
+These apps are only necessary when:
+- Your product has extensive customization options
+- The default Shopify variant system cannot address your configuration needs
+- You require advanced conditional logic or dynamic pricing
+- You need more sophisticated option management
+
+## Important Disclaimers
+
+:::warning Integration Requirements
+**We are not affiliated with the developers of any apps listed below.** Each integration requires thorough testing to ensure compatibility with 3D Bits and your specific use case.
+:::
+
+:::danger No Guarantees
+- **Personal Choice**: The selection of a product options app is highly personal to each business and depends on your specific requirements
+- **Stability**: We cannot guarantee that these apps will remain stable or that updates won't affect integration
+- **Compatibility**: Not all features of these apps may be compatible with 3D Bits
+- **Support**: These are not our partners; we provide this list solely for the convenience of our users
+- **Integration Effort**: Each app may require different levels of integration work and testing
+:::
+
+## Potentially Compatible Third-Party Apps
+
+The following apps have been identified as potentially compatible with 3D Bits. This list is provided for reference only and organized by user review count (approximate ranges as of late 2025).
+
+### Highly Reviewed Apps (1,500+ reviews)
+
+| App Name | Key Features | Shopify Link |
+|----------|-------------|--------------|
+| **Infinite Product Options** <br/>~2,100+ reviews | • 9+ years of development history<br/>• Conditional logic & addon bundles<br/>• USA-based support team<br/>• Compatible with checkout extensions | [View App](https://apps.shopify.com/custom-options) |
+| **Easify Custom Product Options** <br/>~1,850+ reviews | • 27+ option types with live preview<br/>• File upload & product personalizer<br/>• Multi-language support (13 languages)<br/>• Price add-ons & conditional logic | [View App](https://apps.shopify.com/easify-product-options) |
+| **OPTIS Product Options, Variant** <br/>~1,700+ reviews | • 18+ option types with swatches<br/>• Cart page option editing<br/>• Import/export functionality<br/>• Seamless theme integration | [View App](https://apps.shopify.com/product-options-by-bss) |
+| **Avis Product Options, Variants** <br/>~1,480+ reviews | • 30+ option types with live preview<br/>• Product personalizer feature<br/>• 24/7 live support & call support<br/>• Multi-language (10 languages) | [View App](https://apps.shopify.com/avisplus-product-options) |
+
+### Mid-Range Apps (750-1,500 reviews)
+
+| App Name | Key Features | Shopify Link |
+|----------|-------------|--------------|
+| **Hulk Product Options** <br/>~1,100+ reviews | • 20+ option types<br/>• Conditional logic & file uploads<br/>• Bulk operations for options<br/>• Multi-language (20 languages) | [View App](https://apps.shopify.com/product-options-by-hulkapps-1) |
+| **Zepto Product Personalizer** <br/>~1,000+ reviews | • Visual product customization<br/>• Live preview with real-time updates<br/>• Custom fonts & colors<br/>• High-resolution export | [View App](https://apps.shopify.com/product-personalizer) |
+| **Tepo Custom Product Options** <br/>~770+ reviews | • 30+ option types<br/>• CSV import/export<br/>• Shopify POS integration<br/>• Volume discounts support | [View App](https://apps.shopify.com/tepo-product-options) |
+
+### Specialized Apps (250-750 reviews)
+
+| App Name | Key Features | Shopify Link |
+|----------|-------------|--------------|
+| **YMQ Options** <br/>~460+ reviews | • Price formula builder<br/>• Volume discounts<br/>• Advanced conditional logic<br/>• Multi-currency support | [View App](https://apps.shopify.com/ymq-options) |
+| **APO Product Options, Variants** <br/>~420+ reviews | • 22+ option types<br/>• Multi-step display mode<br/>• Formula-based pricing<br/>• Bulk editing capabilities | [View App](https://apps.shopify.com/advanced-product-options) |
+| **DPO Dynamic Product Options** <br/>~290+ reviews | • Advanced price calculators<br/>• Mathematical formula support<br/>• Bundle products with SKUs<br/>• CSV spreadsheet price lookup | [View App](https://apps.shopify.com/dynamic-product-options) |
+| **LPO Live Product Options** <br/>~260+ reviews | • Live preview on product images<br/>• High-resolution file export<br/>• Formula-based pricing<br/>• Multi-currency compatible | [View App](https://apps.shopify.com/live-product-options) |
+
+## Evaluation Checklist
+
+:::tip Take Advantage of Trial Periods
+Most of these apps offer 7-14 day free trials. **We strongly recommend using these trial periods in combination with the 3D Bits trial period** to test different solutions and find the best fit for your specific needs. Dedicate time to research and experiment with multiple options before committing to a solution. Your team should allocate sufficient time to properly evaluate how each app integrates with 3D Bits and meets your business requirements.
+:::
+
+When evaluating these apps for your 3D Bits integration, consider:
+
+1. **Feature Set**: Does the app provide the customization options you need?
+3. **Pricing Structure**: Does the pricing model fit your business?
+4. **Support Quality**: Review the app's support options and response times
+5. **Update Frequency**: Check how actively the app is maintained
+6. **User Reviews**: Read recent reviews for insights on stability and support
+7. **Trial Period**: Test the app thoroughly during the trial before committing to a paid plan
+
+## Integration Process
+
+Ensure you understand how 3D Bits app works and integrates with HTML form inputs:   
+[**Under the hood**](./under-the-hood.md)
+
+To integrate a product options app with 3D Bits:
+
+1. Install and configure your chosen app
+2. Set up your product options within the app
+3. Enable 3D Bits theme app extension blocks on that same product page
+4. [**Enable Debug mode**](./common-settings#enable-debug-mode) to see if technical input names and their current values are collected and update correctly when you change variants.
+3. Test how the app exposes option data
+4. Configure 3D Bits to read and respond to the selected options
+5. Thoroughly test all combinations and edge cases
+6. Monitor the integration after going live
+
+## Need Help?
+
+If you have questions about integrating 3D Bits with product options apps, please consult the 3D Bits documentation or contact our support team. Note that we cannot provide support for third-party apps themselves.

docs/learn/3d-bits/tutorials/getting-started/under-the-hood.md

@@ -12,11 +12,11 @@ Before diving into building 3D configurators with 3D Bits, it's essential to und
 
 ## Our Design Philosophy: Focus on What We Do Best
 
-The power of 3D Bits comes from its adaptive nature and focused approach. We're proud to offer a solution that **does not try to copy or duplicate features already developed by Shopify** or hundreds of third-party option and variant applications. These apps have solved the problems of custom UI forms and price management better than we ever could have.
+The power of 3D Bits comes from its adaptive nature and focused approach. We're proud to offer a solution that **does not try to copy or duplicate features already developed by Shopify** or hundreds of third-party option and variant applications. These apps have solved the problems of custom UI forms and price management better than the majority of all-in-one solutions. The diverse nature of these apps means that merchants can pick the tools that work best for their business workflows.
 
 **Why this approach?**
 
-Managing pricing and checkout flows is a responsible, complex task that must be handled with care. Every business has unique requirements for how they price products, calculate discounts, handle bundles, and process checkout flows. Rather than building a one-size-fits-all solution that might suit some customers but disappoint others, we focus exclusively on our core expertise: **3D web programming, interactive visualization, CAD operations, and parametric design**.
+Managing pricing and checkout flows is a responsible, complex task that must be handled with care and security in mind. Every business has unique requirements for how they price products, calculate discounts, handle bundles, and process checkout flows. Rather than building a one-size-fits-all solution that might suit some customers but disappoint others, we ask our customers to choose the best 3rd party solution for their business. This allows us to focus exclusively on our core expertise: **3D web programming, interactive visualization, CAD operations, and parametric design**.
 
 ### What 3D Bits Is (and Isn't)
 
@@ -35,7 +35,7 @@ Managing pricing and checkout flows is a responsible, complex task that must be
 - ❌ Plug-and-play solutions requiring zero configuration
 
 :::info Clear Expectations
-If you're looking for an app that handles 3D visualization, pricing, variants, checkout, and everything else in a single package, **3D Bits will not be a good fit for you**. We're deliberately focused on excelling at 3D, CAD, and parametric visualization rather than being mediocre at everything.
+If you're looking for an app that handles 3D visualization, pricing, variants, checkout, and everything else in a single package, **3D Bits will not be a good fit for you**. We're deliberately focused on excelling at 3D, CAD, and parametric visualization.
 :::
 
 ### Simple Use Cases Are Welcome Too

docs/learn/getting-started/viewer-editor/basics/_category_.json

@@ -0,0 +1,10 @@
+{
+    "label": "Basics",
+    "position": 1,
+    "link": {
+        "type": "generated-index",
+        "title": "Viewer Editor Basics",
+        "description": "Learn the fundamentals of using the Viewer Editor interface, from accessing the tool to understanding its core components.",
+        "slug": "/getting-started/viewer-editor/basics"
+    }
+}