Description

This PR restructures the State Management section under the Flutter Concepts category. It splits the content into two distinct guides (Beginner and Advanced) and refactors both guides to standardize on the Single State + Enum Pattern as the recommended industry best practice.

Changes Made

📁 Reorganization & Sidebar Styling

• Nested Subcategory: Created the src/content/docs/flutter-concepts/state-management/ directory and added a _meta.yml configuration to define the sidebar group.
• Custom CSS Overrides: Modified src/styles/custom.css to make nested sidebar group headers normal font-weight and match the style/color of regular article links.
• Clean up: Deleted the old flat file state-management-with-flutter.mdx.

📄 Beginner Guide: State Management in Flutter

• Created beginner.mdx based on the Medium article on BLoC Single State concepts.
• Explains BLoC philosophy, highlights the multi-class state anti-pattern, and demonstrates the Single State + Enum pattern.
• Relocated the BLoC Event Diagram to this guide (where BLoC is introduced).

📄 Advanced Guide: Advanced State Management (BLoC)

• Created advanced.mdx by adapting the weather app BLoC tutorial.
• Intro Streamlining: Simplified the introduction to reference the beginner guide, removing duplicate paragraphs about BLoC background and diagrams.
• Code Refactoring: Rewrote the weather tutorial code snippets to use the Single State + Enum pattern instead of multi-class states:
  • Implemented WeatherStatus enum and a single WeatherState class.
  • Updated WeatherBloc event handlers to emit copied states.
  • Updated WeatherView UI widget wiring to retain weather data in memory during background refreshes.

Verification

• Verified that all MDX paths and file configuration headers are structurally sound.
• Validated hot reloading and page layouts on the local Astro dev server.