Mason Brick Development Skill

This skill guides the creation, modification, and removal of Mason bricks, ensuring test coverage and CI workflow integration.

When to Use

Trigger this skill when:

• Creating a new Mason brick template
• Updating an existing brick's structure or variables
• Removing a brick from the project
• User asks to "create a brick", "add a mason template", "update brick", or "remove brick"

Project Structure

Bricks are organized in three locations:

bricks/                    # Mason template definitions
├── brick_name/
│   ├── brick.yaml         # Brick configuration and variables
│   ├── __brick__/         # Template files with Mustache syntax
│   └── hooks/             # Optional pre/post generation hooks

test_bricks/               # Brick tests (one folder per brick)
├── brick_name/
│   └── brick_name_test.dart

.github/workflows/
└── brick-test.yml         # Parallel CI jobs for each brick

Creating a New Brick

Step 1: Create Brick Directory

bash
1mkdir -p bricks/new_brick/__brick__

Step 2: Create brick.yaml

yaml
1name: new_brick
2description: Description of what this brick generates
3version: 0.1.0+1
4
5environment:
6  mason: ^0.1.1
7
8vars:
9  name:
10    type: string
11    description: The name for the generated component
12    prompt: What is the name?
13
14  # Add more variables as needed
15  optional_var:
16    type: boolean
17    description: Optional feature flag
18    default: true

Step 3: Create Template Files

In __brick__/, create files using Mustache syntax:

__brick__/
├── {{name.snakeCase()}}/
│   ├── lib/
│   │   └── {{name.snakeCase()}}.dart
│   ├── pubspec.yaml
│   └── README.md

Use these Mustache helpers:

• {{name}} - raw value
• {{name.snakeCase()}} - snake_case
• {{name.pascalCase()}} - PascalCase
• {{name.camelCase()}} - camelCase
• {{name.paramCase()}} - param-case
• {{#flag}}...{{/flag}} - conditional block
• {{^flag}}...{{/flag}} - inverted conditional

Step 4: Create Brick Test

Create test_bricks/new_brick/new_brick_test.dart:

dart
1import 'dart:io';
2import 'package:mason/mason.dart';
3import 'package:path/path.dart' as path;
4import 'package:test/test.dart';
5
6void main() {
7  group('New Brick Tests', () {
8    late Directory tempDir;
9
10    setUp(() async {
11      tempDir = await Directory.systemTemp.createTemp('new_brick_test_');
12    });
13
14    tearDown(() async {
15      if (await tempDir.exists()) {
16        await tempDir.delete(recursive: true);
17      }
18    });
19
20    test('generates correct structure', () async {
21      final brick = Brick.path(path.join('..', '..', 'bricks', 'new_brick'));
22
23      final generator = await MasonGenerator.fromBrick(brick);
24      await generator.generate(
25        DirectoryGeneratorTarget(tempDir),
26        vars: {'name': 'test_name'},
27      );
28
29      // Verify generated files exist
30      final file = File(path.join(tempDir.path, 'test_name', 'pubspec.yaml'));
31      expect(await file.exists(), isTrue);
32    });
33
34    // Add more tests for different variable combinations
35  });
36}

Step 5: Add Workflow Job

Add a new job to .github/workflows/brick-test.yml:

yaml
1  new-brick:
2    name: Test new_brick
3    runs-on: ubuntu-latest
4    steps:
5      - uses: actions/checkout@v6
6
7      - uses: flutter-actions/setup-flutter@v4
8
9      - name: Cache dependencies
10        uses: actions/cache@v5
11        with:
12          path: |
13            ~/.pub-cache
14            .dart_tool
15          key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}
16          restore-keys: ${{ runner.os }}-pub-
17
18      - name: Install tools
19        run: dart pub global activate melos
20
21      - name: Prepare project
22        run: |
23          melos run prepare
24          mason get
25
26      - name: Test new_brick brick
27        run: dart run test_bricks/new_brick/new_brick_test.dart

Step 6: Register Brick

Add to root mason.yaml:

yaml
1bricks:
2  new_brick:
3    path: bricks/new_brick

Then run mason get to register.

Updating an Existing Brick

When modifying a brick:

1. Update brick.yaml if adding/removing variables
2. Update template files in __brick__/
3. Update tests in test_bricks/brick_name/ to cover changes
4. Run test locally: dart run test_bricks/brick_name/brick_name_test.dart
5. Increment version in brick.yaml

Removing a Brick

When removing a brick, update all three locations:

1. Remove brick directory: rm -rf bricks/brick_name
2. Remove test directory: rm -rf test_bricks/brick_name
3. Remove workflow job from .github/workflows/brick-test.yml
4. Remove from mason.yaml
5. Update CLAUDE.md if the brick was documented

Testing Locally

bash
1# Register bricks
2mason get
3
4# Test a specific brick
5dart run test_bricks/brick_name/brick_name_test.dart
6
7# Test brick generation manually
8mason make brick_name -o /tmp/test_output --var1=value1

Existing Bricks Reference

Checklist

When creating/updating a brick:

• brick.yaml has name, description, version, and vars
• Template files use correct Mustache syntax
• Test file exists in test_bricks/brick_name/
• Tests cover main generation paths
• Workflow job added/updated in brick-test.yml
• Brick registered in mason.yaml
• Run mason get to verify registration
• Run test locally before committing