⬢ S Y N T R I X • Enterprise Tools & AI Engineering Studio for Flutter & Dart #

A deterministic, plan-first engineering platform to scaffold, audit, document, test, certify, and publish production-grade packages.

  ⚡ Scaffolding Engine   ──►   🛡️ 5-Profile Audit   ──►   🤖 AI Code Center   ──►   📦 pub.dev Release Gate

🧭 Navigation Matrix #

# Direct Jump Matrix (Click any section below to navigate)
├── 01. INTRO & BENCHMARK
│   ├── ❯ syntrix --why-syntrix    ──► [What is Syntrix?]
│   ├── ❯ syntrix --vs-flutter     ──► [Why Syntrix over flutter create?]
│   └── ❯ syntrix --quickstart     ──► [Quick Start Guide]
│
├── 02. ARCHITECTURE & CORE
│   ├── ❯ syntrix --workspace      ──► [Architecture at a Glance]
│   ├── ❯ syntrix --templates      ──► [01. Template & Package Engineering]
│   └── ❯ syntrix --audit-matrix   ──► [02. Deterministic Audit Engine]
│
└── 03. INTELLIGENCE & TOOLING
    ├── ❯ syntrix --ai-tools       ──► [03. AI Engineering Command Center]
    ├── ❯ syntrix --docs-gen       ──► [04. Automated Documentation System]
    ├── ❯ syntrix --testing        ──► [05. Testing & Certification]
    └── ❯ syntrix --help           ──► [Complete CLI Command Reference]

💡 What is Syntrix? #

Syntrix (Flutter Package Studio) is a deterministic, plan-first engineering platform designed to turn ad-hoc Flutter and Dart package development into a verifiable, enterprise-grade production pipeline.

⚡ 01. Plan-First Scaffolding

Compose multi-layer, modular package blueprints with strict YAML schema validation, token casing transforms, and atomic dry-run previews before touching disk.

🛡️ 02. Deterministic 5-Profile Audit

Continuous health gates across basic, standard, strict, and release profiles to enforce pedantic lints, 100% public doc coverage, and platform matrix sanity.

🤖 03. 13-Tool AI Command Center

Integrated Flutter-specialized AI engines for deep AST code reviews, root-cause failure diagnosis, 9-stage workflow plans, and cross-session memory.

📚 04. Automated Docs & Diagrams

Auto-generate publication-grade API references, runnable example sandboxes, interactive Mermaid class/flow diagrams, and static web documentation sites.

🚀 05. Rigorous Release Gates & Hermetic Verification

Automated test project generation, performance & memory regression baselines, dependency conflict risk scoring, and mandatory pre-publish certification for pub.dev.

⚔️ Why Syntrix over `flutter create`? #

While flutter create --template=package provides a bare-bones skeleton, it leaves all heavy engineering, architecture governance, documentation, and release verification to manual effort. Syntrix provides a deterministic, automated lifecycle.

┌────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│  TRADITIONAL WORKFLOW (`flutter create`):                                                             │
│                                                                                                        │
│  flutter create ──► Manual Structure ──► Manual Docs ──► Manual Testing ──► Unverified pub.dev publish│
│                                                                                  ▲ (High Risk)         │
├────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│  SYNTRIX DETERMINISTIC PIPELINE:                                                                      │
│                                                                                                        │
│  syntrix create ──► Blueprint Compose ──► 5-Profile Audit ──► AI Review ──► Certified pub.dev Release │
│                                                                                  ▲ (Zero Risk)         │
└────────────────────────────────────────────────────────────────────────────────────────────────────────┘

📊 Feature Scorecard & Benchmark #

┌──────────────────────────────┬──────────────────┬──────────────────┬────────────────────────┐
│ DOMAIN                       │ `flutter create` │ MASON / VGC      │ ⬢ SYNTRIX              │
├──────────────────────────────┼──────────────────┼──────────────────┼────────────────────────┤
│ 📐 Composable Blueprints     │ 🔴 1 / 10        │ 🟡 6 / 10        │ 🟢 10 / 10 (Full)      │
│ 🛡️ Deterministic 5-Gate QA   │ 🔴 0 / 10        │ 🔴 0 / 10        │ 🟢 10 / 10 (Built-in)  │
│ 🤖 13-Tool AI Command Center │ 🔴 0 / 10        │ 🔴 0 / 10        │ 🟢 10 / 10 (AST-Aware) │
│ 📚 Living Docs & Mermaid     │ 🔴 1 / 10        │ 🟡 4 / 10        │ 🟢 10 / 10 (Automated) │
│ 🚀 Pre-Publish Certification │ 🔴 0 / 10        │ 🔴 0 / 10        │ 🟢 10 / 10 (Zero-Risk) │
└──────────────────────────────┴──────────────────┴──────────────────┴────────────────────────┘

