# luics415/dev-visualizer architecture

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

- Interactive diagram: https://gitdiagram.com/luics415/dev-visualizer
- Repository: https://github.com/luics415/dev-visualizer

## Overview

Dev Visualizer is a Spanish-language interactive learning atlas: learners browse technology collections, study animated concepts and chapters, follow integrated “En acción” cases, and consult a professional resource library. The graph follows those product stages and includes the shared navigation and scene-playback layers. Relationships are limited to README statements and imports or calls visible in the supplied excerpts and SOURCE INDEX; unsampled collection implementations are represented at the data-directory level.

Main entry points: [`src/components/concepts/StudyAtlasCollection.tsx`](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/StudyAtlasCollection.tsx) (Study atlas), [`src/components/concepts/ConceptCard.tsx`](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/ConceptCard.tsx) (Concept cards), [`src/app/[slug]/page.tsx`](https://github.com/luics415/dev-visualizer/blob/main/src/app/%5Bslug%5D/page.tsx) (Collection routes), [`src/components/visual/AnimatedConceptScene.tsx`](https://github.com/luics415/dev-visualizer/blob/main/src/components/visual/AnimatedConceptScene.tsx) (Animated scenes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routes["Learning routes"]
  node_route["Collection routes<br/>[page.tsx]"]
  node_action_page["Action cases"]
  node_library_route["Library route<br/>[page.tsx]"]
end

subgraph group_study["Study experience"]
  node_study_atlas["Study atlas"]
  node_library_index["Resource catalog"]
  node_concept_card["Concept cards<br/>[ConceptCard.tsx]"]
  node_chapter_nav["Chapter index"]
  node_primer["Collection primer"]
  node_library_invite["Library invitation"]
  node_scene["Animated scenes"]
  node_action_scenes["Case scenes"]
end

subgraph group_content["Learning content"]
  node_manifest["Route manifest"]
  node_collection_data["Collection content"]
  node_scene_factory["Scene factory"]
  node_references["Official references"]
  node_library_data["Library resources"]
  node_primer_data["Primer content"]
  node_scene_types["Scene types<br/>[conceptTypes.ts]"]
end

subgraph group_shared["Shared interface"]
  node_playback["Scene playback"]
  node_nav["Collection navigation<br/>[CollectionNav.tsx]"]
  node_reading_progress["Reading progress"]
  node_slugify["Chapter slugs<br/>[slugify.ts]"]
end

node_learner(("Learner"))

node_learner -->|"opens collection"| node_route
node_route -->|"renders study"| node_study_atlas
node_route -->|"renders case"| node_action_page
node_learner -->|"opens library"| node_library_route
node_library_route -->|"renders catalog"| node_library_index
node_study_atlas -->|"renders concepts"| node_concept_card
node_study_atlas -->|"renders chapters"| node_chapter_nav
node_study_atlas -->|"renders primer"| node_primer
node_study_atlas -->|"renders invite"| node_library_invite
node_concept_card -->|"renders scene"| node_scene
node_concept_card -->|"creates fallback"| node_scene_factory
node_concept_card -->|"loads references"| node_references
node_scene -->|"reads playback"| node_playback
node_action_page -->|"renders cases"| node_action_scenes
node_action_scenes -->|"uses playback"| node_playback
node_library_index -->|"reads resources"| node_library_data
node_nav -->|"resolves theme"| node_manifest
node_nav -->|"reads progress"| node_reading_progress
node_study_atlas -->|"reads collection"| node_manifest
node_study_atlas -.->|"uses concept content"| node_collection_data
node_primer -->|"renders primer data"| node_primer_data
node_chapter_nav -->|"creates anchors"| node_slugify
node_scene -->|"uses scene types"| node_scene_types
node_scene_factory -.->|"returns scene"| node_scene_types

click node_route "https://github.com/luics415/dev-visualizer/blob/main/src/app/%5Bslug%5D/page.tsx"
click node_study_atlas "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/StudyAtlasCollection.tsx"
click node_action_page "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/ExpandedActionPage.tsx"
click node_library_route "https://github.com/luics415/dev-visualizer/blob/main/src/app/libreria/page.tsx"
click node_library_index "https://github.com/luics415/dev-visualizer/blob/main/src/components/library/ProfessionalLibraryIndex.tsx"
click node_concept_card "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/ConceptCard.tsx"
click node_chapter_nav "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionChapters.tsx"
click node_primer "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionPrimer.tsx"
click node_library_invite "https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionLibraryInvite.tsx"
click node_scene "https://github.com/luics415/dev-visualizer/blob/main/src/components/visual/AnimatedConceptScene.tsx"
click node_playback "https://github.com/luics415/dev-visualizer/blob/main/src/components/visual/useScenePlayback.ts"
click node_action_scenes "https://github.com/luics415/dev-visualizer/blob/main/src/components/scenes/DistinctActionScene.tsx"
click node_nav "https://github.com/luics415/dev-visualizer/blob/main/src/components/navigation/CollectionNav.tsx"
click node_manifest "https://github.com/luics415/dev-visualizer/blob/main/src/data/collectionManifest.ts"
click node_collection_data "https://github.com/luics415/dev-visualizer/tree/main/src/data"
click node_scene_factory "https://github.com/luics415/dev-visualizer/blob/main/src/data/atlasConceptFactory.ts"
click node_references "https://github.com/luics415/dev-visualizer/blob/main/src/data/officialReferences.ts"
click node_library_data "https://github.com/luics415/dev-visualizer/blob/main/src/data/professionalLibrary.ts"
click node_primer_data "https://github.com/luics415/dev-visualizer/blob/main/src/data/collectionPrimers.ts"
click node_scene_types "https://github.com/luics415/dev-visualizer/blob/main/src/data/conceptTypes.ts"
click node_reading_progress "https://github.com/luics415/dev-visualizer/blob/main/src/hooks/useReadingProgress.ts"
click node_slugify "https://github.com/luics415/dev-visualizer/blob/main/src/lib/slugify.ts"

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_route,node_action_page,node_library_route toneBlue
class node_study_atlas,node_library_index,node_concept_card,node_chapter_nav,node_primer,node_library_invite,node_scene,node_action_scenes toneAmber
class node_manifest,node_collection_data,node_scene_factory,node_references,node_library_data,node_primer_data,node_scene_types toneMint
class node_playback,node_nav,node_reading_progress,node_slugify toneRose
class node_learner toneIndigo
```

## Components

### Learning routes

- [Collection routes](https://github.com/luics415/dev-visualizer/blob/main/src/app/%5Bslug%5D/page.tsx): `src/app/[slug]/page.tsx`
- [Action cases](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/ExpandedActionPage.tsx): `src/components/concepts/ExpandedActionPage.tsx`
- [Library route](https://github.com/luics415/dev-visualizer/blob/main/src/app/libreria/page.tsx): `src/app/libreria/page.tsx`

### Study experience

- [Study atlas](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/StudyAtlasCollection.tsx): `src/components/concepts/StudyAtlasCollection.tsx`
- [Resource catalog](https://github.com/luics415/dev-visualizer/blob/main/src/components/library/ProfessionalLibraryIndex.tsx): `src/components/library/ProfessionalLibraryIndex.tsx`
- [Concept cards](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/ConceptCard.tsx): `src/components/concepts/ConceptCard.tsx`
- [Chapter index](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionChapters.tsx): `src/components/concepts/CollectionChapters.tsx`
- [Collection primer](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionPrimer.tsx): `src/components/concepts/CollectionPrimer.tsx`
- [Library invitation](https://github.com/luics415/dev-visualizer/blob/main/src/components/concepts/CollectionLibraryInvite.tsx): `src/components/concepts/CollectionLibraryInvite.tsx`
- [Animated scenes](https://github.com/luics415/dev-visualizer/blob/main/src/components/visual/AnimatedConceptScene.tsx): `src/components/visual/AnimatedConceptScene.tsx`
- [Case scenes](https://github.com/luics415/dev-visualizer/blob/main/src/components/scenes/DistinctActionScene.tsx): `src/components/scenes/DistinctActionScene.tsx`

### Learning content

- [Route manifest](https://github.com/luics415/dev-visualizer/blob/main/src/data/collectionManifest.ts): `src/data/collectionManifest.ts`
- [Collection content](https://github.com/luics415/dev-visualizer/tree/main/src/data): `src/data`
- [Scene factory](https://github.com/luics415/dev-visualizer/blob/main/src/data/atlasConceptFactory.ts): `src/data/atlasConceptFactory.ts`
- [Official references](https://github.com/luics415/dev-visualizer/blob/main/src/data/officialReferences.ts): `src/data/officialReferences.ts`
- [Library resources](https://github.com/luics415/dev-visualizer/blob/main/src/data/professionalLibrary.ts): `src/data/professionalLibrary.ts`
- [Primer content](https://github.com/luics415/dev-visualizer/blob/main/src/data/collectionPrimers.ts): `src/data/collectionPrimers.ts`
- [Scene types](https://github.com/luics415/dev-visualizer/blob/main/src/data/conceptTypes.ts): `src/data/conceptTypes.ts`

### Shared interface

- [Scene playback](https://github.com/luics415/dev-visualizer/blob/main/src/components/visual/useScenePlayback.ts): `src/components/visual/useScenePlayback.ts`
- [Collection navigation](https://github.com/luics415/dev-visualizer/blob/main/src/components/navigation/CollectionNav.tsx): `src/components/navigation/CollectionNav.tsx`
- [Reading progress](https://github.com/luics415/dev-visualizer/blob/main/src/hooks/useReadingProgress.ts): `src/hooks/useReadingProgress.ts`
- [Chapter slugs](https://github.com/luics415/dev-visualizer/blob/main/src/lib/slugify.ts): `src/lib/slugify.ts`

### Other components

- **Learner**

## Connections

- Learner → Collection routes: opens collection (evidence: `README.md`)
- Collection routes → Study atlas: renders study (evidence: `src/app/[slug]/page.tsx`)
- Collection routes → Action cases: renders case (evidence: `src/app/[slug]/page.tsx`)
- Learner → Library route: opens library (evidence: `README.md`)
- Library route → Resource catalog: renders catalog (evidence: `src/app/libreria/page.tsx`)
- Study atlas → Concept cards: renders concepts (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Study atlas → Chapter index: renders chapters (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Study atlas → Collection primer: renders primer (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Study atlas → Library invitation: renders invite (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Concept cards → Animated scenes: renders scene (evidence: `src/components/concepts/ConceptCard.tsx`)
- Concept cards → Scene factory: creates fallback (evidence: `src/components/concepts/ConceptCard.tsx`)
- Concept cards → Official references: loads references (evidence: `src/components/concepts/ConceptCard.tsx`)
- Animated scenes → Scene playback: reads playback (evidence: `src/components/visual/AnimatedConceptScene.tsx`)
- Action cases → Case scenes: renders cases (evidence: `src/components/concepts/ExpandedActionPage.tsx`)
- Case scenes → Scene playback: uses playback (evidence: `src/components/scenes/DistinctActionScene.tsx`)
- Resource catalog → Library resources: reads resources (evidence: `src/components/library/ProfessionalLibraryIndex.tsx`)
- Collection navigation → Route manifest: resolves theme (evidence: `src/components/navigation/CollectionNav.tsx`)
- Collection navigation → Reading progress: reads progress (evidence: `src/components/navigation/CollectionNav.tsx`)
- Study atlas → Route manifest: reads collection (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Study atlas → Collection content: uses concept content (evidence: `src/components/concepts/StudyAtlasCollection.tsx`)
- Collection primer → Primer content: renders primer data (evidence: `src/components/concepts/CollectionPrimer.tsx`)
- Chapter index → Chapter slugs: creates anchors (evidence: `src/components/concepts/CollectionChapters.tsx`)
- Animated scenes → Scene types: uses scene types (evidence: `src/components/visual/AnimatedConceptScene.tsx`)
- Scene factory → Scene types: returns scene
