Flutter template with a committed starter app, doctrine-aligned governance, and core-gated CI.

Status

• Stage: Draft | Active | Stable | Deprecated
• Owner:
• License:
• Visibility: Public | Private | Internal
• Reason:
• Promotion criteria to Public:

What This Project Is

• A baseline Flutter repository template with a runnable app/ project.
• A derived template from repo-template-base with Flutter-specific quality gates.

Why It Exists

• Provide a ready-to-run Flutter baseline with consistent governance and CI quality bars.

Use This Template

1. Click Use this template on GitHub to create a new repository.
2. Rename package/module identifiers and update ownership metadata.
3. Review .env.example and update environment configuration for your target project.
4. Run validation and CI checks before first release.

Quickstart

Prerequisites

• Flutter SDK (stable)
• rg (ripgrep)

Run the App

cd app
flutter pub get
flutter run

Core Checks (Blocking)

cd app
flutter analyze
flutter test

Repository Layout

• app/ Flutter application root (committed starter app)
• docs/ project documentation and doctrine snapshot
• examples/ optional usage examples
• tools/ helper scripts
• .github/ issue templates and CI workflows

Documentation

• Overview
• Architecture
• ADRs
• Doctrine Snapshot

Validation

bash tools/validate-template.sh core
bash tools/validate-template.sh advisory

Contributing

See CONTRIBUTING.md.