SOLIDUI: Add example as a template

[gjwgit]

Create a template for flutter create --template solidui

Base the template on the example app so that create will effectively produce the example directory.

Retain the example directory for a user to quickly get a demo but implement a script to transform the template code into the example directory.

[gjwgit]

According to Claude

To provide a template for your Flutter package, you need to create a template that users can generate using flutter create with your package. Here's how:

Creating a Template for Your Package

1. Create the Template Directory Structure

In your package repository, create a templates directory:

my_package/
├── lib/
├── templates/
│   └── my_template_name/
│       ├── __brick__/
│       │   ├── lib/
│       │   │   └── main.dart
│       │   ├── pubspec.yaml
│       │   └── ...other files
│       └── brick.yaml
└── pubspec.yaml

2. Use Mason for Template Management

The recommended approach is using Mason, which is what the Flutter team uses:

Install Mason:

dart pub global activate mason_cli

Initialize Mason in your package:

mason init

Create a new template:

mason new my_template_name

This creates a template structure with variables.

3. Define Your Template

brick.yaml - Define template metadata and variables:

name: my_template_name
description: A template for my package
version: 0.1.0
vars:
  name:
    type: string
    description: The name of your project
    default: my_app
    prompt: What is your project name?

Template Files - Use {{variable}} syntax in your template files:

// __brick__/lib/main.dart
import 'package:flutter/material.dart';

void main() {
  runApp(const {{name.pascalCase()}}App());
}

class {{name.pascalCase()}}App extends StatelessWidget {
  const {{name.pascalCase()}}App({super.key});
  
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '{{name.titleCase()}}',
      home: Scaffold(
        appBar: AppBar(title: const Text('{{name.titleCase()}}')),
      ),
    );
  }
}

4. Publish Your Template

Option A: As a Mason brick

Add to mason.yaml in user's project:

bricks:
  my_template_name:
    git:
      url: https://github.com/yourname/your-package.git
      path: templates/my_template_name

Then users run:

mason make my_template_name

Option B: Publish to brick.pub

mason publish

Users can then add it:

mason add my_template_name
mason make my_template_name

5. Document Usage

In your package README:

## Using the Template

Install Mason:
```bash
dart pub global activate mason_cli

Add the template:

mason add -g my_template_name

Generate from template:

mason make my_template_name --name my_new_app

[gjwgit]

The browserpod app should be the template? A very simple yet useful template app.