Feature / Capability	`flutter create`	Mason / VeryGoodCli	Syntrix (Flutter Package Studio)
Execution Model	Direct write	Direct write	✅ Plan-First (Preview before mutation)
Audit Engine	❌ None	❌ None	✅ 5-Profile deterministic audit (`basic` to `release`)
AI Command Center	❌ None	❌ None	✅ 13 AI tools (Review, Debug, Plan, Modify, Memory)
Architectural Analysis	❌ None	❌ None	✅ Circular dependency detection & layer checks
Dependency Risk Engine	❌ None	❌ None	✅ Conflict analysis & upgrade risk scoring
Secret & Leak Scanner	❌ None	❌ None	✅ Hardcoded credential & token exposure checks
Documentation Pipeline	Minimal README	Static template	✅ Mermaid diagrams, API references, Site builder
Testing & Baselines	1 sample test	Standard setup	✅ Automated test projects & regression baselines
Release Certification	❌ None	❌ None	✅ Multi-gate release readiness certification
CI/CD Automation	❌ None	❌ None	✅ Native `--json` output across all commands

Architecture at a Glance #

Syntrix is built as a modular Dart workspace targeting modern Dart SDK >=3.5.0 <4.0.0 and Flutter >=3.24.0.

Syntrix/
├── packages/
│   ├── flutter_package_studio_core/    # Core architectural library (DI, Engine, AI, Audits)
│   │   ├── lib/
│   │   │   ├── src/
│   │   │   │   ├── ai/                 # AI engineering, planning, review & debugging
│   │   │   │   ├── catalog/            # Built-in template repository & manifest schemas
│   │   │   │   ├── compatibility/      # Flutter & Dart SDK matrix compatibility engine
│   │   │   │   ├── di/                 # IoC container & dependency injection
│   │   │   │   ├── enterprise/         # Architecture, security & dependency analyzers
│   │   │   │   ├── logging/            # ANSI truecolor structured logger
│   │   │   │   ├── release_hardening/  # Audit profiles, quality gates & release certs
│   │   │   │   ├── repository/         # GitHub & Git workflow integrations
│   │   │   │   ├── studio_v2/          # V2 Pipeline orchestration & documentation
│   │   │   │   ├── template/           # Template composition, tokens & customization
│   │   │   │   ├── validation/         # Path safety, semver & parameter validators
│   │   │   │   └── wizard/             # Interactive terminal configuration wizard
│   │   │   └── flutter_package_studio_core.dart
│   │   ├── test/                       # 400+ comprehensive core unit & integration tests
│   │   └── pubspec.yaml
│   │
│   └── flutter_package_studio_cli/     # Native CLI application (`syntrix` and `fps`)
│       ├── bin/
│       │   └── fps.dart                # Executable entry point
│       ├── lib/
│       │   ├── src/
│       │   │   ├── base_command.dart   # Command abstraction with DI injection
│       │   │   ├── command_registry.dart # Stylized splash, help & dynamic registration
│       │   │   └── commands/           # 25+ production CLI commands
│       │   └── flutter_package_studio_cli.dart
│       ├── test/                       # CLI integration & argument parsing tests
│       └── pubspec.yaml
│
├── pubspec.yaml                        # Dart workspace manifest
└── LICENSE                             # MIT License

Core Capabilities #

01. Template & Package Engineering #

Syntrix treats package generation as a verified mathematical pipeline.

Composable Templates: Combine multiple modular templates (e.g., core-engine + ui-components + plugin-ffi) into a unified workspace.
Schema Validation: Every template is backed by a strict YAML schema validating required parameters, types, and constraints before touching the disk.
Smart Token Substitution: Supports casing transformations (pascalCase, camelCase, snake_case, kebab-case, constantCase).
Path Safety: Strict sanitization blocks path traversal attacks (../) and enforces absolute path normalization.

# Discover available templates
syntrix template list

# Inspect template requirements and options
syntrix template inspect flutter_enterprise_package

# Scaffold a new package interactively or via CLI
syntrix create my_awesome_package --template=flutter_enterprise_package --org=com.myorg

02. Deterministic Audit & Analysis #

Run comprehensive automated quality and compliance checks across your package directory.

