How marouanebenfikri/mbenfikri works
Project type and purpose
• This is a static, front-end only Bootstrap-based landing-page template.
• A Gulp-driven build pipeline compiles SCSS and bundles JS, producing ready-to-serve HTML/CSS/JS under public_html.
• Users deploy it to any static web server or CDN to render a personal/commercial landing page.
File structure
• Top-level:
• gulpfile.js & package.json → Node/Gulp build configuration
• public_html/ → build output (HTML pages and assets)
• README.txt, LICENSE.txt, CV… → docs and licenses
• public_html/assets:
• scss/ → 7-1 pattern (abstracts, base, components, layout, vendors)
• css/ → compiled CSS (e.g. johndoe.css)
• js/ → custom JS (johndoe.js)
• imgs/ → videos and image assets
• HTML pages: index.html, components.html, details.html
README for insights
• External integrations: Unsplash demo images, Google Maps API
Components
a. Main components
• Source Directory (“src”): SCSS modules + custom JS
• Build System: Gulp tasks (compile SCSS → CSS, concat/minify JS)
• Output Directory (public_html): HTML pages + compiled assets
• Static Hosting: Web server or CDN that serves public_html
• Client Browser: Downloads HTML/CSS/JS, renders UI, invokes Google Maps API
• External Services:
– Google Maps API
– Unsplash (image hosting/demo images)
b. Relationships and interactions
1. Developer edits SCSS & JS → Gulp watches sources
2. Gulp processes:
• SCSS → CSS
• JS modules & vendor JS → bundled/minified JS
3. Output placed in public_html/assets
4. Web server serves HTML + assets to end-users
5. Browser loads static files, executes JS, applies CSS
6. JS may call external APIs (e.g., Google Maps) and lazy-load images (Unsplash)
c. Architectural patterns/design principles
• Front-end asset pipeline (build time vs runtime)
• Modular SCSS (7-1 pattern) for style separation
• Vendor vs custom code separation
• Static-site layering: source → build → deploy → client
d. Key technologies & libraries
• Node.js & Gulp (build orchestration)
• SCSS (preprocessor)
• Bootstrap 4.3.1 (layout & components)
• jQuery, Isotope (DOM manipulation & filtering)
• Google Maps API