# mubashranoor04/giggle-and-grow architecture

> Architecture diagram of the GitHub repository mubashranoor04/giggle-and-grow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mubashranoor04/giggle-and-grow
- Repository: https://github.com/mubashranoor04/giggle-and-grow

## Overview

Giggle and Grow is a Flutter educational app for children. Its documented capabilities include account access, learning activities, games, drawing, stories, and progress rewards. The file tree supports distinct feature paths, but no Dart source excerpts show runtime routing or feature-to-feature calls; those links are therefore omitted rather than inferred. Firebase services and feature details are described in the README, but their implementation wiring was not sampled.

Main entry points: [`lib/features/drawing/presentation/pages/drawing_canvas_screen.dart`](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/presentation/pages/drawing_canvas_screen.dart) (Drawing canvas), [`lib/main.dart`](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/main.dart) (Flutter entry), [`lib/features/authentication/presentation/pages`](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/authentication/presentation/pages) (Login and reset), [`lib/features/authentication/presentation/provider/auth_provider.dart`](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/presentation/provider/auth_provider.dart) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Entry"]
  node_app_entry["Flutter entry<br/>[main.dart]"]
  node_onboarding["Onboarding"]
end

subgraph group_access["Account Access"]
  node_login_pages["Login and reset"]
  node_auth_state["Auth state<br/>[auth_provider.dart]"]
  node_auth_usecases["Auth actions"]
  node_auth_repository["Auth repository"]
  node_auth_service["Firebase auth<br/>[auth_services.dart]"]
end

subgraph group_learning["Learning Activities"]
  node_learning_menu["Learning menu<br/>[learning_menu.dart]"]
  node_learning_topics["Learning topics"]
end

subgraph group_play["Play and Create"]
  node_games["Educational games"]
  node_drawing_canvas["Drawing canvas"]
  node_canvas_painter["Canvas painter"]
  node_drawing_repository["Drawing data"]
  node_drawing_remote["Drawing remote"]
end

subgraph group_progress["Stories and Progress"]
  node_stories["Story collection"]
  node_story_reader["Story reader"]
  node_dashboard["Progress dashboard"]
  node_score_state["Score state"]
  node_score_usecases["Score actions"]
  node_score_repository["Score repository"]
  node_score_service["Score service<br/>[score_service.dart]"]
end

node_child(("Child user"))
node_firebase[("Firebase services")]

node_child -.->|"opens"| node_app_entry
node_app_entry -.->|"starts"| node_onboarding
node_child -.->|"signs in"| node_login_pages
node_login_pages -.->|"updates"| node_auth_state
node_auth_state -.->|"requests"| node_auth_usecases
node_auth_usecases -.->|"delegates"| node_auth_repository
node_auth_repository -.->|"uses"| node_auth_service
node_auth_service -.->|"authenticates"| node_firebase
node_child -.->|"explores"| node_learning_menu
node_learning_menu -.->|"offers"| node_learning_topics
node_child -.->|"plays"| node_games
node_child -.->|"draws"| node_drawing_canvas
node_drawing_canvas -.->|"renders"| node_canvas_painter
node_drawing_canvas -.->|"uses"| node_drawing_repository
node_drawing_repository -.->|"delegates"| node_drawing_remote
node_child -.->|"browses"| node_stories
node_stories -.->|"opens"| node_story_reader
node_child -.->|"views progress"| node_dashboard
node_dashboard -.->|"shows"| node_score_state
node_score_state -.->|"requests"| node_score_usecases
node_score_usecases -.->|"delegates"| node_score_repository
node_score_repository -.->|"uses"| node_score_service
node_score_service -.->|"stores scores"| node_firebase

