Initial commit: Grounded Flutter frontend

A to-do app that doesn't believe you — an enforcement layer rather than a
neutral ledger.

Architecture ported from Autoreceptives/Frontend/Receptive: stacked MVVM with
the mandatory 4-file screen pattern, one ParentViewModel owning the loading /
network / error overlays and the handleError decision tree, one AppDataManager
gateway, dio comms carrying the three identity headers, secure storage with
random-suffixed keys, and a single-chokepoint Navigator. Package root and Dart
package name are both Grounded; org is nya.

The enforcement engine, one unit per formula in utils/:

- DebtEngine      w(class) x severity(d) x decay(t), sublinear severity so old
                  misses cannot swamp the score; abandonment 2x with 30-day
                  decay immunity; late complete retains 30%
- StandingEngine  Good -> Warned -> Grounded -> Lockdown, derived not set;
                  Grounded replaces home with the overdue queue
- CapacityEngine  blocks over-scheduling against p50 of historically completed
                  minutes, with a learned per-category estimation multiplier
- IntegrityEngine session integrity, weekly volume, plyometric contact ceiling
                  and enforced recovery gaps
- ExcuseAnalyser  on-device excuse clustering plus the confrontation copy
- GuardrailEngine distress detection and rationed amnesty
- ToneEngine      all enforcement copy, so the tone cap lives in one place

CommitmentEvent is append-only and is the source of truth rather than the
status field, which is what makes honest history and excuse analysis possible.

Goals contain commitments via parentId, and a task can be run from a
full-screen runner that derives elapsed time from wall-clock so screen-off
cannot lose time. Backgrounding pauses the clock and is counted. The runner is
mirrored into an ongoing notification, with alarm-class full-screen intents
reserved for non-negotiables.

Design language, fonts, icon and native splash are in place; Mason bricks are
retargeted to this project and verified end-to-end.

flutter analyze lib/ reports no errors.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Mfu2gQLSFN21YRBcU2NrTt

frontend/bricks/api_endpoint/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.1.0+1
+
+- TODO: Describe initial release.

frontend/bricks/api_endpoint/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

frontend/bricks/api_endpoint/README.md

@@ -0,0 +1,83 @@
+## 📄 README.md
+
+### 🚀 API Endpoint Mason Brick
+A smart, synchronized generator that appends API logic across `Comms`, `ConnectComms`, and `AppDataManager` while handling auto-imports and optional formatting.
+
+### 🛠 1. First-Time Setup
+Run these commands to ensure Mason and the Dart hooks are ready to go:
+
+```bash
+# 1. Install Mason CLI (if you haven't)
+dart pub global activate mason_cli
+
+# 2. Initialize Mason in project root
+mason init
+
+# 3. Install Hook dependencies
+cd bricks/api_endpoint/hooks
+dart pub get
+cd ../../../
+
+# 4. Register the brick
+mason get
+```
+
+### 🔃 2. How to Refresh (When logic or prompts change)
+If you update the `brick.yaml` or the `post_gen.dart` hook, Mason might use a cached version. Use this "Hard Refresh" command:
+
+```bash
+rm -rf .mason && mason get
+```
+
+### 🏃 3. Running the Generator
+To add a new endpoint, simply run:
+```bash
+mason make api_endpoint
+```
+
+**Interaction Flow:**
+1. **Endpoint Path:** e.g., `orders/confirm`
+2. **Function Name:** e.g., `confirmOrder`
+3. **Method:** Choose `get` or `post`.
+4. **Request Body:** * **Mandatory for POST**: e.g., `OrderDetails`.
+    * **Optional for GET**: Leave empty or provide a type like `String`.
+5. **Auto-Import**: The brick scans `lib/` for your Body type and adds the `import` statement automatically.
+6. **Format**: Choose `y` to run `dart format` on all 4 modified files.
+
+---
+
+## 🐚 setup_brick.sh
+Create this file in your project root to allow one-click setup or refreshing for your team.
+
+```bash
+#!/bin/bash
+
+# setup_brick.sh
+echo "🧹 Cleaning old Mason cache..."
+rm -rf .mason
+
+echo "📦 Fetching Hook dependencies..."
+if [ -d "bricks/api_endpoint/hooks" ]; then
+    cd bricks/api_endpoint/hooks
+    dart pub get
+    cd ../../../
+else
+    echo "❌ Error: bricks/api_endpoint/hooks directory not found!"
+    exit 1
+fi
+
+echo "🧱 Registering Mason Brick..."
+mason get
+
+echo "✅ Setup Complete! Run 'mason make api_endpoint' to start."
+```
+
+### To use the script:
+1. Create the file: `touch setup_brick.sh`
+2. Give it permission: `chmod +x setup_brick.sh`
+3. Run it: `./setup_brick.sh`
+
+---
+
+### 💡 Pro-Tip: Project Name Detection
+In your `post_gen.dart` hook, ensure you have updated the `package:your_project_name` string to match your real project name from `pubspec.yaml`, otherwise the auto-imports will show a red error in VS Code.

