# aminedevf/devcraft architecture

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

- Interactive diagram: https://gitdiagram.com/aminedevf/devcraft
- Repository: https://github.com/aminedevf/devcraft

## Overview

This repository is a Next.js agency showcase site. A visitor reaches the shared layout, then the home page presents studio identity, featured work, a history timeline, and contact and newsletter forms. The contact form validates entries but simulates submission locally; no backend or persistence is evidenced. The graph preserves the central UI primitives and toast utilities named as core modules. Several page sections and integrations are unsampled, so their internal behavior and connections are not inferred.

Main entry points: [`app/page.tsx`](https://github.com/aminedevf/devcraft/blob/main/app/page.tsx) (Home page), [`app/components/Contact.tsx`](https://github.com/aminedevf/devcraft/blob/main/app/components/Contact.tsx) (Contact section), [`app/components/ContactForm.tsx`](https://github.com/aminedevf/devcraft/blob/main/app/components/ContactForm.tsx) (Contact form), [`app/layout.tsx`](https://github.com/aminedevf/devcraft/blob/main/app/layout.tsx) (Shared layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site shell"]
  node_layout["Shared layout<br/>[layout.tsx]"]
  node_header["Header<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_home["Home page<br/>[page.tsx]"]
end

subgraph group_story["Studio showcase"]
  node_hero["Hero<br/>[Hero.tsx]"]
  node_about["Studio story<br/>[WearYourStory.tsx]"]
  node_features["Feature carousel"]
  node_portfolio["Portfolio grid<br/>[PortfolioGrid.tsx]"]
  node_timeline["Studio timeline<br/>[Timeline.tsx]"]
  node_marquee["Marquee<br/>[Marquee.tsx]"]
end

subgraph group_engage["Visitor engagement"]
  node_contact["Contact form<br/>[ContactForm.tsx]"]
  node_newsletter["Newsletter signup"]
  node_contact_section["Contact section<br/>[Contact.tsx]"]
end

subgraph group_ui["UI foundations"]
  node_button["Button primitive<br/>[button.tsx]"]
  node_input["Input primitive<br/>[input.tsx]"]
  node_textarea["Textarea primitive<br/>[textarea.tsx]"]
  node_form["Form primitives<br/>[form.tsx]"]
  node_toast["Toast utilities<br/>[use-toast.ts]"]
  node_toast_view["Toast rendering<br/>[toast.tsx]"]
  node_ui_misc["Other UI primitives"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_layout
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_home
node_layout -->|"renders"| node_footer
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_home -->|"renders"| node_features
node_home -->|"renders"| node_portfolio
node_home -->|"renders"| node_timeline
node_home -->|"renders"| node_marquee
node_home -->|"renders"| node_contact
node_home -->|"renders"| node_newsletter
node_contact -->|"uses fields"| node_form
node_contact -->|"renders"| node_input
node_contact -->|"renders"| node_textarea
node_contact -->|"renders"| node_button
node_newsletter -->|"renders"| node_input
node_newsletter -->|"renders"| node_button
node_contact_section -->|"uses"| node_input
node_contact_section -->|"uses"| node_textarea
node_contact_section -->|"uses"| node_button
node_contact_section -->|"uses"| node_form
node_contact_section -->|"uses"| node_toast
node_toast -->|"uses"| node_toast_view

click node_layout "https://github.com/aminedevf/devcraft/blob/main/app/layout.tsx"
click node_header "https://github.com/aminedevf/devcraft/blob/main/app/components/Header.tsx"
click node_footer "https://github.com/aminedevf/devcraft/blob/main/app/components/Footer.tsx"
click node_home "https://github.com/aminedevf/devcraft/blob/main/app/page.tsx"
click node_hero "https://github.com/aminedevf/devcraft/blob/main/app/components/Hero.tsx"
click node_about "https://github.com/aminedevf/devcraft/blob/main/app/components/WearYourStory.tsx"
click node_features "https://github.com/aminedevf/devcraft/blob/main/app/components/FeatureCarousel.tsx"
click node_portfolio "https://github.com/aminedevf/devcraft/blob/main/app/components/PortfolioGrid.tsx"
click node_timeline "https://github.com/aminedevf/devcraft/blob/main/app/components/Timeline.tsx"
click node_marquee "https://github.com/aminedevf/devcraft/blob/main/app/components/Marquee.tsx"
click node_contact "https://github.com/aminedevf/devcraft/blob/main/app/components/ContactForm.tsx"
click node_newsletter "https://github.com/aminedevf/devcraft/blob/main/app/components/NewsletterSubscribe.tsx"
click node_contact_section "https://github.com/aminedevf/devcraft/blob/main/app/components/Contact.tsx"
click node_button "https://github.com/aminedevf/devcraft/blob/main/components/ui/button.tsx"
click node_input "https://github.com/aminedevf/devcraft/blob/main/components/ui/input.tsx"
click node_textarea "https://github.com/aminedevf/devcraft/blob/main/components/ui/textarea.tsx"
click node_form "https://github.com/aminedevf/devcraft/blob/main/components/ui/form.tsx"
click node_toast "https://github.com/aminedevf/devcraft/blob/main/components/ui/use-toast.ts"
click node_toast_view "https://github.com/aminedevf/devcraft/blob/main/components/ui/toast.tsx"
click node_ui_misc "https://github.com/aminedevf/devcraft/tree/main/components/ui"

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_layout,node_header,node_footer,node_home toneBlue
class node_hero,node_about,node_features,node_portfolio,node_timeline,node_marquee toneAmber
class node_contact,node_newsletter,node_contact_section toneMint
class node_button,node_input,node_textarea,node_form,node_toast,node_toast_view,node_ui_misc toneRose
class node_visitor toneIndigo
```

## Components

### Site shell

- [Shared layout](https://github.com/aminedevf/devcraft/blob/main/app/layout.tsx): `app/layout.tsx`
- [Header](https://github.com/aminedevf/devcraft/blob/main/app/components/Header.tsx): `app/components/Header.tsx`
- [Footer](https://github.com/aminedevf/devcraft/blob/main/app/components/Footer.tsx): `app/components/Footer.tsx`
- [Home page](https://github.com/aminedevf/devcraft/blob/main/app/page.tsx): `app/page.tsx`

### Studio showcase

- [Hero](https://github.com/aminedevf/devcraft/blob/main/app/components/Hero.tsx): `app/components/Hero.tsx`
- [Studio story](https://github.com/aminedevf/devcraft/blob/main/app/components/WearYourStory.tsx): `app/components/WearYourStory.tsx`
- [Feature carousel](https://github.com/aminedevf/devcraft/blob/main/app/components/FeatureCarousel.tsx): `app/components/FeatureCarousel.tsx`
- [Portfolio grid](https://github.com/aminedevf/devcraft/blob/main/app/components/PortfolioGrid.tsx): `app/components/PortfolioGrid.tsx`
- [Studio timeline](https://github.com/aminedevf/devcraft/blob/main/app/components/Timeline.tsx): `app/components/Timeline.tsx`
- [Marquee](https://github.com/aminedevf/devcraft/blob/main/app/components/Marquee.tsx): `app/components/Marquee.tsx`

### Visitor engagement

- [Contact form](https://github.com/aminedevf/devcraft/blob/main/app/components/ContactForm.tsx): `app/components/ContactForm.tsx`
- [Newsletter signup](https://github.com/aminedevf/devcraft/blob/main/app/components/NewsletterSubscribe.tsx): `app/components/NewsletterSubscribe.tsx`
- [Contact section](https://github.com/aminedevf/devcraft/blob/main/app/components/Contact.tsx): `app/components/Contact.tsx`

### UI foundations

- [Button primitive](https://github.com/aminedevf/devcraft/blob/main/components/ui/button.tsx): `components/ui/button.tsx`
- [Input primitive](https://github.com/aminedevf/devcraft/blob/main/components/ui/input.tsx): `components/ui/input.tsx`
- [Textarea primitive](https://github.com/aminedevf/devcraft/blob/main/components/ui/textarea.tsx): `components/ui/textarea.tsx`
- [Form primitives](https://github.com/aminedevf/devcraft/blob/main/components/ui/form.tsx): `components/ui/form.tsx`
- [Toast utilities](https://github.com/aminedevf/devcraft/blob/main/components/ui/use-toast.ts): `components/ui/use-toast.ts`
- [Toast rendering](https://github.com/aminedevf/devcraft/blob/main/components/ui/toast.tsx): `components/ui/toast.tsx`
- [Other UI primitives](https://github.com/aminedevf/devcraft/tree/main/components/ui): `components/ui`

### Other components

- **Visitor**

## Connections

- Visitor → Shared layout: opens site
- Shared layout → Header: renders (evidence: `app/layout.tsx`)
- Shared layout → Home page: renders (evidence: `app/layout.tsx`)
- Shared layout → Footer: renders (evidence: `app/layout.tsx`)
- Home page → Hero: renders (evidence: `app/page.tsx`)
- Home page → Studio story: renders (evidence: `app/page.tsx`)
- Home page → Feature carousel: renders (evidence: `app/page.tsx`)
- Home page → Portfolio grid: renders (evidence: `app/page.tsx`)
- Home page → Studio timeline: renders (evidence: `app/page.tsx`)
- Home page → Marquee: renders (evidence: `app/page.tsx`)
- Home page → Contact form: renders (evidence: `app/page.tsx`)
- Home page → Newsletter signup: renders (evidence: `app/page.tsx`)
- Contact form → Form primitives: uses fields (evidence: `app/components/ContactForm.tsx`)
- Contact form → Input primitive: renders (evidence: `app/components/ContactForm.tsx`)
- Contact form → Textarea primitive: renders (evidence: `app/components/ContactForm.tsx`)
- Contact form → Button primitive: renders (evidence: `app/components/ContactForm.tsx`)
- Newsletter signup → Input primitive: renders (evidence: `app/components/NewsletterSubscribe.tsx`)
- Newsletter signup → Button primitive: renders (evidence: `app/components/NewsletterSubscribe.tsx`)
- Contact section → Input primitive: uses (evidence: `app/components/Contact.tsx`)
- Contact section → Textarea primitive: uses (evidence: `app/components/Contact.tsx`)
- Contact section → Button primitive: uses (evidence: `app/components/Contact.tsx`)
- Contact section → Form primitives: uses (evidence: `app/components/Contact.tsx`)
- Contact section → Toast utilities: uses (evidence: `app/components/Contact.tsx`)
- Toast utilities → Toast rendering: uses (evidence: `components/ui/use-toast.ts`)
