# hey-ashik/makeportfolio architecture

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

- Interactive diagram: https://gitdiagram.com/hey-ashik/makeportfolio
- Repository: https://github.com/hey-ashik/makeportfolio

## Overview

Make Portfolio is a multi-tenant portfolio builder: visitors claim a username, create and verify an account, connect a site URL to provision a template copy, then edit and publish that portfolio from an admin dashboard. Public pages render each user’s content, with contact messages and media served through app routes. The README documents the end-to-end flow and major features; route excerpts confirm several API-to-storage relationships. Other admin and rendering internals are represented by their exact enclosing directories because their source was not sampled.

Main entry points: [`frontend/src/lib/content/store.ts`](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/content/store.ts) (Content storage), [`frontend/src/lib/account/store.ts`](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/account/store.ts) (Account storage), [`frontend/src/app/api/auth`](https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/api/auth) (Sign up / login), [`frontend/src/app/(site)/[username]`](https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/(site)/%5Busername%5D) (Portfolio pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_onboarding["Discovery &amp; accounts"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_username["Username check<br/>[route.ts]"]
  node_signup["Sign up / login"]
  node_verification["Email verification<br/>[route.ts]"]
end

subgraph group_admin["Portfolio management"]
  node_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_adminapi["Admin APIs"]
  node_adminservice["Admin service<br/>[server.ts]"]
end

subgraph group_publishing["Public portfolio"]
  node_contentapi["Public content API<br/>[route.ts]"]
  node_portfolio["Portfolio pages"]
  node_live["Live updates<br/>[route.ts]"]
  node_contact["Contact form API<br/>[route.ts]"]
  node_mediaroute["Media delivery<br/>[route.ts]"]
end

subgraph group_data["Persistence &amp; services"]
  node_mail["Email delivery<br/>[mail.ts]"]
  node_accounts["Account storage<br/>[store.ts]"]
  node_availability["Name availability<br/>[availability.ts]"]
  node_contentstore["Content storage<br/>[store.ts]"]
  node_mysql[("MySQL")]
  node_emailservice["SMTP service"]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_landing
node_landing -->|"checks address"| node_username
node_username -->|"checks availability"| node_availability
node_visitor -->|"registers or signs in"| node_signup
node_signup -->|"creates or reads account"| node_accounts
node_signup -->|"sends verification"| node_mail
node_verification -->|"verifies email"| node_accounts
node_mail -.->|"delivers email"| node_emailservice
node_visitor -->|"opens dashboard"| node_dashboard
node_dashboard -->|"edits portfolio"| node_adminapi
node_adminapi -->|"guards and writes"| node_adminservice
node_adminservice -.->|"uses site store"| node_contentstore
node_visitor -->|"views portfolio"| node_portfolio
node_portfolio -->|"renders saved content"| node_contentstore
node_portfolio -->|"polls for changes"| node_live
node_visitor -->|"submits message"| node_contact
node_contact -->|"looks up site owner"| node_accounts
node_contact -->|"stores message"| node_contentstore
node_visitor -->|"requests media"| node_mediaroute
node_mediaroute -->|"reads uploaded file"| node_contentstore
node_accounts -.->|"persists accounts"| node_mysql
node_contentstore -.->|"persists content"| node_mysql

click node_landing "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/(landing)/page.tsx"
click node_username "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/username/route.ts"
click node_signup "https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/api/auth"
click node_verification "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/verify-email/route.ts"
click node_mail "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/mail.ts"
click node_dashboard "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/admin/(panel)/(dashboard)/page.tsx"
click node_adminapi "https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/api/admin"
click node_adminservice "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/admin/server.ts"
click node_contentapi "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/content/route.ts"
click node_portfolio "https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/(site)/%5Busername%5D"
click node_live "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/live/%5Busername%5D/route.ts"
click node_contact "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/contact/route.ts"
click node_mediaroute "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/media/%5Bid%5D/route.ts"
click node_accounts "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/account/store.ts"
click node_availability "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/account/availability.ts"
click node_contentstore "https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/content/store.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_landing,node_username,node_signup,node_verification toneBlue
class node_dashboard,node_adminapi,node_adminservice toneAmber
class node_contentapi,node_portfolio,node_live,node_contact,node_mediaroute toneMint
class node_mail,node_accounts,node_availability,node_contentstore,node_mysql,node_emailservice toneRose
class node_visitor toneIndigo
```

## Components

### Discovery & accounts

- [Landing page](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/(landing)/page.tsx): `frontend/src/app/(landing)/page.tsx`
- [Username check](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/username/route.ts): `frontend/src/app/api/username/route.ts`
- [Sign up / login](https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/api/auth): `frontend/src/app/api/auth`
- [Email verification](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/verify-email/route.ts): `frontend/src/app/verify-email/route.ts`

### Portfolio management

- [Admin dashboard](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/admin/(panel)/(dashboard)/page.tsx): `frontend/src/app/admin/(panel)/(dashboard)/page.tsx`
- [Admin APIs](https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/api/admin): `frontend/src/app/api/admin`
- [Admin service](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/admin/server.ts): `frontend/src/lib/admin/server.ts`

### Public portfolio

- [Public content API](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/content/route.ts): `frontend/src/app/api/content/route.ts`
- [Portfolio pages](https://github.com/hey-ashik/makeportfolio/tree/main/frontend/src/app/(site)/%5Busername%5D): `frontend/src/app/(site)/[username]`
- [Live updates](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/live/%5Busername%5D/route.ts): `frontend/src/app/api/live/[username]/route.ts`
- [Contact form API](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/api/contact/route.ts): `frontend/src/app/api/contact/route.ts`
- [Media delivery](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/app/media/%5Bid%5D/route.ts): `frontend/src/app/media/[id]/route.ts`

### Persistence & services

- [Email delivery](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/mail.ts): `frontend/src/lib/mail.ts`
- [Account storage](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/account/store.ts): `frontend/src/lib/account/store.ts`
- [Name availability](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/account/availability.ts): `frontend/src/lib/account/availability.ts`
- [Content storage](https://github.com/hey-ashik/makeportfolio/blob/main/frontend/src/lib/content/store.ts): `frontend/src/lib/content/store.ts`
- **MySQL**
- **SMTP service**

### Other components

- **Visitor**

## Connections

- Visitor → Landing page: visits
- Landing page → Username check: checks address
- Username check → Name availability: checks availability (evidence: `frontend/src/app/api/username/route.ts`)
- Visitor → Sign up / login: registers or signs in
- Sign up / login → Account storage: creates or reads account
- Sign up / login → Email delivery: sends verification (evidence: `frontend/src/app/api/auth/register/route.ts`)
- Email verification → Account storage: verifies email (evidence: `frontend/src/app/verify-email/route.ts`)
- Email delivery → SMTP service: delivers email
- Visitor → Admin dashboard: opens dashboard
- Admin dashboard → Admin APIs: edits portfolio
- Admin APIs → Admin service: guards and writes (evidence: `frontend/src/app/api/admin/media/route.ts`)
- Admin service → Content storage: uses site store
- Visitor → Portfolio pages: views portfolio
- Portfolio pages → Content storage: renders saved content
- Portfolio pages → Live updates: polls for changes
- Visitor → Contact form API: submits message (evidence: `frontend/src/app/api/contact/route.ts`)
- Contact form API → Account storage: looks up site owner (evidence: `frontend/src/app/api/contact/route.ts`)
- Contact form API → Content storage: stores message (evidence: `frontend/src/app/api/contact/route.ts`)
- Visitor → Media delivery: requests media (evidence: `frontend/src/app/media/[id]/route.ts`)
- Media delivery → Content storage: reads uploaded file (evidence: `frontend/src/app/media/[id]/route.ts`)
- Account storage → MySQL: persists accounts
- Content storage → MySQL: persists content
