A Flutter reference application for Clean Architecture, flutter_bloc, offline-first data flows, and integration-heavy product demos.

This repository is an engineering reference app rather than a single-purpose demo. It combines shared app infrastructure, offline-first patterns, backend integrations, AI/chat transports, and multiple product-style feature surfaces so architecture, validation, and delivery workflows can be exercised under realistic scope.

• Full docs index: docs/README.md
• Local setup and first run: docs/new_developer_guide.md
• Feature and route catalog: docs/feature_overview.md
• Validation and test lanes: docs/testing_overview.md, docs/validation_scripts.md
• Architecture and repo shape: docs/clean_architecture.md, docs/architecture_details.md
• Security and secret injection: docs/security_and_secrets.md, docs/SECURITY.md
• Deployment and release: docs/deployment.md

• AI chat overview: docs/ai_integration.md
• FastAPI Cloud chat orchestration: docs/integrations/render_fastapi_chat_demo.md
• Staff app demo walkthrough: docs/staff_app_demo_walkthrough.md
• Case-study briefs and demo context: docs/case_studies/README.md

• Toolchain: Flutter 3.41.7, Dart 3.11.5
• Entry points: lib/main_dev.dart, lib/main_staging.dart, lib/main_prod.dart
• Architecture shape: Presentation -> Domain <- Data
• Core infra: flutter_bloc, get_it, GoRouter, offline-first sync under lib/shared/sync/
• Validation entrypoints: ./tool/delivery_checklist.sh, ./bin/router_feature_validate, ./bin/integration_tests, ./bin/upgrade_validate_all

Use docs/README.md as the source-of-truth navigation page for everything else.

Counter	Countdown	Settings

Profile	Profile 2	IoT demo

IoT demo 2	Todo list	Swipe actions

Search	Charts	GraphQL

AI chat	Apple Maps	Google Maps

GenUI	Calculator	Summary

Register	In-app purchase	Whiteboard colors

Whiteboard	Markdown	Camera & gallery

Example	Library demo	Library demo 2

Learn	Chat list	iGaming

Scapes