# joharyrakotoson/joharyportfolio architecture

> Architecture diagram of the GitHub repository joharyrakotoson/joharyportfolio, 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/joharyrakotoson/joharyportfolio
- Repository: https://github.com/joharyrakotoson/joharyportfolio

## Overview

This repository implements a bilingual personal portfolio: visitors browse a hero and profile, skills, projects, education and experience, then can submit a contact message. AppShell supplies the language-specific content across the page, while the contact form posts to an API route. Project detail, metadata and footer capabilities are included. The graph follows imports and calls shown in the excerpts and source index; unsampled section and API internals limit further relationship detail.

Main entry points: [`app/page.tsx`](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/page.tsx) (Page composition), [`app/AppShell.tsx`](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/AppShell.tsx) (Language shell), [`app/section/Home.tsx`](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Home.tsx) (Hero section), [`app/section/Contact.tsx`](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Contact.tsx) (Contact section)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio shell"]
  node_page["Page composition<br/>[page.tsx]"]
  node_shell["Language shell<br/>[AppShell.tsx]"]
  node_header["Site header<br/>[Header.tsx]"]
  node_footer["Site footer<br/>[Footer.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_fr["French content<br/>[index.tsx]"]
  node_en["English content<br/>[index.en.tsx]"]
  node_hero["Hero section<br/>[Home.tsx]"]
  node_about["About section<br/>[About.tsx]"]
  node_skills["Skills section<br/>[Skills.tsx]"]
  node_education["Education section<br/>[Education.tsx]"]
  node_experience["Experience section<br/>[Experience.tsx]"]
end

subgraph group_projects["Project showcase"]
  node_projects["Projects section<br/>[Projects.tsx]"]
  node_carousel["Project carousel"]
  node_projectcard["Project card<br/>[ProjectCard.tsx]"]
  node_projectmodal["Project details<br/>[ProjectModal.tsx]"]
end

subgraph group_contact["Contact"]
  node_contactsection["Contact section<br/>[Contact.tsx]"]
  node_contactinfo["Contact information<br/>[ContactInfo.tsx]"]
  node_contactform["Contact form<br/>[ContactForm.tsx]"]
  node_formlogic["Form submission<br/>[useContactForm.ts]"]
  node_api["Contact endpoint<br/>[route.ts]"]
end

subgraph group_shared["Shared presentation"]
  node_ui["UI components<br/>[Button.tsx]"]
  node_heroassets["Hero visuals<br/>[HeroBackground.tsx]"]
  node_marquee["Skills marquee<br/>[SkillsMarquee.tsx]"]
  node_modalparts["Modal content parts<br/>[ModalBody.tsx]"]
  node_metadata["Site metadata<br/>[site.ts]"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_page
node_page -->|"renders"| node_hero
node_page -->|"renders"| node_about
node_page -->|"renders"| node_skills
node_page -->|"renders"| node_projects
node_page -->|"renders"| node_education
node_page -->|"renders"| node_experience
node_page -->|"renders"| node_contactsection
node_shell -->|"renders"| node_header
node_shell -->|"renders"| node_footer
node_shell -->|"selects language data"| node_fr
node_shell -->|"selects language data"| node_en
node_hero -->|"renders"| node_heroassets
node_hero -->|"renders"| node_marquee
node_hero -.->|"reads content"| node_fr
node_projects -.->|"renders"| node_carousel
node_carousel -->|"renders"| node_projectcard
node_projectcard -.->|"opens details"| node_projectmodal
node_projectmodal -->|"renders"| node_modalparts
node_contactsection -->|"renders"| node_contactinfo
node_contactsection -->|"renders"| node_contactform
node_contactform -->|"uses handler"| node_formlogic
node_formlogic -->|"POSTs message"| node_api
node_contactinfo -->|"uses buttons"| node_ui
node_header -->|"uses buttons"| node_ui
node_footer -->|"uses buttons"| node_ui
node_page -->|"reads metadata"| node_metadata

click node_page "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/page.tsx"
click node_shell "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/AppShell.tsx"
click node_header "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/layout/Header.tsx"
click node_footer "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/layout/Footer.tsx"
click node_fr "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/data/index.tsx"
click node_en "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/data/index.en.tsx"
click node_hero "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Home.tsx"
click node_about "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/About.tsx"
click node_skills "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Skills.tsx"
click node_education "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Education.tsx"
click node_experience "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Experience.tsx"
click node_projects "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Projects.tsx"
click node_carousel "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/ProjectCarousel.tsx"
click node_projectcard "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Project/ProjectCard.tsx"
click node_projectmodal "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Modal/ProjectModal.tsx"
click node_contactsection "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Contact.tsx"
click node_contactinfo "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Contact/ContactInfo.tsx"
click node_contactform "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Contact/ContactForm.tsx"
click node_formlogic "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/lib/useContactForm.ts"
click node_api "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/api/contact/route.ts"
click node_ui "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/ui/Button.tsx"
click node_heroassets "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Hero/HeroBackground.tsx"
click node_marquee "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Hero/SkillsMarquee.tsx"
click node_modalparts "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Modal/ModalBody.tsx"
click node_metadata "https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/lib/site.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_page,node_shell,node_header,node_footer toneBlue
class node_fr,node_en,node_hero,node_about,node_skills,node_education,node_experience toneAmber
class node_projects,node_carousel,node_projectcard,node_projectmodal toneMint
class node_contactsection,node_contactinfo,node_contactform,node_formlogic,node_api toneRose
class node_ui,node_heroassets,node_marquee,node_modalparts,node_metadata,node_visitor toneIndigo
```

## Components

### Portfolio shell

- [Page composition](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Language shell](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/AppShell.tsx): `app/AppShell.tsx`
- [Site header](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/layout/Header.tsx): `app/layout/Header.tsx`
- [Site footer](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/layout/Footer.tsx): `app/layout/Footer.tsx`

### Portfolio content

- [French content](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/data/index.tsx): `app/data/index.tsx`
- [English content](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/data/index.en.tsx): `app/data/index.en.tsx`
- [Hero section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Home.tsx): `app/section/Home.tsx`
- [About section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/About.tsx): `app/section/About.tsx`
- [Skills section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Skills.tsx): `app/section/Skills.tsx`
- [Education section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Education.tsx): `app/section/Education.tsx`
- [Experience section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Experience.tsx): `app/section/Experience.tsx`

### Project showcase

- [Projects section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Projects.tsx): `app/section/Projects.tsx`
- [Project carousel](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/ProjectCarousel.tsx): `app/section/ProjectCarousel.tsx`
- [Project card](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Project/ProjectCard.tsx): `app/components/Project/ProjectCard.tsx`
- [Project details](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Modal/ProjectModal.tsx): `app/components/Modal/ProjectModal.tsx`

### Contact

- [Contact section](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/section/Contact.tsx): `app/section/Contact.tsx`
- [Contact information](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Contact/ContactInfo.tsx): `app/components/Contact/ContactInfo.tsx`
- [Contact form](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Contact/ContactForm.tsx): `app/components/Contact/ContactForm.tsx`
- [Form submission](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/lib/useContactForm.ts): `app/lib/useContactForm.ts`
- [Contact endpoint](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/api/contact/route.ts): `app/api/contact/route.ts`

### Shared presentation

- [UI components](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/ui/Button.tsx): `app/components/ui/Button.tsx`
- [Hero visuals](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Hero/HeroBackground.tsx): `app/components/Hero/HeroBackground.tsx`
- [Skills marquee](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Hero/SkillsMarquee.tsx): `app/components/Hero/SkillsMarquee.tsx`
- [Modal content parts](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/components/Modal/ModalBody.tsx): `app/components/Modal/ModalBody.tsx`
- [Site metadata](https://github.com/joharyrakotoson/joharyportfolio/blob/main/app/lib/site.ts): `app/lib/site.ts`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → Page composition: opens (evidence: `app/page.tsx`)
- Page composition → Hero section: renders (evidence: `app/page.tsx`)
- Page composition → About section: renders (evidence: `app/page.tsx`)
- Page composition → Skills section: renders (evidence: `app/page.tsx`)
- Page composition → Projects section: renders (evidence: `app/page.tsx`)
- Page composition → Education section: renders (evidence: `app/page.tsx`)
- Page composition → Experience section: renders (evidence: `app/page.tsx`)
- Page composition → Contact section: renders (evidence: `app/page.tsx`)
- Language shell → Site header: renders (evidence: `app/AppShell.tsx`)
- Language shell → Site footer: renders (evidence: `app/AppShell.tsx`)
- Language shell → French content: selects language data (evidence: `app/AppShell.tsx`)
- Language shell → English content: selects language data (evidence: `app/AppShell.tsx`)
- Hero section → Hero visuals: renders (evidence: `app/section/Home.tsx`)
- Hero section → Skills marquee: renders (evidence: `app/section/Home.tsx`)
- Hero section → French content: reads content
- Projects section → Project carousel: renders
- Project carousel → Project card: renders (evidence: `app/section/ProjectCarousel.tsx`)
- Project card → Project details: opens details
- Project details → Modal content parts: renders (evidence: `app/components/Modal/ProjectModal.tsx`)
- Contact section → Contact information: renders (evidence: `app/section/Contact.tsx`)
- Contact section → Contact form: renders (evidence: `app/section/Contact.tsx`)
- Contact form → Form submission: uses handler (evidence: `app/components/Contact/ContactForm.tsx`)
- Form submission → Contact endpoint: POSTs message (evidence: `app/lib/useContactForm.ts`)
- Contact information → UI components: uses buttons (evidence: `app/components/Contact/ContactInfo.tsx`)
- Site header → UI components: uses buttons (evidence: `app/layout/Header.tsx`)
- Site footer → UI components: uses buttons (evidence: `app/layout/Footer.tsx`)
- Page composition → Site metadata: reads metadata (evidence: `app/page.tsx`)
