Enhance Flutter project structure and UI components

[Arjun544]

• Added new 'hallmark' skill entry in skills-lock.json.
• Introduced AI-Ready Context feature in WhyFlutterInit component with corresponding UI adjustments.
• Updated WizardShell component to wrap logo in a link for better navigation.
• Documented new AGENTS.md and DESIGN.md files in generated output.
• Adjusted MobX imports to avoid ambiguous exports and added related tests for validation.

Summary by CodeRabbit

Release Notes

• New Features

  • Added "AI-Ready Context" tile to landing page with violet accent theme.
  • Made sidebar logo clickable for navigation.

• Documentation

  • Added comprehensive Flutter project documentation templates including developer guides, design system reference, and architecture-specific workflows.

• Tests

  • Added test coverage for documentation generation system.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
flutter-init	Ready	Preview, Comment	May 23, 2026 6:21pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0b4e8c24-6d35-46a5-a420-be12d9e8bc20

📥 Commits

Reviewing files that changed from the base of the PR and between 78c9aee and 1feaef3.

📒 Files selected for processing (23)

• app/components/landing/WhyFlutterInit.tsx
• app/components/wizard/WizardShell.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

This PR introduces comprehensive LLM context scaffolding for Flutter projects, enabling AI tools to understand and guide development within generated Flutter applications. It adds interactive landing page features, extensive Handlebars template system for documentation generation, and full test coverage validating the generated output.

Changes

LLM Context Documentation & Landing UI Enhancements

Layer / File(s)	Summary
Landing Page UI Enhancements app/components/landing/WhyFlutterInit.tsx, app/components/wizard/WizardShell.tsx	WhyFlutterInit adds a violet-themed "AI-Ready Context" tile featuring AiBrain01Icon to the bento grid; tile sizing logic now treats only indices 0 and 1 as wide. WizardShell imports Link from next/link and wraps the sidebar logo to make it navigable to /.
Core LLM Context Documentation Templates templates/flutter/base/.cursor/rules/flutter-project.mdc.hbs, templates/flutter/base/AGENTS.md.hbs, templates/flutter/base/DESIGN.md.hbs	Main Cursor rules template orchestrates partials to render stack summary, architecture, state management, navigation, backend, networking, services, design reference, and feature workflow. AGENTS.md composes similar sections with policy tables and hard limits. DESIGN.md provides theming, typography, spacing, responsive layout, and localization guidance; all use conditional rendering based on project configuration.
Reusable Documentation Partials templates/flutter/partials/llm/* (12 files)	Twelve Handlebars partials compose the documentation: add-feature-workflow, architecture-rules, backend-rules, build-runner-note, design-quick-ref, design-quick-reference, navigation-rules, networking-rules, packages-list, services-conventions, stack-summary, and state-management-rules. Each conditionally renders content based on selected architecture, state management, backend provider, routing package, and feature flags.
Supporting Code Changes & Configuration templates/flutter/base/lib/src/imports/packages_imports.dart.hbs, skills-lock.json, docs/generated-output.md	MobX export hides Interceptor and Interceptors to prevent conflicts with Dio. Hallmark skill added to lock file. Generated output documentation lists new guidance files (AGENTS.md, DESIGN.md, .cursor/rules/).
Test Coverage for LLM Context Generation tests/unit/llm-context.spec.ts, tests/unit/state-management.spec.ts, tests/utils/assertions.ts	Tests validate that AGENTS.md, DESIGN.md, and Cursor rules are generated consistently; verify stack-specific strings appear in documentation; check ScreenUtil, build_runner, backend, and RLS inclusion/exclusion based on configuration; assert Cursor rule YAML frontmatter and embedded context details; validate MobX + Dio import handling; require generated files in assertions.

🎯 4 (Complex) | ⏱️ ~60 minutes

A rabbit brings AI wisdom to Flutter's shore,
Partials compose, rules teach, docs explore,
With violet tiles and guidance galore,
Context flows freely—what could matter more? 🐰✨

✨ 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.}