Flutter 3 & Riverpod / Dart CLAUDE.md Generator | Free & Offline

Production-grade architectural rulebook for Flutter 3 & Riverpod / Dart. Engineered to eliminate LLM hallucinations, enforce strict deterministic conventions, and prevent architectural drift across Cursor IDE, Claude Code CLI, and autonomous multi-agent pipelines.

Target Path
CLAUDE.md
Execution Scope
Root Workspace Context
Specification Format
Project Memory (.md)
AI Tool Support
Claude Code & Agent Workflows
02 / DRIFT ANALYSIS & VALUE PROPOSITION

Failure Patterns Prevented for Flutter 3 & Riverpod / Dart

Without This Rule (Default LLM Behavior)Vulnerable

Flutter 3 and Dart 3 introduce records, pattern matching, sealed classes, and Riverpod 2 code generation (@riverpod). AI models routinely emit obsolete setState() spaghetti, mutable widget state, un-const constructors, and legacy Riverpod syntax.

Hallucination Symptoms
  • Invokes deprecated or removed APIs from older model training weights
  • Generates conflicting configuration files and invalid imports
  • Silently drops type-safety, boundaries, or transaction isolation
With This Rule (Guaranteed Invariants)Deterministic
Always add const constructors wherever possible to maximize Flutter element rebuild caching.
Use Riverpod 2 with code generation (@riverpod / NotifierProvider) or BLoC; ban raw mutable setState() in business logic.
Leverage Dart 3 pattern matching and sealed classes for exhaustive state and error representation.
Enforce sound null safety: avoid force-unwrapping with ! unless proven non-null by a preceding guard clause.
Separate presentation UI widgets from asynchronous repository and API service layers.
03 / VERIFIED CODE PATTERNS

Code Standards: Anti-Pattern vs Verified Implementation

Discouraged Anti-Pattern
// Discouraged: Mutable setState with force-unwrap and missing const
class BadProfile extends StatefulWidget {
  @override
  _BadProfileState createState() => _BadProfileState();
}
class _BadProfileState extends State<BadProfile> {
  var user;
  void load() async {
    user = await fetchUser();
    setState(() {});
  }
  @override
  Widget build(BuildContext context) {
    return Container(child: Text(user!.name)); // Runtime crash if null!
  }
}
Verified Production Standard
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

@immutable
sealed class ViewState<T> {
  const ViewState();
}
class Loading<T> extends ViewState<T> { const Loading(); }
class Success<T> extends ViewState<T> { final T data; const Success(this.data); }
class Failure<T> extends ViewState<T> { final String message; const Failure(this.message); }

class ProfileView extends ConsumerWidget {
  const ProfileView({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(profileProvider);
    return Scaffold(
      appBar: AppBar(title: const Text('Profile')),
      body: switch (state) {
        Loading() => const Center(child: CircularProgressIndicator.adaptive()),
        Success(:final data) => Center(child: Text('Welcome, ${data.name}')),
        Failure(:final message) => Center(child: Text('Error: $message')),
      },
    );
  }
}
04 / REPOSITORY PLACEMENT & 3-STEP TERMINAL INSTALLATION

How to Install Flutter 3 & Riverpod / Dart CLAUDE.md Repository Guidelines via Terminal

1

Step 1: Open Project Directory & Verify Target Placement

Open your terminal and navigate to your project root folder where the CLAUDE.md file will reside. Ensure the file is placed at the exact path below relative to your project root so the AI engine automatically loads it:

CLAUDE.md
2

Step 2: Fetch Rule File via Terminal Command

Run curl, PowerShell, or wget to stream the rule directly from the DevScratchpad raw API endpoint and write it to CLAUDE.md:

Terminal One-Liner Install

Run directly in your project root to stream and write this rule file with one command.

Raw API Stream
$curl -fsSL "https://www.devscratchpad.tech/api/raw/claude-md/flutter-dart" -o "CLAUDE.md"
3

Step 3: Verify and Activate with AI Agent

Launch your AI coding assistant (Claude Code & Agent Workflows). The assistant will automatically discover CLAUDE.md in your repository and apply the architectural guardrails, type constraints, and verification protocols during code generation.

05 / ROUTE DIRECTORY & CROSS-TOOLING
Format Pillar HubComprehensive Manual

CLAUDE.md Repository Guidelines Directory

Inspect the complete specification manual, glob patterns, directory rules, and all available presets in our central directory.

/claude-md Directory
06 / FREQUENTLY ASKED QUESTIONS

Technical FAQ: Flutter 3 & Riverpod / Dart AI Rulebooks

Does this rulebook support Riverpod 2 and BLoC?

Yes, it provides architecture rules for both modern code-generated Riverpod and idiomatic BLoC/Cubit event streams.

Why does it require const constructors?

In Flutter, const widgets short-circuit the rebuild tree, providing substantial UI frame-rate gains especially on mobile devices.