How khalidlh/portfolio works
Project type and purpose
• This is a static, client-side portfolio website built to showcase a Full-Stack developer’s profile, work samples and blog links.
• There is no monolithic backend in this repo—everything is delivered as static HTML, CSS and JavaScript. PHP/Laravel and MySQL are only referenced for external case studies, not part of this codebase.
File structure
• Top-level files:
• index.html – the single-page entry point
• mycv.pdf – downloadable resume
• assets – all static resources (css, js, images, scss source)
• The SCSS folder is subdivided into abstracts (variables, mixins, utilities), base, components, layout and vendor overrides, indicating a modular, “SMACSS”-style styling architecture.
• No server or API directories—this is purely client-rendered.
Key insights from README
• Functionality: personal info, services section, interactive portfolio, blog links, contact form (likely via third-party or static form handler), responsive behavior.
Main components
a. Client Browser
– Loads index.html from web host (e.g., GitHub Pages or other static host)
– Requests CSS/JS assets and images from CDN or same host
b. Asset Pipeline (build stage, optional)
– SCSS compiler (node-sass, gulp, webpack, etc.) converts .scss → steller.css
– Bundler/minifier packages JS (steller.js + vendors)
c. Static File Host / CDN
– Serves index.html, assets/css, assets/js, assets/imgs, vendors
– Optionally uses a CDN for faster global delivery
d. Third-party Services (if applicable)
– Contact form handler (e.g., Formspree, Netlify Forms, custom PHP endpoint)
– Analytics or tracking (Google Analytics snippet in steller.js)
– Font Awesome (if linked via CDN)
Relationships and interactions
• Browser → HTTP GET → Static Host (index.html)
• Browser parses HTML → issues concurrent GETs for CSS, JS, fonts, images
• JS binds UI behavior (carousel, navbar toggles)
• Contact form → POST → Third-party form endpoint or server script
• (Build stage) SCSS compiler reads /assets/scss/** → outputs /assets/css/steller.css
Architectural patterns and principles
• Separation of Concerns:
• HTML structure (index.html)
• Presentation (SCSS → CSS)
• Behavior (JS + jQuery plugins)
• Modular SCSS organization following SMACSS/BEM ideas
• Progressive enhancement: basic HTML + CSS, then JS interactivity
• Static hosting & CDN for high availability and performance
Technologies and frameworks to annotate
• SCSS (sass) compiler, Gulp/Webpack (if used)
• Bootstrap 4.3.1 CSS & JS
• jQuery 3.4.1
• Hosting platform (GitHub Pages, Netlify, AWS S3+CloudFront, etc.)