Config llm

[Arjun544]

Summary by CodeRabbit

• New Features

  • Added AI-Ready Context feature to the landing page with visual styling
  • Made the wizard sidebar logo clickable for quick home navigation

• Documentation

  • Enhanced Flutter project documentation with new guide files (AGENTS.md, DESIGN.md)
  • Added Cursor AI rules template for improved IDE context and project conventions

• Improvements

  • Optimized statistics data fetching for better performance
  • Improved cache management for landing page updates

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
flutter-init	Ready	Preview, Comment	Jun 5, 2026 7:06pm

[coderabbitai]

Worried about impact? Review this PR in Change Stack to explore blast radius before you approve or request changes.

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 922bdb0d-9bc2-4c24-8031-4ac99d5d9503

📥 Commits

Reviewing files that changed from the base of the PR and between 248ec2e and 93b610b.

📒 Files selected for processing (26)

• app/api/track/route.ts
• app/components/landing/StatsSection.tsx
• app/components/landing/WhyFlutterInit.tsx
• app/components/wizard/WizardShell.tsx
• app/page.tsx
• docs/generated-output.md
• skills-lock.json
• templates/flutter/base/.cursor/rules/flutter-project.mdc.hbs
• templates/flutter/base/AGENTS.md.hbs
• templates/flutter/base/DESIGN.md.hbs
• templates/flutter/base/lib/src/imports/packages_imports.dart.hbs
• templates/flutter/partials/llm/add-feature-workflow.hbs
• templates/flutter/partials/llm/architecture-rules.hbs
• templates/flutter/partials/llm/backend-rules.hbs
• templates/flutter/partials/llm/build-runner-note.hbs
• templates/flutter/partials/llm/design-quick-ref.hbs
• templates/flutter/partials/llm/design-quick-reference.hbs
• templates/flutter/partials/llm/navigation-rules.hbs
• templates/flutter/partials/llm/networking-rules.hbs
• templates/flutter/partials/llm/packages-list.hbs
• templates/flutter/partials/llm/services-conventions.hbs
• templates/flutter/partials/llm/stack-summary.hbs
• templates/flutter/partials/llm/state-management-rules.hbs
• tests/unit/llm-context.spec.ts
• tests/unit/state-management.spec.ts
• tests/utils/assertions.ts

---

📝 Walkthrough

Walkthrough

Landing page caching now uses ISR invalidation after scaffold generation and Supabase-sourced stats. UI adds AI-Ready Context tile and clickable logo. A new Flutter template system generates LLM-context documentation (agent guides, design rules, architecture patterns) and Cursor rules, with extensive conditional partials covering five architectures, multiple state/navigation/backend options, and full test validation across configuration combinations.

Changes

Landing page caching and stats optimization

Layer / File(s)	Summary
ISR cache revalidation on generation app/api/track/route.ts, app/page.tsx	Track endpoint imports revalidatePath from next/cache and invalidates "/" immediately before responding. Page exports revalidate = 60 to enforce periodic re-rendering at most every 60 seconds, overriding static caching and ensuring stats remain fresh.
Stats data source migration to Supabase app/components/landing/StatsSection.tsx	getStats() refactored to query Supabase stats_summary table directly via publishable client instead of calling Vercel URL API route, returning typed data or null on query error.
Landing UI enhancements and navigation app/components/landing/WhyFlutterInit.tsx, app/components/wizard/WizardShell.tsx	WhyFlutterInit adds AI-Ready Context tile using new AiBrain01Icon and violet accent, updates bentoClasses for row 3 sizing, and adjusts wide-tile logic to indices 0–1. WizardShell logo wrapped in clickable Link navigation to home.

Flutter LLM context and Cursor rules generation system