┌────────────────────────────────────────────────────────────────────────┐
│                        SYNTRIX AUDIT MATRIX                            │
├──────────────────────┬─────────────────────────────────────────────────┤
│ Profile: basic       │ Structure, valid pubspec, entrypoint existence │
│ Profile: standard    │ Basic + License, README, changelog, pedantic lints│
│ Profile: strict      │ Standard + 100% public API docs, example folder │
│ Profile: release     │ Strict + Zero warnings, clean git, passing tests│
└──────────────────────┴─────────────────────────────────────────────────┘

syntrix audit / syntrix --audit: Executes multi-gate rule validation with actionable terminal reports and exit codes.
syntrix architecture: Analyzes imports to detect circular dependencies and layering violations.
syntrix deps: Evaluates outdated dependencies, version locks, and breaking upgrade risks.
syntrix security: Scans package source for hardcoded secrets, private tokens, and unsafe API usages.

# Run standard audit
syntrix --audit

# Run release-level strict audit with JSON report output
syntrix audit --profile=release --json > audit-report.json

03. AI Engineering Command Center #

Syntrix embeds 13 AI-powered engineering tools directly into your terminal, designed specifically for Dart and Flutter semantics.

                        ┌─────────────────────────┐
                        │   SYNTRIX AI ENGINE     │
                        └────────────┬────────────┘
                                      │
      ┌──────────────┬───────────────┼───────────────┬──────────────┐
      ↓              ↓               ↓               ↓              ↓
  syntrix review  syntrix debug   syntrix plan    syntrix modify  syntrix memory
  Code quality &  Root cause &    9-stage task    Safe AST-aware  Session state &
  lint analysis   fix proposal    decomposition   code transforms context cache

syntrix review: Deep semantic code review against Flutter best practices, performance bottlenecks, and memory leaks.
syntrix debug: Evaluates stack traces, error outputs, and source context to identify root causes with tiered certainty.
syntrix plan: Converts natural language feature requirements into structured 9-stage engineering execution plans.
syntrix modify: Previews and applies safe, AST-grounded code transformations.
syntrix memory: Maintains engineering session context and cross-session knowledge caches.

04. Automated Documentation System #

Produce publication-grade documentation automatically without manual drafting.

API Reference Generator: Parses Dart docstrings and builds searchable reference documents.
Mermaid Diagram Generator: Reverse-engineers classes, state machines, and dependency graphs into interactive Mermaid syntax.
Code Example Builder: Validates and formats working runnable examples directly from your test suite.
Static Site Builder: Assembles markdown, diagrams, and API docs into an exportable static web documentation portal.

# Generate architecture documentation and Mermaid diagrams
syntrix docs --architecture --diagrams

# Build a complete static documentation site
syntrix docs --site --output=build/docs

05. Testing, Quality & Release Certification #

Isolated Test Environments: Generates hermetic test sandboxes without polluting the main workspace.
Regression Baseline Tracking: Compares current test execution times and memory allocations against historical baselines.
Release Readiness Gate: Evaluates package compliance against pub.dev score criteria, changelog consistency, and semantic version bumps before triggering syntrix publish.

Complete CLI Reference #

Syntrix CLI commands are structured into 5 logical categories.

  ⬢  S Y N T R I X
    Enterprise-grade tools & AI engineering for Flutter & Dart packages

  Usage
    syntrix <command> [arguments]

Global Options #

Flag	Abbreviation	Description
`--help`	`-h`	Display usage information and available commands
`--version`	`-V`	Print current Syntrix CLI version
`--verbose`	`-v`	Enable verbose debug logging output
`--audit`		Fast-action flag to audit package structure in current directory

1. Package & Templates #

Command	Description
`syntrix create <name>`	Scaffold a new production-ready Flutter/Dart package
`syntrix template list`	Discover and list installed and remote templates
`syntrix template inspect <id>`	Inspect metadata, inputs, and structure of a template
`syntrix template compose`	Combine multiple templates into a unified blueprint
`syntrix plugin`	Manage Syntrix CLI plugins and extensions
`syntrix registry`	Manage remote template registries for the marketplace

2. AI Engineering #

Command	Description
`syntrix ai`	Unified AI command center for review, debug, test, and plan
`syntrix review`	Generate structured AI code review findings for your package
`syntrix debug`	Diagnose defects and exceptions with tiered certainty causes
`syntrix plan`	Convert requests into structured 9-stage implementation plans
`syntrix modify`	Propose, preview, and apply AI-assisted code modifications
`syntrix doc`	Generate grounded documentation or verify doc consistency
`syntrix docs`	Generate API documentation, diagrams, and static site assets
`syntrix memory`	Query and manage persistent engineering session memory
`syntrix project`	Inspect and analyze project workspace context

3. Analysis & Audit #

