# WidgetExamples Studio — Full Developer & Architectural Specification

> Author: Chirag Shyani (Founder & Principal Engineer)
> Repository: https://github.com/chirag-12-mmax/widgetexamples_studio
> Website: https://www.widgetexamples.com
> Contact: chirag@widgetexamples.com
> License: Permissive Open-Source & Developer License

WidgetExamples Studio is an independent, client-side Flutter engineering suite and local AI deployment platform. All diagnostics, code generators, and hardware matrices run 100% locally in browser memory with zero tracking or cloud telemetry.

---

## 1. Flutter Fix Lab Reference Manual

### Fix FX01: A RenderFlex overflowed by X pixels
- **Cause**: Child widgets inside a `Row` or `Column` exceed available parent cross-axis or main-axis constraints.
- **Solution**:
  1. Wrap flexible text or dynamic elements in `Expanded` or `Flexible` with `fit: FlexFit.loose`.
  2. For scrolling content, wrap children in `SingleChildScrollView(scrollDirection: Axis.horizontal)`.
  3. For multi-line tags or chips, replace `Row` with `Wrap(spacing: 8.0, runSpacing: 4.0, children: [...])`.

### Fix FX02: Vertical viewport was given unbounded height
- **Cause**: A scrollable `ListView` or `GridView` placed inside an unconstrained `Column` attempts to occupy infinite height.
- **Solution**:
  1. Primary fix: Wrap `ListView` inside `Expanded(child: ListView.builder(...))`.
  2. Embedded scroll view: Specify `shrinkWrap: true` and `physics: const NeverScrollableScrollPhysics()`.

### Fix FX03: Incorrect use of ParentDataWidget
- **Cause**: An `Expanded` or `Positioned` widget placed inside a widget that does not supply the matching `RenderObject` (e.g. `Expanded` outside a `Row`/`Column`, or `Positioned` outside a `Stack`).
- **Solution**:
  1. Move `Expanded` directly under `Row`, `Column`, or `Flex`.
  2. Remove `Positioned` if wrapping widgets inside non-Stack parents; use `Align` or `Padding` instead.

### Fix FX04: setState() called after dispose()
- **Cause**: An asynchronous `Future`, `StreamSubscription`, or `Timer` finishes and calls `setState()` after the `StatefulWidget` has been unmounted.
- **Solution**:
  1. Guard with `if (!mounted) return;` before calling `setState(...)`.
  2. Always cancel `Timer` and `StreamSubscription` instances in `dispose()`.

### Fix FX05: AnimatedSwitcher not animating / skipping transitions
- **Cause**: Flutter widget identity failure. `AnimatedSwitcher` compares widget types and keys to detect transitions. If the child type remains unchanged and no `Key` is provided, no transition is triggered.
- **Solution**:
  1. Provide a unique `ValueKey(stateVariable)` to the switching child widget.

---

## 2. Local AI Preflight Hardware Matrix

| Hardware Tier | CPU Specs | System RAM | GPU VRAM | Target Quantized Models | Expected Tokens/Sec |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Tier 1: Minimal** | 4 Cores | 8 GB | Integrated | DeepSeek Coder 1.3B, Qwen2.5 1.5B | 15–25 t/s |
| **Tier 2: Balanced** | 6–8 Cores | 16 GB | 6–8 GB VRAM | Llama 3.1 8B (Q4_K_M), Mistral 7B | 30–45 t/s |
| **Tier 3: Power** | 8+ Cores | 32 GB | 12–16 GB VRAM | DeepSeek R1 14B, Qwen2.5 14B (Q5_K_M) | 25–40 t/s |
| **Tier 4: Enterprise** | 12+ Cores | 64 GB | 24 GB+ VRAM | DeepSeek R1 32B, Llama 3.3 70B (Q4_K_M) | 20–35 t/s |

---

## 3. 19 Mobile App Figma eCommerce Design Showcases