Layer / File(s)	Summary
Cursor rules and agent guide templates templates/flutter/base/.cursor/rules/flutter-project.mdc.hbs, templates/flutter/base/AGENTS.md.hbs, templates/flutter/base/lib/src/imports/packages_imports.dart.hbs	New Cursor rules template with conditional documentation sections (architecture, backend, feature flags) and quick rules. AGENTS.md orchestrates llm/* partials (stack summary, architecture, state, navigation, backend, networking, services, packages, add-feature workflow) plus policy tables and hard limits. MobX export hiding extended to include Interceptor/Interceptors when Dio is present.
Design system documentation template templates/flutter/base/DESIGN.md.hbs	Comprehensive design conventions covering theme/Material 3 vs Cupertino, color system, typography, spacing/border/motion tokens, responsive layout (ScreenUtil and MediaQuery), context extensions, component/dark-mode/localization conventions, and consolidated Do/Don't guidelines.
Architecture and state management pattern partials templates/flutter/partials/llm/architecture-rules.hbs, templates/flutter/partials/llm/state-management-rules.hbs, templates/flutter/partials/llm/navigation-rules.hbs, templates/flutter/partials/llm/backend-rules.hbs	Architecture rules for Clean, Feature-First, MVC, MVVM, Layer-First with folder structure and dependency constraints. State management rules conditional on Riverpod, BLoC, Provider, GetX, MobX, or none. Navigation rules for go_router, auto_route, getx, or default. Backend rules for Firebase, Supabase, Appwrite, custom.
Supporting conventions and quick-reference partials templates/flutter/partials/llm/stack-summary.hbs, templates/flutter/partials/llm/services-conventions.hbs, templates/flutter/partials/llm/networking-rules.hbs, templates/flutter/partials/llm/packages-list.hbs, templates/flutter/partials/llm/design-quick-ref.hbs, templates/flutter/partials/llm/design-quick-reference.hbs, templates/flutter/partials/llm/add-feature-workflow.hbs, templates/flutter/partials/llm/build-runner-note.hbs	Stack summary renders architecture/state/navigation/backend/networking/storage/theme selections in table format. Services conventions define singleton patterns, FutureEither, and anti-patterns. Networking rules for Dio or HTTP with service-layer routing. Packages list conditionally includes router/state/backend/UI packages. Design quick-reference variants and add-feature workflow provide concise guidance and architecture-specific checklists. Build-runner note conditionally emits code generation instructions.
LLM context generation test suite tests/unit/llm-context.spec.ts, tests/unit/state-management.spec.ts	llm-context.spec.ts validates generation of AGENTS.md, DESIGN.md, and flutter-project.mdc across multiple configuration combos (Clean+Riverpod+Supabase+go_router, MVC+BLoC+Firebase, etc.), verifying architecture-specific content, conditional backend sections, ScreenUtil presence, primary color inclusion, Cursor rule frontmatter, build_runner conditionals, and token resolution. state-management.spec.ts adds MobX+Dio test confirming Interceptor export hiding.
Documentation and test infrastructure updates docs/generated-output.md, skills-lock.json, tests/utils/assertions.ts	Generated output docs reference AGENTS.md, DESIGN.md, and .cursor/rules/ as new root-level artifacts. Skills lock adds hallmark skill entry with GitHub source and computed hash. Test assertion helper extends ALWAYS_REQUIRED_FILES to enforce presence of new context files during validation.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related issues

• Arjun544/flutter_init#4: This PR directly implements the template audit and optimization work by adding comprehensive Handlebars templates and partials for all supported Flutter architectures (Clean, Feature-First, MVC, MVVM, Layer-First) with conditional rules and guidance.

Possibly related PRs

• Arjun544/flutter_init#39: Both PRs modify app/components/landing/StatsSection.tsx's getStats() logic; this PR switches the data source to a direct Supabase query while the referenced PR alters fetch caching/revalidation options.
• Arjun544/flutter_init#41: Both PRs modify the same landing UI components—app/components/landing/WhyFlutterInit.tsx (violet accent, AI-Ready Context, bento sizing) and app/components/wizard/WizardShell.tsx (clickable logo Link)—at the code level.
• Arjun544/flutter_init#27: Both PRs extend the /api/track POST handler flow; this PR adds revalidatePath ISR cache busting after Supabase generation_events insertion, directly building on the referenced PR's track endpoint implementation.

Poem

🐰 Behold the Flutter scaffold, now blessed with AI sight,
Cursor rules and AGENTS guide the builder through the night,
Five architectures bloom with conditional design so bright,
Stats now dance on Supabase, and caches burn just right—
From landing page to templates, the LLM learns to build it right! ✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch config_LLM

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}