frontend/bricks/api_endpoint/brick.yaml

@@ -0,0 +1,25 @@
+name: api_endpoint
+description: Generates Comms and AppDataManager logic for a new endpoint.
+
+version: 0.1.0+1
+
+environment:
+  mason: ^0.1.1
+
+
+vars:
+  path_url:
+    type: string
+    prompt: "🌐 What is the API path? (e.g., auth/login)"
+  function_name:
+    type: string
+    prompt: "🖋️ What is the function name? (e.g., signIn)"
+  request_type:
+    type: string
+    default: get
+    prompt: "🔃 Is this a 'get' or a 'post'?"
+  request_body:
+    type: string
+    default: ""
+    prompt: "📦 Request Body type? (Mandatory for POST, Optional for GET)"
+

frontend/bricks/api_endpoint/hooks/post_gen.dart

@@ -0,0 +1,146 @@
+import 'dart:io';
+import 'package:mason/mason.dart';
+import 'package:yaml/yaml.dart';
+
+void run(HookContext context) async {
+  final logger = context.logger;
+
+  final String pathUrl = context.vars['path_url'] ?? '';
+  final String functionName = context.vars['function_name'] ?? '';
+  final String requestType = (context.vars['request_type'] as String).toLowerCase();
+  final String requestBody = context.vars['request_body'] as String;
+
+  if (requestType == 'post' && requestBody.isEmpty) {
+    logger.err('❌ Error: POST requests require a Request Body type.');
+    return;
+  }
+
+  final cName = functionName.camelCase;
+  final bool hasData = requestBody.isNotEmpty;
+  final String paramType = hasData ? requestBody : 'dynamic';
+
+  // Auto-Detect Project Name
+  String projectName = 'your_project';
+  final pubspecFile = File('pubspec.yaml');
+  if (pubspecFile.existsSync()) {
+    final doc = loadYaml(pubspecFile.readAsStringSync());
+    projectName = doc['name'] ?? projectName;
+  }
+
+  final progress = logger.progress('🚀 Injecting logic...');
+
+  final filesToUpdate = [
+    'lib/Grounded/comms/CommsDirections.dart',
+    'lib/Grounded/comms/Comms.dart',
+    'lib/Grounded/comms/ConnectComms.dart',
+    'lib/Grounded/informatics/AppDataManager.dart'
+  ];
+
+  // Find Import Path and Filename
+  String? importLine;
+  String? importFileName;
+  if (hasData && !['String','int','double','bool'].contains(requestBody)) {
+    final result = await _findClassData(requestBody, projectName);
+    importLine = result?['line'];
+    importFileName = result?['fileName'];
+  }
+
+  final String sharedParams = hasData ? '$paramType request' : '';
+  final String callParams = hasData ? 'request' : '';
+
+  // 1. CommsDirections
+  await _inject(filesToUpdate[0], "String ${cName}Path = '$pathUrl';", logger,
+      isClass: false, duplicateCheck: "${cName}Path");
+
+  // 2. comms.dart
+  final String dioData = requestType == 'post' ? 'data: request' : 'options: Options(headers: dio.options.headers)';
+  final String commsMethod = '''
+  @override
+  Future<Response> $cName($sharedParams) async {
+    Pair navigation = await getRequestHeaders(${cName}Path, "");
+    dio.options.headers = navigation.value;
+    return await dio.$requestType(
+      navigation.key, 
+      $dioData
+    );
+  }''';
+  await _inject(filesToUpdate[1], commsMethod, logger,
+      importLine: importLine, importFileName: importFileName, duplicateCheck: "Future<Response> $cName");
+
+  // 3. ConnectComms.dart
+  await _inject(filesToUpdate[2], "  Future<Response> $cName($sharedParams);", logger,
+      importLine: importLine, importFileName: importFileName, duplicateCheck: "Future<Response> $cName");
+
+  // 4. AppDataManager.dart
+  final String dataManagerMethod = '''
+  @override
+  Future<Response> $cName($sharedParams) async {
+    return await connectComms.$cName($callParams);
+  }''';
+  await _inject(filesToUpdate[3], dataManagerMethod, logger,
+      importLine: importLine, importFileName: importFileName, duplicateCheck: "Future<Response> $cName");
+
+  progress.complete('✨ Injection & Deduplication complete.');
+
+  final shouldFormat = logger.confirm('🎨 Run "dart format" on updated files?', defaultValue: false);
+  if (shouldFormat) {
+    for (final path in filesToUpdate) {
+      await Process.run('dart', ['format', path]);
+    }
+    logger.success('✅ Files formatted.');
+  }
+}
+
+/// Returns both the full import line and just the filename (e.g. user_request.dart)
+Future<Map<String, String>?> _findClassData(String className, String projectName) async {
+  final directory = Directory('lib');
+  if (!directory.existsSync()) return null;
+  final List<FileSystemEntity> files = directory.listSync(recursive: true);
+  for (var file in files) {
+    if (file is File && file.path.endsWith('.dart')) {
+      final content = await file.readAsString();
+      if (content.contains('class $className') || content.contains('enum $className')) {
+        final fileName = file.path.split('/').last;
+        final packagePath = file.path.replaceFirst('lib/Grounded/', '');
+        return {
+          'line': "import 'package:$projectName/$packagePath';",
+          'fileName': fileName,
+        };
+      }
+    }
+  }
+  return null;
+}
+
+Future<void> _inject(String path, String content, Logger logger,
+    {bool isClass = true, String? importLine, String? importFileName, String? duplicateCheck}) async {
+  final file = File(path);
+  if (!await file.exists()) return;
+  String fileContent = await file.readAsString();
+
+  // 1. Prevent Duplicate Method/Variable
+  if (duplicateCheck != null && fileContent.contains(duplicateCheck)) {
+    return; // Silently skip methods that exist
+  }
+
+  // 2. Smart Import Check: Look for the filename inside any import statement
+  if (importLine != null && importFileName != null) {
+    // Regex matches: import 'any/path/filename.dart'; or "any/path/filename.dart";
+    final importRegex = RegExp("import ['\"].*?$importFileName['\"];");
+    if (!importRegex.hasMatch(fileContent)) {
+      fileContent = "$importLine\n$fileContent";
+    }
+  }
+
+  if (isClass) {
+    final lastBrace = fileContent.lastIndexOf('}');
+    if (lastBrace != -1) {
+      fileContent = fileContent.substring(0, lastBrace).trimRight() + '\n\n$content\n' + fileContent.substring(lastBrace);
+    } else {
+      fileContent += '\n\n$content';
+    }
+  } else {
+    fileContent = fileContent.trimRight() + '\n\n$content\n';
+  }
+  await file.writeAsString(fileContent);
+}

