# alexferrer200x-ux/initial-project-structure architecture

> Architecture diagram of the GitHub repository alexferrer200x-ux/initial-project-structure, 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/alexferrer200x-ux/initial-project-structure
- Repository: https://github.com/alexferrer200x-ux/initial-project-structure

## Overview

Curious Minds is a project-publishing blog with account, discussion, contact, and administrative features. Visitors browse projects and open details; signed-in users can create and manage posts and interact through likes and comments. The React app routes these experiences through client state and an Axios API layer to an Express backend, which applies authentication and persists domain records in MongoDB. The excerpts show route mounting and several backend model interactions, but do not establish the client’s complete endpoint wiring; those links are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/App.jsx) (Page router), [`frontend/src/stores/authStore.js`](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/stores/authStore.js) (Authentication state), [`backend/server.js`](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/server.js) (Express server), [`frontend/src/services/api.js`](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/services/api.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Page router<br/>[App.jsx]"]
  node_home["Project feed<br/>[Home.jsx]"]
  node_postpage["Project detail<br/>[PostPage.jsx]"]
  node_postcard["Project card<br/>[PostCard.jsx]"]
  node_theme["Theme state<br/>[ThemeContext.jsx]"]
end

subgraph group_identity["Accounts and access"]
  node_authpages["Account pages<br/>[Login.jsx]"]
  node_register["Registration page<br/>[Register.jsx]"]
  node_verify["Email verification<br/>[VerifyEmail.jsx]"]
  node_settings["Profile settings<br/>[Settings.jsx]"]
  node_authstore["Authentication state<br/>[authStore.js]"]
end

subgraph group_content["Publishing and discussion"]
  node_create["Post authoring<br/>[Create.jsx]"]
  node_edit["Post editing<br/>[EditPostPage.jsx]"]
  node_profile["Member profile<br/>[Profile.jsx]"]
  node_poststore["Post state<br/>[postStore.js]"]
end

subgraph group_operations["Administration and contact"]
  node_contact["Contact form<br/>[Contact.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
end

subgraph group_backend["API and persistence"]
  node_api["HTTP client<br/>[api.js]"]
  node_server["Express server<br/>[server.js]"]
  node_authroute["Auth routes<br/>[auth.js]"]
  node_projectroute["Project routes<br/>[project.js]"]
  node_adminroute["Admin routes<br/>[admin.js]"]
  node_messageroute["Message routes<br/>[message.js]"]
  node_userroute["User routes<br/>[user.js]"]
  node_uploadroute["Upload routes<br/>[upload.js]"]
  node_authmw["Token authentication<br/>[auth.js]"]
  node_adminmw["Admin authorization<br/>[adminAuth.js]"]
  node_user[("User records<br/>[User.js]")]
  node_project[("Project records<br/>[Project.js]")]
  node_comment[("Comment records<br/>[Comment.js]")]
  node_message[("Message records<br/>[Message.js]")]
  node_email["Email delivery<br/>[emailService.js]"]
end

node_visitor(("Visitor or member"))

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_postpage
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_verify
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_create
node_app -->|"routes to"| node_edit
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_contact
node_app -->|"routes to"| node_adminui
node_home -->|"uses state"| node_poststore
node_home -->|"renders"| node_postcard
node_postpage -->|"uses state"| node_poststore
node_postpage -->|"calls"| node_api
node_authpages -->|"uses state"| node_authstore
node_register -->|"uses state"| node_authstore
node_register -->|"calls"| node_api
node_verify -->|"calls"| node_api
node_settings -->|"uses state"| node_authstore
node_settings -->|"calls"| node_api
node_settings -->|"uses theme"| node_theme
node_create -->|"uses state"| node_poststore
node_create -->|"uses state"| node_authstore
node_edit -->|"uses state"| node_poststore
node_profile -->|"uses state"| node_poststore
node_profile -->|"uses state"| node_authstore
node_contact -->|"calls"| node_api
node_contact -->|"uses state"| node_authstore
node_adminui -->|"calls"| node_api
node_adminui -->|"uses state"| node_authstore
node_authstore -->|"calls"| node_api
node_server -->|"mounts"| node_authroute
node_server -->|"mounts"| node_projectroute
node_server -->|"mounts"| node_adminroute
node_server -->|"mounts"| node_messageroute
node_server -->|"mounts"| node_userroute
node_server -->|"mounts"| node_uploadroute
node_authroute -->|"reads/writes"| node_user
node_authroute -->|"sends mail"| node_email
node_projectroute -->|"reads/writes"| node_project
node_projectroute -->|"reads"| node_user
node_projectroute -->|"reads/writes"| node_comment
node_adminroute -->|"reads/writes"| node_project
node_adminroute -->|"reads/writes"| node_user
node_adminroute -->|"reads/writes"| node_comment
node_adminroute -->|"reads/writes"| node_message

click node_app "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Home.jsx"
click node_postpage "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/PostPage.jsx"
click node_postcard "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/components/PostCard.jsx"
click node_theme "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/context/ThemeContext.jsx"
click node_authpages "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Login.jsx"
click node_register "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Register.jsx"
click node_verify "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/VerifyEmail.jsx"
click node_settings "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Settings.jsx"
click node_authstore "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/stores/authStore.js"
click node_create "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Create.jsx"
click node_edit "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/EditPostPage.jsx"
click node_profile "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Profile.jsx"
click node_poststore "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/stores/postStore.js"
click node_contact "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Contact.jsx"
click node_adminui "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_api "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/server.js"
click node_authroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/auth.js"
click node_projectroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/project.js"
click node_adminroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/admin.js"
click node_messageroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/message.js"
click node_userroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/user.js"
click node_uploadroute "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/upload.js"
click node_authmw "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/middleware/auth.js"
click node_adminmw "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/middleware/adminAuth.js"
click node_user "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/User.js"
click node_project "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Project.js"
click node_comment "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Comment.js"
click node_message "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Message.js"
click node_email "https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/utils/emailService.js"

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,node_home,node_postpage,node_postcard,node_theme toneBlue
class node_authpages,node_register,node_verify,node_settings,node_authstore toneAmber
class node_create,node_edit,node_profile,node_poststore toneMint
class node_contact,node_adminui toneRose
class node_api,node_server,node_authroute,node_projectroute,node_adminroute,node_messageroute,node_userroute,node_uploadroute,node_authmw,node_adminmw,node_user,node_project,node_comment,node_message,node_email,node_visitor toneIndigo
```

## Components

### Web application

- [Page router](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Project feed](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Project detail](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/PostPage.jsx): `frontend/src/pages/PostPage.jsx`
- [Project card](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/components/PostCard.jsx): `frontend/src/components/PostCard.jsx`
- [Theme state](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`

### Accounts and access

- [Account pages](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Registration page](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Register.jsx): `frontend/src/pages/Register.jsx`
- [Email verification](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/VerifyEmail.jsx): `frontend/src/pages/VerifyEmail.jsx`
- [Profile settings](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Settings.jsx): `frontend/src/pages/Settings.jsx`
- [Authentication state](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/stores/authStore.js): `frontend/src/stores/authStore.js`

### Publishing and discussion

- [Post authoring](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Create.jsx): `frontend/src/pages/Create.jsx`
- [Post editing](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/EditPostPage.jsx): `frontend/src/pages/EditPostPage.jsx`
- [Member profile](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Profile.jsx): `frontend/src/pages/Profile.jsx`
- [Post state](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/stores/postStore.js): `frontend/src/stores/postStore.js`

### Administration and contact

- [Contact form](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/Contact.jsx): `frontend/src/pages/Contact.jsx`
- [Admin dashboard](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`

### API and persistence

- [HTTP client](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Express server](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Project routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/project.js): `backend/routes/project.js`
- [Admin routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/admin.js): `backend/routes/admin.js`
- [Message routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/message.js): `backend/routes/message.js`
- [User routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/user.js): `backend/routes/user.js`
- [Upload routes](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/routes/upload.js): `backend/routes/upload.js`
- [Token authentication](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [Admin authorization](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/middleware/adminAuth.js): `backend/middleware/adminAuth.js`
- [User records](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/User.js): `backend/models/User.js`
- [Project records](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Project.js): `backend/models/Project.js`
- [Comment records](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Comment.js): `backend/models/Comment.js`
- [Message records](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/models/Message.js): `backend/models/Message.js`
- [Email delivery](https://github.com/alexferrer200x-ux/initial-project-structure/blob/main/backend/utils/emailService.js): `backend/utils/emailService.js`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Page router: opens
- Page router → Project feed: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Project detail: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Account pages: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Registration page: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Email verification: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Profile settings: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Post authoring: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Post editing: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Member profile: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Contact form: routes to (evidence: `frontend/src/App.jsx`)
- Page router → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Project feed → Post state: uses state (evidence: `frontend/src/pages/Home.jsx`)
- Project feed → Project card: renders (evidence: `frontend/src/pages/Home.jsx`)
- Project detail → Post state: uses state (evidence: `frontend/src/pages/PostPage.jsx`)
- Project detail → HTTP client: calls (evidence: `frontend/src/pages/PostPage.jsx`)
- Account pages → Authentication state: uses state (evidence: `frontend/src/pages/Login.jsx`)
- Registration page → Authentication state: uses state (evidence: `frontend/src/pages/Register.jsx`)
- Registration page → HTTP client: calls (evidence: `frontend/src/pages/Register.jsx`)
- Email verification → HTTP client: calls (evidence: `frontend/src/pages/VerifyEmail.jsx`)
- Profile settings → Authentication state: uses state (evidence: `frontend/src/pages/Settings.jsx`)
- Profile settings → HTTP client: calls (evidence: `frontend/src/pages/Settings.jsx`)
- Profile settings → Theme state: uses theme (evidence: `frontend/src/pages/Settings.jsx`)
- Post authoring → Post state: uses state (evidence: `frontend/src/pages/Create.jsx`)
- Post authoring → Authentication state: uses state (evidence: `frontend/src/pages/Create.jsx`)
- Post editing → Post state: uses state (evidence: `frontend/src/pages/EditPostPage.jsx`)
- Member profile → Post state: uses state (evidence: `frontend/src/pages/Profile.jsx`)
- Member profile → Authentication state: uses state (evidence: `frontend/src/pages/Profile.jsx`)
- Contact form → HTTP client: calls (evidence: `frontend/src/pages/Contact.jsx`)
- Contact form → Authentication state: uses state (evidence: `frontend/src/pages/Contact.jsx`)
- Admin dashboard → HTTP client: calls (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Admin dashboard → Authentication state: uses state (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Authentication state → HTTP client: calls (evidence: `frontend/src/stores/authStore.js`)
- Express server → Auth routes: mounts (evidence: `backend/server.js`)
- Express server → Project routes: mounts (evidence: `backend/server.js`)
- Express server → Admin routes: mounts (evidence: `backend/server.js`)
- Express server → Message routes: mounts (evidence: `backend/server.js`)
- Express server → User routes: mounts (evidence: `backend/server.js`)
- Express server → Upload routes: mounts (evidence: `backend/server.js`)
- Auth routes → User records: reads/writes (evidence: `backend/routes/auth.js`)
- Auth routes → Email delivery: sends mail (evidence: `backend/routes/auth.js`)
- Project routes → Project records: reads/writes (evidence: `backend/routes/project.js`)
- Project routes → User records: reads (evidence: `backend/routes/project.js`)
- Project routes → Comment records: reads/writes (evidence: `backend/routes/project.js`)
- Admin routes → Project records: reads/writes (evidence: `backend/routes/admin.js`)
- Admin routes → User records: reads/writes (evidence: `backend/routes/admin.js`)
- Admin routes → Comment records: reads/writes (evidence: `backend/routes/admin.js`)
- Admin routes → Message records: reads/writes (evidence: `backend/routes/admin.js`)
