feat: Adding the app ui template

.github/.cspell/dart_dictionary.txt

@@ -3,6 +3,8 @@ audioplayers # A Flutter plugin to play multiple simultaneously audio files.
 cupertino # Flutter module containing iOS-style widgets.
 endtemplate # Dart doc macro used to end a reusable piece of documentation.
 fluttium # User flow testing tool for Flutter.
+lerp # Linear interpolation, commonly used in Flutter for animating between values.
+widgetbook # A Flutter package for cataloging widgets.
 LTWH # From Flutter, abbreviation left, top, width and height.
 macos # MacOs, apple's operating system for Mac.
 mockingjay # A Flutter package for mocking navigation.

.github/.cspell/words_dictionary.txt

@@ -28,6 +28,7 @@ nicorn # "unicorn", but without the "u".
 unmutes # To allow to produce sound again.
 verygood # Very Good, but without a space.
 xcode # Apple's integrated development environment.
+xxlg # Abbreviation for extra extra large, used in spacing scales.
 xcworkspace # Abbreviation for Xcode workspace.
 xcassets # Abbreviation for Xcode assets.
 hola # part of translations example

.github/workflows/very_good_app_ui.yaml

@@ -0,0 +1,59 @@
+name: very_good_app_ui
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    paths:
+      - .github/workflows/very_good_app_ui.yaml
+      - "very_good_app_ui/**"
+    branches:
+      - main
+  pull_request:
+    paths:
+      - .github/workflows/very_good_app_ui.yaml
+      - "very_good_app_ui/**"
+    branches:
+      - main
+
+jobs:
+  brick:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 📚 Git Checkout
+        uses: actions/checkout@v6
+
+      - name: 🐦 Setup Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          flutter-version: "3.41.x"
+
+      - name: 🧱 Mason Make
+        run: |
+          dart pub global activate mason_cli
+          mason get
+          mason make very_good_app_ui -c very_good_app_ui/config.json --on-conflict overwrite -o very_good_app_ui_output
+
+      - name: 📦 Install Dependencies
+        run: |
+          dart pub global activate very_good_cli
+          very_good packages get --recursive very_good_app_ui_output
+
+      - name: ✨ Check Formatting
+        run: dart format --set-exit-if-changed very_good_app_ui_output
+
+      - name: 🕵️ Analyze
+        run: dart analyze --fatal-infos --fatal-warnings very_good_app_ui_output
+
+      - name: 🧪 Run Tests
+        run: |
+          cd very_good_app_ui_output
+          very_good test -j 4 --recursive --optimization --coverage --test-randomize-ordering-seed random
+
+      - name: 📊 Check Code Coverage
+        uses: VeryGoodOpenSource/very_good_coverage@v3
+        with:
+          path: very_good_app_ui_output/coverage/lcov.info

.release-please-config.json

@@ -67,6 +67,14 @@
       "extra-files": [
         "brick.yaml"
       ]
+    },
+    "very_good_app_ui": {
+      "release-type": "simple",
+      "version-file": "version.txt",
+      "component": "very_good_app_ui",
+      "extra-files": [
+        "brick.yaml"
+      ]
     }
   }
 }

.release-please-manifest.json

@@ -5,6 +5,7 @@
     "very_good_docs_site": "1.0.3",
     "very_good_flame_game": "1.3.0",
     "very_good_flutter_package": "1.3.0",
-    "very_good_flutter_plugin": "1.3.0"
+    "very_good_flutter_plugin": "1.3.0",
+    "very_good_app_ui": "0.1.0"
 }
 

mason.yaml

@@ -12,4 +12,6 @@ bricks:
   very_good_flame_game:
     path: very_good_flame_game
   very_good_flutter_plugin:
-    path: very_good_flutter_plugin
+    path: very_good_flutter_plugin
+  very_good_app_ui:
+    path: very_good_app_ui

very_good_app_ui/.gitignore