frontend/bricks/api_endpoint/hooks/pubspec.yaml

@@ -0,0 +1,10 @@
+name: api_endpoint_hooks
+description: Hooks for the api_endpoint brick.
+publish_to: none
+
+environment:
+  sdk: ">=2.12.0 <4.0.0"
+
+dependencies:
+  mason: ^0.1.0-dev.51 # Or the latest version
+  yaml: ^3.1.2

frontend/bricks/api_endpoint/setup_brick.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+
+# setup_brick.sh
+echo "🧹 Cleaning old Mason cache (Hard Refresh)..."
+rm -rf .mason
+
+echo "📦 Fetching Hook dependencies (Yaml/Mason)..."
+if [ -d "bricks/api_endpoint/hooks" ]; then
+    cd bricks/api_endpoint/hooks
+    dart pub get
+    cd ../../../
+else
+    echo "❌ Error: Hooks directory not found!"
+    exit 1
+fi
+
+echo "🧱 Getting latest Brick definition..."
+mason get
+
+echo "✅ Ready! Run 'mason make api_endpoint'"

frontend/bricks/internal_memory/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.1.0+1
+
+- TODO: Describe initial release.

frontend/bricks/internal_memory/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

frontend/bricks/internal_memory/README.md

@@ -0,0 +1,92 @@
+
+
+# 🔐 Internal Memory Brick
+
+An advanced **Mason** brick designed for the **Autoreceptive** architecture. It automates the boilerplate for persistent local storage using `flutter_secure_storage` (via `autoreceptiveStorage`), handling JSON serialization for Objects and Lists, and raw storage for Strings.
+
+## 🚀 Purpose
+This brick eliminates the manual task of:
+1.  Generating high-entropy, randomized secure keys.
+2.  Writing `get` and `set` interfaces in `ConnectInternalMemory`.
+3.  Implementing JSON encoding/decoding logic in `InternalMemory`.
+4.  Wrapping calls in `AppDataManager` to maintain the **Repository Pattern**.
+
+---
+
+## 📂 Target Architecture
+The brick targets the following specific paths in your project:
+* **Interface**: `lib/Autoreceptive/memory/ConnectInternalMemory.dart`
+* **Implementation**: `lib/Autoreceptive/memory/InternalMemory.dart`
+* **Global Access**: `lib/Autoreceptive/informatics/AppDataManager.dart`
+
+---
+
+## 🛠 Installation
+
+### 1. Register the Brick
+From your project root, run:
+```bash
+mason add internal_memory --path ./bricks/internal_memory
+```
+
+### 2. Setup Hooks
+The brick uses specialized Dart hooks for smart code injection and auto-formatting.
+```bash
+cd bricks/internal_memory/hooks && dart pub get && cd ../../../
+mason get
+```
+
+---
+
+## 📖 Usage Guide
+
+Run the following command and follow the interactive prompts:
+```bash
+mason make internal_memory
+```
+
+### Variable Inputs:
+| Variable | Description | Example |
+| :--- | :--- | :--- |
+| `function_name` | The camelCase name of the feature. | `userProfile` or `orderLocations` |
+| `request_object` | The Dart type to store. | `MeDescription`, `String`, or `List<Location>` |
+
+---
+
+## 📋 Logic Breakdown
+
+### 1. High-Entropy Keys
+The brick generates a randomized `static const String` key at the **top** of the `InternalMemory` class to prevent key collisions and reverse-engineering:
+```dart
+static const String USER_PROFILE = "USER_PROFILE_x8H2_9kLp_mQz1";
+```
+
+### 2. Intelligent Type Handling
+The hook detects the `request_object` type and adjusts the logic:
+
+* **Standard Objects**: Uses `Type.fromJson(jsonDecode(s))` and `jsonEncode(data.toJson())`.
+* **Lists**: Uses `.map((item) => Type.fromJson(item)).toList()` for deep serialization.
+* **Strings**: Bypasses JSON logic for raw string storage.
+
+### 3. Smart Injection & Spacing
+* **Clean Pairs**: In the interface, the getter and setter are injected as a tight block with a double-newline buffer from the previous feature.
+* **Auto-Imports**: Automatically adds `import 'dart:convert';` and searches the `lib/` folder to find and add the correct model imports for your Objects.
+* **Formatting**: Automatically triggers `dart format` on the `Autoreceptive` folder after injection.
+
+---
+
+## ⚠️ Requirements
+* **`autoreceptiveStorage`**: The `InternalMemory` class must have an instance of your secure storage wrapper named `autoreceptiveStorage`.
+* **Model Factories**: For Objects and Lists, your models must implement:
+    * `factory Model.fromJson(Map<String, dynamic> json)`
+    * `Map<String, dynamic> toJson()`
+
+---
+
+## 🔄 Refreshing Logic
+If you update the `post_gen.dart` hook code, always run this to ensure Mason uses the latest version:
+```bash
+rm -rf .mason && mason get
+```
+
+---