click node_app_entry "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/main.dart"
click node_onboarding "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/onboarding/presentation/pages"
click node_login_pages "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/authentication/presentation/pages"
click node_auth_state "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/presentation/provider/auth_provider.dart"
click node_auth_usecases "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/authentication/domain/usecase"
click node_auth_repository "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/data/repositoryImp/auth_repository_imp.dart"
click node_auth_service "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/data/services/remote/auth_services.dart"
click node_learning_menu "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/learning/presentation/pages/learning_menu.dart"
click node_learning_topics "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/learning/presentation/pages"
click node_games "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/games/presentation/pages"
click node_drawing_canvas "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/presentation/pages/drawing_canvas_screen.dart"
click node_canvas_painter "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/presentation/widgets/canvas_painter.dart"
click node_drawing_repository "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/data/repositories/drawing_repository_impl.dart"
click node_drawing_remote "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/data/datasources/drawing_remote_datasource.dart"
click node_stories "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/stories/presentation/pages/stories_list_page.dart"
click node_story_reader "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/stories/presentation/pages/story_reader_page.dart"
click node_dashboard "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/presentation/pages/home_dashboard.dart"
click node_score_state "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/presentation/provider/score_provider.dart"
click node_score_usecases "https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/dashboard/domain/usecase"
click node_score_repository "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/data/repository_impl/score_repository_impl.dart"
click node_score_service "https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/data/services/remote/score_service.dart"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_entry,node_onboarding,node_child toneBlue
class node_login_pages,node_auth_state,node_auth_usecases,node_auth_repository,node_auth_service,node_firebase toneAmber
class node_learning_menu,node_learning_topics toneMint
class node_games,node_drawing_canvas,node_canvas_painter,node_drawing_repository,node_drawing_remote toneRose
class node_stories,node_story_reader,node_dashboard,node_score_state,node_score_usecases,node_score_repository,node_score_service toneIndigo
```

## Components

### App Entry

- [Flutter entry](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/main.dart): `lib/main.dart`
- [Onboarding](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/onboarding/presentation/pages): `lib/features/onboarding/presentation/pages`

### Account Access

- [Login and reset](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/authentication/presentation/pages): `lib/features/authentication/presentation/pages`
- [Auth state](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/presentation/provider/auth_provider.dart): `lib/features/authentication/presentation/provider/auth_provider.dart`
- [Auth actions](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/authentication/domain/usecase): `lib/features/authentication/domain/usecase`
- [Auth repository](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/data/repositoryImp/auth_repository_imp.dart): `lib/features/authentication/data/repositoryImp/auth_repository_imp.dart`
- [Firebase auth](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/authentication/data/services/remote/auth_services.dart): `lib/features/authentication/data/services/remote/auth_services.dart`

### Learning Activities

- [Learning menu](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/learning/presentation/pages/learning_menu.dart): `lib/features/learning/presentation/pages/learning_menu.dart`
- [Learning topics](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/learning/presentation/pages): `lib/features/learning/presentation/pages`

### Play and Create

- [Educational games](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/games/presentation/pages): `lib/features/games/presentation/pages`
- [Drawing canvas](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/presentation/pages/drawing_canvas_screen.dart): `lib/features/drawing/presentation/pages/drawing_canvas_screen.dart`
- [Canvas painter](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/presentation/widgets/canvas_painter.dart): `lib/features/drawing/presentation/widgets/canvas_painter.dart`
- [Drawing data](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/data/repositories/drawing_repository_impl.dart): `lib/features/drawing/data/repositories/drawing_repository_impl.dart`
- [Drawing remote](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/drawing/data/datasources/drawing_remote_datasource.dart): `lib/features/drawing/data/datasources/drawing_remote_datasource.dart`

### Stories and Progress

- [Story collection](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/stories/presentation/pages/stories_list_page.dart): `lib/features/stories/presentation/pages/stories_list_page.dart`
- [Story reader](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/stories/presentation/pages/story_reader_page.dart): `lib/features/stories/presentation/pages/story_reader_page.dart`
- [Progress dashboard](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/presentation/pages/home_dashboard.dart): `lib/features/dashboard/presentation/pages/home_dashboard.dart`
- [Score state](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/presentation/provider/score_provider.dart): `lib/features/dashboard/presentation/provider/score_provider.dart`
- [Score actions](https://github.com/mubashranoor04/giggle-and-grow/tree/main/lib/features/dashboard/domain/usecase): `lib/features/dashboard/domain/usecase`
- [Score repository](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/data/repository_impl/score_repository_impl.dart): `lib/features/dashboard/data/repository_impl/score_repository_impl.dart`
- [Score service](https://github.com/mubashranoor04/giggle-and-grow/blob/main/lib/features/dashboard/data/services/remote/score_service.dart): `lib/features/dashboard/data/services/remote/score_service.dart`

### Other components

- **Child user**
- **Firebase services**

## Connections

- Child user → Flutter entry: opens
- Flutter entry → Onboarding: starts
- Child user → Login and reset: signs in
- Login and reset → Auth state: updates
- Auth state → Auth actions: requests
- Auth actions → Auth repository: delegates
- Auth repository → Firebase auth: uses
- Firebase auth → Firebase services: authenticates (evidence: `README.md`)
- Child user → Learning menu: explores (evidence: `README.md`)
- Learning menu → Learning topics: offers (evidence: `README.md`)
- Child user → Educational games: plays (evidence: `README.md`)
- Child user → Drawing canvas: draws (evidence: `README.md`)
- Drawing canvas → Canvas painter: renders
- Drawing canvas → Drawing data: uses
- Drawing data → Drawing remote: delegates
- Child user → Story collection: browses (evidence: `README.md`)
- Story collection → Story reader: opens (evidence: `README.md`)
- Child user → Progress dashboard: views progress (evidence: `README.md`)
- Progress dashboard → Score state: shows
- Score state → Score actions: requests
- Score actions → Score repository: delegates
- Score repository → Score service: uses
- Score service → Firebase services: stores scores (evidence: `README.md`)