@@ -0,0 +1,17 @@
+.DS_Store
+.atom/
+.idea/*
+.vscode/*
+
+# Files and directories created by pub
+.dart_tool/
+.packages
+pubspec.lock
+
+# Files and directories created by mason
+.mason/
+mason-lock.json
+output/
+
+# Files and directories created by MacOS
+.DS_Store

very_good_app_ui/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 0.1.0
+
+- feat: initial release

very_good_app_ui/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Very Good Ventures
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

very_good_app_ui/README.md

@@ -0,0 +1,108 @@
+# Very Good App UI
+
+[![Very Good Ventures][logo_white]][very_good_ventures_link_dark]
+
+Developed with 💙 by [Very Good Ventures][very_good_ventures_link] 🦄
+
+[![License: MIT][license_badge]][license_link]
+[![Powered by Mason](https://img.shields.io/endpoint?url=https%3A%2F%2Ftinyurl.com%2Fmason-badge)](https://github.com/felangel/mason)
+
+A Very Good Flutter app UI package created by Very Good Ventures 🦄.
+
+## What's Included ✨
+
+- ✅ GitHub Workflow powered by [Very Good Workflows][very_good_workflows_link]
+- ✅ Pull Request Template
+- ✅ Issue Templates
+- ✅ Dependabot Integration
+- ✅ Strict lint rules powered by [Very Good Analysis][very_good_analysis_link]
+- ✅ 100% Test Coverage
+- ✅ Fully Documented Public API
+- ✅ MIT License
+- ✅ Changelog
+- ✅ `ThemeExtension`-based theming with light and dark variants
+- ✅ Custom color and spacing tokens
+- ✅ Example `AppButton` widget composing Material widgets
+- ✅ `BuildContext` extensions for easy theme access
+- ✅ Widget test helpers
+- ✅ Widgetbook catalog for browsing widgets in isolation
+
+## Output 📦
+
+```sh
+├── .github
+│   ├── ISSUE_TEMPLATE
+│   │   ├── bug_report.md
+│   │   ├── build.md
+│   │   ├── chore.md
+│   │   ├── ci.md
+│   │   ├── config.yml
+│   │   ├── documentation.md
+│   │   ├── feature_request.md
+│   │   ├── performance.md
+│   │   ├── refactor.md
+│   │   ├── revert.md
+│   │   ├── style.md
+│   │   └── test.md
+│   ├── PULL_REQUEST_TEMPLATE.md
+│   ├── dependabot.yaml
+│   └── workflows
+│       └── main.yaml
+├── .gitignore
+├── CHANGELOG.md
+├── LICENSE
+├── README.md
+├── analysis_options.yaml
+├── coverage_badge.svg
+├── lib
+│   ├── src
+│   │   ├── extensions
+│   │   │   └── build_context_extensions.dart
+│   │   ├── theme
+│   │   │   ├── app_colors.dart
+│   │   │   ├── app_spacing.dart
+│   │   │   └── app_theme.dart
+│   │   └── widgets
+│   │       └── app_button.dart
+│   └── my_app_ui.dart
+├── pubspec.yaml
+├── test
+│   ├── helpers
+│   │   ├── helpers.dart
+│   │   └── pump_app.dart
+│   └── src
+│       ├── theme
+│       │   ├── app_colors_test.dart
+│       │   ├── app_spacing_test.dart
+│       │   └── app_theme_test.dart
+│       └── widgets
+│           └── app_button_test.dart
+└── widgetbook
+    ├── .gitignore
+    ├── analysis_options.yaml
+    ├── lib
+    │   ├── main.dart
+    │   └── widgetbook
+    │       ├── use_cases
+    │       │   └── app_button.dart
+    │       ├── widgetbook.dart
+    │       └── widgets
+    │           ├── use_case_decorator.dart
+    │           └── widgets.dart
+    └── pubspec.yaml
+```
+
+By default `mason make` will generate the output in the current working directory but a custom output directory can be specified via the [-o option][mason_output_dir]:
+
+```sh
+mason make very_good_app_ui -o ./output_folder
+```
+
+[mason_output_dir]: https://docs.brickhub.dev/mason-make#-custom-output-directory
+[license_badge]: https://img.shields.io/badge/license-MIT-blue.svg
+[license_link]: https://opensource.org/licenses/MIT
+[logo_white]: https://raw.githubusercontent.com/VGVentures/very_good_brand/main/styles/README/vgv_logo_white.png#gh-dark-mode-only
+[very_good_analysis_link]: https://pub.dev/packages/very_good_analysis
+[very_good_ventures_link_dark]: https://verygood.ventures#gh-dark-mode-only
+[very_good_ventures_link]: https://verygood.ventures
+[very_good_workflows_link]: https://github.com/VeryGoodOpenSource/very_good_workflows

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: "fix: "
+labels: bug
+---
+
+**Description**
+
+A clear and concise description of what the bug is.
+
+**Steps To Reproduce**
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected Behavior**
+
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+
+If applicable, add screenshots to help explain your problem.
+
+**Additional Context**
+
+Add any other context about the problem here.

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/build.md

@@ -0,0 +1,14 @@
+---
+name: Build System
+about: Changes that affect the build system or external dependencies
+title: "build: "
+labels: build
+---
+
+**Description**
+
+Describe what changes need to be done to the build system and why.
+
+**Requirements**
+
+- [ ] The build system is passing

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/chore.md

@@ -0,0 +1,14 @@
+---
+name: Chore
+about: Other changes that don't modify src or test files
+title: "chore: "
+labels: chore
+---
+
+**Description**
+
+Clearly describe what change is needed and why. If this changes code then please use another issue type.
+
+**Requirements**
+
+- [ ] No functional changes to the code

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/ci.md

@@ -0,0 +1,14 @@
+---
+name: Continuous Integration
+about: Changes to the CI configuration files and scripts
+title: "ci: "
+labels: ci
+---
+
+**Description**
+
+Describe what changes need to be done to the ci/cd system and why.
+
+**Requirements**
+
+- [ ] The ci system is passing

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,14 @@
+---
+name: Documentation
+about: Improve the documentation so all collaborators have a common understanding
+title: "docs: "
+labels: documentation
+---
+
+**Description**
+
+Clearly describe what documentation you are looking to add or improve.
+
+**Requirements**
+
+- [ ] Requirements go here

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature Request
+about: A new feature to be added to the project
+title: "feat: "
+labels: feature
+---
+
+**Description**
+
+Clearly describe what you are looking to add. The more context the better.
+
+**Requirements**
+
+- [ ] Checklist of requirements to be fulfilled
+
+**Additional Context**
+
+Add any other context or screenshots about the feature request go here.

very_good_app_ui/__brick__/.github/ISSUE_TEMPLATE/performance.md

@@ -0,0 +1,14 @@
+---
+name: Performance Update
+about: A code change that improves performance
+title: "perf: "
+labels: performance
+---
+
+**Description**
+
+Clearly describe what code needs to be changed and what the performance impact is going to be. Bonus point's if you can tie this directly to user experience.
+
+**Requirements**
+
+- [ ] There is no drop in test coverage.