How ouadjih/portfolio23 works
Project type and purpose
• Type: Single-Page Application (SPA) built with React.
• Purpose: A personal portfolio site that showcases projects, allows resume download, provides a contact form, links to social media, and (future) a “Learn with me” section.
File structure
• Top-level:
• package.json / package-lock.json → Node/React dependencies
• public/ → Static host folder (index.html, manifest.json, resume PDF)
• src/ → React source code
• src subfolders:
• src/components → Reusable UI components (Navbar, Hero, Form, Grid, Loader, Media, Succes)
• src/pages → Route-level pages (Home, Projects, Contact, Error, Layout)
• src/context → ThemeContext to manage theme state globally
• src/Assets → Images and data.js for static data
• src/App.js, index.js → App bootstrap and ReactDOM render
README for additional insights
• Features called out: Projects page, project details view, resume download, contact form, social media links, future learning page.
a. Main components
1. Client Browser
2. CDN / Static Host (e.g., Netlify, Vercel, GitHub Pages)
3. React SPA
– App Shell (App.js + index.html)
– Router & Layout (Layout.js + pages index.js)
– Pages (Home, Projects, Contact, Error)
– Shared Components (Navbar, Hero, Grid, Form, Loader, Media, Succes)
– Context Layer (ThemeContext)
– Assets Layer (Images, data.js, resume PDF)
4. External Services
– Email/Form service API (e.g., Formspree, SendGrid)
– Social Media Platforms (LinkedIn, GitHub, Twitter links)
b. Relationships & interactions
• User → Browser: Enters URL
• Browser → CDN/Host: GET index.html + static bundle
• CDN/Host → React SPA: Serve JS/CSS bundles, assets
• React Router: Maps paths to page components
• ThemeContext: Provides theme state to all components
• Form component → External service: POST form data
• Resume link → Direct download from public folder
c. Architectural patterns and design principles
• Component-based architecture (React)
• Single source of truth for theme (Context API)
• Static assets served via public folder (PWA manifest.json)
• Separation of concerns: UI components vs. page components vs. context
d. Key technologies/frameworks/libraries
• React.js for UI
• Context API for state management
• React Router (implied) for client-side routing
• Static hosting platform (CDN)
• Form submission service