Command	Description
`syntrix audit`	Audit package structure, standards, and compatibility
`syntrix architecture`	Analyze circular dependencies and layering violations
`syntrix deps`	Analyze dependency versions, conflicts, and upgrade risk
`syntrix security`	Scan for hardcoded secret exposures and credential handling risks
`syntrix test`	Analyze coverage gaps and generate candidate test proposals
`syntrix release-readiness`	Evaluate release candidate readiness across all quality gates

4. Release & Publishing #

Command	Description
`syntrix release`	Orchestrate semantic versioning, changelogs, and release tags
`syntrix publish`	Validate and publish the package to `pub.dev` or private servers

Quick Start Guide #

1. Installation #

Activate Syntrix globally from your workspace or pub.dev:

dart pub global activate syntrix

Verify installation:

syntrix --version

2. Launch Welcome Hub #

Running syntrix without arguments opens the clean interactive dashboard:

                ⬢  S Y N T R I X

    Enterprise tools & AI studio for Flutter and Dart
    ──────────────────────────────────────────────────

    Quick Actions:

    • create    scaffold a new production-ready package
    • --audit   run automated audit checks
    • template  manage templates
    • plugin    manage plugins
    • --help    explore all commands

    ──────────────────────────────────────────────────
    v1.0.0    dart 3.5.0    flutter 3.24.0

3. Scaffold Your First Enterprise Package #

Create a new package with the interactive wizard:

syntrix create my_package

Or specify options directly:

syntrix create my_package --template=flutter_enterprise_package --org=com.syntrix --description="High-performance reactive caching layer for Flutter."

4. Run Package Health Audit #

Navigate to package directory:

cd my_package

Run automated package audit:

syntrix --audit

🛡️ Security & Engineering Safety #

Syntrix is engineered with defensive-by-default architecture, strict path sanitization, and a zero-telemetry privacy guarantee.

🔍 Plan-First Dry Run Previews

Destructive mutations always require explicit consent. Default operations execute in safe preview mode with zero unprompted disk writes.

🚫 Path Traversal & Injection Guards

Strict input sanitization normalizes absolute filepaths and neutralizes relative escaping attempts (e.g. ../ attacks).

🔒 100% Private & Zero Telemetry

Zero telemetry, analytics, or background tracking. Codebases, session memories, and API keys remain 100% local on your machine.

🧪 Hermetic Workspace Execution

Testing and audit sandboxes operate in isolated temporary workspaces without altering ambient environment variables or global SDK configs.

🧪 Testing & Quality Verification #

Every layer of Syntrix is verified by a deterministic automated test suite covering unit contracts, AST transformers, CLI runners, and AI prompt synthesizers.

📦 `flutter_package_studio_core` (350+ Tests)

DI & IoC Container: Transient & singleton dependency resolution
Template Engine: Token substitution & YAML schema validation
Audit Profiles: Multi-gate deterministic compliance engines
AI Subsystems: Grounded AST review, debug & plan generators

💻 `flutter_package_studio_cli` (50+ Tests)

Command Runner: Option parsing & custom help formatters
E2E Lifecycle: Scaffolding, dry-run previews & disk mutations
Exit Codes: Deterministic status codes across all gates
JSON Schema: Strict machine-readable output verification

Run All Workspace Tests #

dart test packages/flutter_package_studio_core packages/flutter_package_studio_cli

🤝 Contributing to Syntrix #

Contributions of all shapes and sizes are welcome! Whether you are designing new package templates, writing custom audit rules, or adding specialized AI capabilities.

1. Fork & Branch

Fork the repository and create your isolated feature branch:

git checkout -b feature/amazing-feature

2. Verify All Tests

Run the full automated test suite across all workspace packages:

dart test packages/flutter_package_studio_core packages/flutter_package_studio_cli

3. Commit Clean Changes

Follow standard conventional commit messages:

git commit -m 'feat: add amazing new feature'

4. Open Pull Request

Push your branch to GitHub and submit a PR for review:

git push origin feature/amazing-feature

📄 License #

┌────────────────────────────────────────────────────────────────────────────────────────┐
│  LICENSE: MIT                                                                          │
│  Copyright (c) 2026 Syntrix Authors. Free for personal and commercial usage.           │
│  See LICENSE file in root directory for full legal text.                               │
└────────────────────────────────────────────────────────────────────────────────────────┘

Crafted with ❤️ by Ashish Goswami

_{"Deterministic, resilient tools so Flutter developers can focus on creating extraordinary experiences."}

syntrix 1.3.2 syntrix: ^1.3.2 copied to clipboard

Metadata