frontend/bricks/internal_memory/brick.yaml

@@ -0,0 +1,11 @@
+name: internal_memory
+description: Generates Secure Storage logic with JSON serialization and AppDataManager sync.
+version: 0.1.0+1
+
+vars:
+  function_name:
+    type: string
+    prompt: "🖋️ What is the function name? (e.g., myDescription)"
+  request_object:
+    type: string
+    prompt: "📦 What is the Object type to store? (e.g., MeDescription)"

frontend/bricks/internal_memory/hooks/post_gen.dart

@@ -0,0 +1,186 @@
+import 'dart:io';
+import 'dart:convert';
+import 'dart:math';
+import 'package:mason/mason.dart';
+import 'package:yaml/yaml.dart';
+
+void run(HookContext context) async {
+  final logger = context.logger;
+  final String functionName = context.vars['function_name'] ?? '';
+  final String requestObject = context.vars['request_object'] ?? '';
+
+  final cName = functionName.camelCase;
+  final pName = functionName.pascalCase;
+  final uName = functionName.snakeCase.toUpperCase();
+
+  final secureKeyValue = _generateSecureKey(uName);
+
+  String projectName = 'your_project';
+  final pubspecFile = File('pubspec.yaml');
+  if (pubspecFile.existsSync()) {
+    final doc = loadYaml(pubspecFile.readAsStringSync());
+    projectName = doc['name'] ?? projectName;
+  }
+
+  final bool isList = requestObject.startsWith('List<');
+  final bool isString = requestObject.toLowerCase() == 'string';
+
+  String baseType = requestObject;
+  if (isList) {
+    baseType = requestObject.substring(5, requestObject.length - 1);
+  }
+
+  final files = [
+    'lib/Grounded/memory/ConnectInternalMemory.dart',
+    'lib/Grounded/memory/InternalMemory.dart',
+    'lib/Grounded/informatics/AppDataManager.dart'
+  ];
+
+  String? importLine;
+  String? importFileName;
+  if (!isString) {
+    final result = await _findClassData(baseType, projectName);
+    importLine = result?['line'];
+    importFileName = result?['fileName'];
+  }
+
+  // --- Implementation Logic ---
+  String getLogic = "";
+  String setLogic = "";
+
+  if (isString) {
+    getLogic = "return await groundedStorage.read(key: $uName) ?? '';";
+    setLogic = "await groundedStorage.write(key: $uName, value: data);";
+  } else if (isList) {
+    getLogic = '''
+    final dataString = await groundedStorage.read(key: $uName);
+    if (dataString != null && dataString.isNotEmpty) {
+      return (jsonDecode(dataString) as List)
+          .map((item) => $baseType.fromJson(item))
+          .toList();
+    }
+    return [];''';
+    setLogic = '''
+    final jsonString = jsonEncode(data.map((item) => item.toJson()).toList());
+    await groundedStorage.write(key: $uName, value: jsonString);''';
+  } else {
+    getLogic = '''
+    final jsonString = await groundedStorage.read(key: $uName);
+    if (jsonString != null && jsonString.isNotEmpty) {
+      return $baseType.fromJson(jsonDecode(jsonString));
+    }
+    return $baseType();''';
+    setLogic = '''
+    await groundedStorage.write(key: $uName, value: jsonEncode(data.toJson()));''';
+  }
+
+  // --- 1. ConnectInternalMemory (No space between the pair) ---
+  final interfaceCode = "  Future<$requestObject> get$pName();\n  Future set$pName($requestObject data);";
+  await _inject(files[0], interfaceCode, logger, importLine: importLine, importFileName: importFileName, duplicateCheck: "get$pName()");
+
+  // --- 2. InternalMemory (Key spacing at TOP) ---
+  final String keyLine = '\n\n  static const String $uName = "$secureKeyValue";\n';
+  final String methods = '''
+  @override
+  Future<$requestObject> get$pName() async {
+    $getLogic
+  }
+
+  @override
+  Future set$pName($requestObject data) async {
+    $setLogic
+  }''';
+
+  await _injectInternalMemory(files[1], keyLine, methods, logger, importLine: importLine, importFileName: importFileName, duplicateCheck: "get$pName()");
+
+  // --- 3. AppDataManager ---
+  final String wrapper = '''
+  @override
+  Future<$requestObject> get$pName() async {
+    return await connectInternalMemory.get$pName();
+  }
+
+  @override
+  Future set$pName($requestObject data) async {
+    return await connectInternalMemory.set$pName(data);
+  }''';
+  await _inject(files[2], wrapper, logger, importLine: importLine, importFileName: importFileName, duplicateCheck: "get$pName()");
+
+  // --- 4. Format ---
+  try {
+    await Process.run('dart', ['format', 'lib/Grounded/']);
+  } catch (_) {}
+
+  logger.success('✨ Internal Memory synced with corrected spacing.');
+}
+
+String _generateSecureKey(String base) {
+  final random = Random.secure();
+  final values = List<int>.generate(12, (i) => random.nextInt(256));
+  return "${base}_${base64Url.encode(values).replaceAll('=', '').substring(0, 16)}";
+}
+
+Future<Map<String, String>?> _findClassData(String className, String projectName) async {
+  final dir = Directory('lib');
+  if (!dir.existsSync()) return null;
+  for (var f in dir.listSync(recursive: true)) {
+    if (f is File && f.path.endsWith('.dart')) {
+      final content = await f.readAsString();
+      if (content.contains('class $className')) {
+        return {
+          'line': "import 'package:$projectName/${f.path.replaceFirst('lib/', '')}';",
+          'fileName': f.path.split('/').last,
+        };
+      }
+    }
+  }
+  return null;
+}
+
+Future<void> _inject(String path, String content, Logger logger, {String? importLine, String? importFileName, String? duplicateCheck}) async {
+  final file = File(path);
+  if (!await file.exists()) return;
+  String fileContent = await file.readAsString();
+  if (duplicateCheck != null && fileContent.contains(duplicateCheck)) return;
+
+  if (importLine != null && importFileName != null && !fileContent.contains(importFileName)) {
+    fileContent = "$importLine\n$fileContent";
+  }
+
+  final lastBrace = fileContent.lastIndexOf('}');
+  if (lastBrace != -1) {
+    // Inject with double newlines between previous content and new content
+    fileContent = fileContent.substring(0, lastBrace).trimRight() + '\n\n$content\n' + fileContent.substring(lastBrace);
+    await file.writeAsString(fileContent);
+  }
+}
+
+Future<void> _injectInternalMemory(String path, String keyLine, String methods, Logger logger, {String? importLine, String? importFileName, String? duplicateCheck}) async {
+  final file = File(path);
+  if (!await file.exists()) return;
+  String content = await file.readAsString();
+
+  if (duplicateCheck != null && content.contains(duplicateCheck)) return;
+
+  if (importLine != null && importFileName != null && !content.contains(importFileName)) {
+    content = "$importLine\n$content";
+  }
+
+  if (!content.contains("import 'dart:convert';")) {
+    content = "import 'dart:convert';\n$content";
+  }
+
+  // Inject Key at the top with forced extra spacing
+  final classStart = content.indexOf('{');
+  if (classStart != -1) {
+    content = content.substring(0, classStart + 1) + "$keyLine" + content.substring(classStart + 1);
+  }
+
+  // Inject Methods at the bottom
+  final lastBrace = content.lastIndexOf('}');
+  if (lastBrace != -1) {
+    content = content.substring(0, lastBrace).trimRight() + "\n\n$methods\n" + content.substring(lastBrace);
+  }
+
+  await file.writeAsString(content);
+}