The collection includes 19 production-ready mobile eCommerce design systems, each with complete design tokens (ARGB colors, typography scales, elevation shadows), responsive HTML mobile prototypes, and downloadable source ZIP archives:

1. **VOGUEVA** (`/blog/vogueva-luxury-fashion-mobile-app`): High-end couture fashion and atelier runway shopping experience.
2. **ThreadPop** (`/blog/threadpop-creator-streetwear-mobile-app`): Creator-driven streetwear apparel marketplace.
3. **CHRONOS** (`/blog/chronos-luxury-timepieces-mobile-app`): Haute horlogerie luxury timepiece curation.
4. **Nectar & Root** (`/blog/nectar-and-root-clean-botanical-skincare-mobile-app`): Clean botanical skincare and cosmetic formulation.
5. **KILN & CO** (`/blog/kiln-and-co-artisan-ceramics-mobile-app`): Handcrafted studio pottery and ceramics atelier.
6. **Bean & Roast** (`/blog/bean-and-roast-specialty-coffee-mobile-app`): Single-origin specialty coffee roasters and subscription.
7. **LUMEN** (`/blog/lumen-minimalist-lighting-mobile-app`): Architectural illumination and minimalist lighting systems.
8. **FORGE** (`/blog/forge-b2b-industrial-hardware-procurement-mobile-app`): Enterprise B2B wholesale industrial hardware procurement.
9. **VELO** (`/blog/velo-performance-cycling-gear-mobile-app`): Professional cycling equipment, gravel bikes, and telemetry gear.
10. **AURA** (`/blog/aura-modern-fragrance-house-mobile-app`): Bespoke fragrance discovery, scent notes, and olfactive architecture.
11. **GILDED** (`/blog/gilded-fine-jewelry-atelier-mobile-app`): Fine jewelry, certified ethical gemstones, and custom rings.
12. **HARVEST** (`/blog/harvest-farm-to-table-artisanal-pantry-mobile-app`): Hyperlocal organic farm-to-table artisanal grocery delivery.
13. **ATLAS** (`/blog/atlas-modular-travel-gear-mobile-app`): Technical modular travel bags, luggage, and outdoor utility.
14. **HEARTH** (`/blog/hearth-slow-living-home-goods-mobile-app`): Sustainable Scandinavian slow-living interior decor.
15. **NOMAD** (`/blog/nomad-remote-work-audio-gear-mobile-app`): Acoustic noise-cancelling equipment and mobile office tech.
16. **TERRA** (`/blog/terra-rare-botanicals-nursery-mobile-app`): Rare exotic houseplants, terrariums, and botanical supplies.
17. **CRAFT** (`/blog/craft-small-batch-spirits-cellar-mobile-app`): Micro-distillery craft spirits, single-malt whiskey, and cellar reservations.
18. **PULSE** (`/blog/pulse-connected-fitness-apparel-mobile-app`): Biometric smart apparel and connected athlete sportswear.
19. **STEEL & OAK** (`/blog/steel-and-oak-bespoke-furniture-mobile-app`): Bespoke architectural woodworking, timber tables, and steel furniture.

---

## 4. Complete Sitemap & Routing

- Homepage & 60fps Living Canvas: https://www.widgetexamples.com/
- Developer Setup Hub: https://www.widgetexamples.com/setup-hub
- Local AI Setup Lab: https://www.widgetexamples.com/ai-setup-lab
- 353 Developer Tools Catalog: https://www.widgetexamples.com/developer-tools
- 19 Mobile App Figma Designs: https://www.widgetexamples.com/mobile-app-figma-designs
- Flutter Fix Lab: https://www.widgetexamples.com/fixes
- Motion Studio Animations: https://www.widgetexamples.com/animations
- 120 Developer Guides: https://www.widgetexamples.com/blog
- Full Sitemap Directory: https://www.widgetexamples.com/sitemap
- RSS Feed: https://www.widgetexamples.com/blog/rss.xml
- LLM Discovery Index: https://www.widgetexamples.com/llms.txt