frontend/bricks/internal_memory/hooks/pubspec.yaml

@@ -0,0 +1,8 @@
+name: internal_memory_hooks
+description: Hooks for internal_memory.
+publish_to: none
+environment:
+  sdk: ">=3.0.0 <4.0.0"
+dependencies:
+  mason: ^0.1.0-dev.51
+  yaml: ^3.1.2

frontend/bricks/mvvc_template/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.1.0+1
+
+- TODO: Describe initial release.

frontend/bricks/mvvc_template/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.

frontend/bricks/mvvc_template/README.md

@@ -0,0 +1,27 @@
+# mvvc_template
+
+[![Powered by Mason](https://img.shields.io/endpoint?url=https%3A%2F%2Ftinyurl.com%2Fmason-badge)](https://github.com/felangel/mason)
+
+A new brick created with the Mason CLI.
+
+_Generated by [mason][1] 🧱_
+
+## Getting Started 🚀
+
+This is a starting point for a new brick.
+A few resources to get you started if this is your first brick template:
+
+- [Official Mason Documentation][2]
+- [Code generation with Mason Blog][3]
+- [Very Good Livestream: Felix Angelov Demos Mason][4]
+- [Flutter Package of the Week: Mason][5]
+- [Observable Flutter: Building a Mason brick][6]
+- [Meet Mason: Flutter Vikings 2022][7]
+
+[1]: https://github.com/felangel/mason
+[2]: https://docs.brickhub.dev
+[3]: https://verygood.ventures/blog/code-generation-with-mason
+[4]: https://youtu.be/G4PTjA6tpTU
+[5]: https://youtu.be/qjA0JFiPMnQ
+[6]: https://youtu.be/o8B1EfcUisw
+[7]: https://youtu.be/LXhgiF5HiQg

frontend/bricks/mvvc_template/__brick__/lib/{{project}}/see/{{screen.lowerCase()}}/Connect{{screen}}.dart

@@ -0,0 +1,2 @@
+abstract class Connect{{screen}}{
+}

frontend/bricks/mvvc_template/__brick__/lib/{{project}}/see/{{screen.lowerCase()}}/View{{screen}}.dart

@@ -0,0 +1,14 @@
+import 'package:flutter/cupertino.dart';
+
+import '../parent/ParentViewModel.dart';
+import 'Connect{{screen}}.dart';
+
+class View{{screen}} extends ParentViewModel {
+  Connect{{screen}} connection;
+
+  View{{screen}}(BuildContext context, this.connection) : super(context);
+
+  // Business logic goes here. Guard every network call with hasNetwork, wrap
+  // it in showLoading/closeLoading, and push results back through
+  // `connection` rather than touching widgets directly.
+}

frontend/bricks/mvvc_template/__brick__/lib/{{project}}/see/{{screen.lowerCase()}}/{{screen}}.dart

@@ -0,0 +1,11 @@
+
+import 'package:flutter/material.dart';
+import '{{screen}}State.dart';
+
+class {{screen}}  extends StatefulWidget{
+  const {{screen}} ({Key? key}) : super(key: key);
+
+  @override
+  State<{{screen}}> createState() => {{screen}}State();
+
+}

frontend/bricks/mvvc_template/__brick__/lib/{{project}}/see/{{screen.lowerCase()}}/{{screen}}State.dart

@@ -0,0 +1,77 @@
+import 'package:flutter/cupertino.dart';
+import 'package:flutter/material.dart';
+import 'package:stacked/stacked.dart';
+
+import 'package:Grounded/Grounded/about/internal/application/TextType.dart';
+import 'package:Grounded/Grounded/designs/Responsive.dart';
+import 'package:Grounded/Grounded/designs/Shell.dart';
+import 'package:Grounded/Grounded/designs/text/Text.dart';
+import 'package:Grounded/Grounded/utils/Colors.dart';
+
+import 'Connect{{screen}}.dart';
+import '{{screen}}.dart';
+import 'View{{screen}}.dart';
+
+class {{screen}}State extends State<{{screen}}> implements Connect{{screen}} {
+  View{{screen}}? _model;
+
+  @override
+  Widget build(BuildContext context) {
+    return ViewModelBuilder<View{{screen}}>.reactive(
+      viewModelBuilder: () => View{{screen}}(context, this),
+      onViewModelReady: (viewModel) {
+        _model = viewModel;
+        _initiate();
+      },
+      builder: (context, viewModel, child) => LayoutBuilder(
+        builder: (BuildContext context, BoxConstraints viewportConstraints) {
+          return Responsive(
+            mobile: _mobileView(viewportConstraints),
+            tablet: _tabletView(viewportConstraints),
+            desktop: _desktopView(viewportConstraints),
+          );
+        },
+      ),
+    );
+  }
+
+  void _initiate() {
+    // Load initial data through _model here; push results back via the
+    // Connect{{screen}} callbacks below.
+  }
+
+  void _onBack() {
+    Navigator.pop(context);
+  }
+
+  Widget _mobileView(BoxConstraints viewportConstraints) {
+    return Sheet(
+      eyebrow: "Grounded",
+      title: "{{screen}}",
+      onBack: _onBack,
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.stretch,
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          displayTitle("{{screen}}"),
+          const SizedBox(height: 14),
+          text(
+            "Replace this with the screen content.",
+            14,
+            TextType.Regular,
+            color: colorGrey2,
+            height: 1.55,
+          ),
+        ],
+      ),
+    );
+  }
+
+  Widget _tabletView(BoxConstraints viewportConstraints) {
+    return _mobileView(viewportConstraints);
+  }
+
+  Widget _desktopView(BoxConstraints viewportConstraints) {
+    return _mobileView(viewportConstraints);
+  }
+}

frontend/bricks/mvvc_template/brick.yaml

@@ -0,0 +1,38 @@
+name: mvvc_template
+description: A new brick created with the Mason CLI.
+
+# The following defines the brick repository url.
+# Uncomment and update the following line before publishing the brick.
+# repository: https://github.com/my_org/my_repo
+
+# The following defines the version and build number for your brick.
+# A version number is three numbers separated by dots, like 1.2.34
+# followed by an optional build number (separated by a +).
+version: 0.1.0+1
+
+# The following defines the environment for the current brick.
+# It includes the version of mason that the brick requires.
+environment:
+  mason: ^0.1.1
+
+# Variables specify dynamic values that your brick depends on.
+# Zero or more variables can be specified for a given brick.
+# Each variable has:
+#  * a type (string, number, boolean, enum, array, or list)
+#  * an optional short description
+#  * an optional default value
+#  * an optional list of default values (array only)
+#  * an optional prompt phrase used when asking for the variable
+#  * a list of values (enums only)
+#  * an optional separator (list only)
+vars:
+  project:
+    type: string
+    description: The project name
+    default: Grounded
+    prompt: What is your project name?
+  screen:
+    type: string
+    description: The name of the new screen
+    default: ActivityNew
+    prompt: What is your file name?