[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M787Y0C8JPDSSCD68BQFHY4R":3,"skill-same:01M787Y0C8JPDSSCD68BQFHY4R":102},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":14,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M787Y0C8JPDSSCD68BQFHY4R","portfolio-website-design",null,"Create full portfolio websites with glassmorphism effects using olive, light green, and amber color schemes.","abdullibrahim733-pixel\u002FEagle","abdullibrahim733-pixel","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F230504522?v=4","01M787SK0DQR0H1K326DJT6EBK","ibrahim abdull","01M787SK1HWS9V959THKZM6N70",0,"MIT","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: portfolio-website-design\ndescription: Create full portfolio websites with glassmorphism effects using olive, light green, and amber color schemes.\nversion: 1.4.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [design, html, css, portfolio, glassmorphism, ux, ui]\n    related_skills: [claude-design, popular-web-designs]\n---\n\n# Portfolio Website Design\n\nThis skill creates full portfolio websites with modern design elements including glassmorphism effects and a specific color palette of olive, light green, and amber.\n\n## When To Use\n\nUse this skill when the user requests:\n- A complete portfolio website\n- Modern design with glassmorphism effects\n- Specific color schemes (olive, light green, amber)\n- Responsive layouts for all device sizes\n- Professional presentation of projects and services\n\n## Design Approaches\n\n### Approach A: Glassmorphism (Light)\nThe classic glassmorphism look — semi-transparent cards on a light or patterned background. Best for creative\u002Fdesign portfolios.\n\n### Approach B: Dark Theme + Glass Elements (Hybrid)\nA dark background (#08080e range) with glass cards overlaid. The glass provides depth against the dark, while the dark background gives a premium, engineering\u002Fproduct feel. Preferred by technical founders, robotics\u002FAI engineers, and deep-tech builders.\n\n_This session produced a hybrid portfolio for a Tanzanian deep-tech founder — see `references\u002Fibrahim-portfolio-2026.md` for the full case study._\n\n### Approach C: Catppuccin Dual-Theme System (Dark\u002FLight Toggle)\n\nA complete dual-theme system using Catppuccin's Mocha (dark) and Latte (light) palettes. The user gets a persistent theme toggle (🌙\u002F☀️) in the navigation bar — their choice is saved to localStorage and survives reloads.\n\n#### C1: Dual Theme (Toggle Available)\n\n_See `references\u002Fcatppuccin-portfolio-pattern.md` for the full CSS variables, toggle HTML, and JS implementation._\n\n#### C2: Dark-Only Mode (No Toggle)\n\nSome founders prefer a permanent dark theme — no light mode, no toggle button, no flash of light on page load. This is common for deep-tech \u002F engineering profiles where dark mode signals a \"serious tools\" aesthetic.\n\n**To convert a dual-theme portfolio to dark-only:**\n\n1. **Remove the light CSS block entirely** — delete the entire `[data-theme=\"light\"] { ... }` ruleset. Only `:root` (dark) remains.\n2. **Fix the CSS comment** — change `:root, [data-theme=\"dark\"]` to just `:root` and update the comment to reflect dark-only.\n3. **Remove the theme toggle HTML** — delete the `\u003Cbutton class=\"theme-toggle\" id=\"themeToggle\">` element from the nav.\n4. **Remove the theme toggle CSS** — delete the `.theme-toggle { ... }` and `.theme-toggle:hover { ... }` rule blocks.\n5. **Remove the theme toggle JS** — delete the entire `const themeToggle = ... addEventListener('click', ...)` block. Renumber any remaining JS sections.\n6. **Remove `data-theme` from `\u003Chtml>`** — change `\u003Chtml lang=\"en\" data-theme=\"dark\">` to `\u003Chtml lang=\"en\">`. The CSS defaults are now dark without needing the attribute.\n7. **Replace all toggle-related emojis** — the moon\u002Fsun on the button and in JS are gone automatically with the toggle removal.\n\n**Verification after dark-only conversion:**\n```bash\ngrep -c '\\\\[data-theme=\"light\"\\\\]' index.html     # expect 0\ngrep -c 'themeToggle' index.html                 # expect 0\ngrep -c 'Latte' index.html                       # expect 0\n```\n\n**Pitfalls:**\n- If you remove `data-theme=\"dark\"` from `\u003Chtml>` but keep `[data-theme=\"dark\"]` in CSS, the page still works but the selector is an empty constraint. Clean both for a single source of truth.\n- The `--btn-text` variable (dark text on light buttons) must remain — it's not a light-theme artifact, it's needed for contrast even in dark mode.\n- The `--glass` and `--glass-border` values for dark mode (semi-transparent white) stay as-is.\n- Gradient orbs continue working — their `--orb-*-bg` variables were already dark-specific.\n\n### Approach D: Progress Bar Skills with Animated Proficiency\n\nFor engineering\u002Ftechnical portfolios, replace (or supplement) the standard tag-skill categories with **animated progress bars** that show proficiency levels by domain. Especially effective for audiences who want to see depth: embedded engineers, AI developers, and mechatronics founders.\n\n**Implementation** (see `references\u002Fcatppuccin-portfolio-pattern.md` for complete code):\n\n```html\n\u003Cdiv class=\"skill-progress-item\">\n    \u003Cdiv class=\"skill-progress-header\">\n        \u003Cspan class=\"skill-name\">⚙️ Embedded Systems\u003C\u002Fspan>\n        \u003Cspan class=\"skill-pct\">90%\u003C\u002Fspan>\n    \u003C\u002Fdiv>\n    \u003Cdiv class=\"skill-progress-track\">\n        \u003Cdiv class=\"skill-progress-fill\" style=\"width:90%\">\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n```\n\n**CSS pattern:**\n- `.skill-progress-track`: full-width `8px` height, `border-radius: 100px`, background uses `--surface0`.\n- `.skill-progress-fill`: height `100%`, `border-radius: 100px`, `background: linear-gradient(90deg, var(--green), var(--teal))`, default `width: 0%`, transitions via `transition: width 1.2s cubic-bezier(0.16,1,0.3,1)`.\n- The `width: X%` is set as an inline style on each `.skill-progress-fill`. The scroll-reveal (`IntersectionObserver`) triggers the `.visible` class. With `transition` on the fill, the bars animate from 0 to their target width when they enter the viewport. **No JS needed beyond the existing reveal observer** — CSS transition handles the animation.\n- Container grid: `grid-template-columns: 1fr 1fr` (collapses to 1fr below 900px).\n\n**Pitfalls:**\n- Don't set `width` on the fill in CSS — use inline `style=\"width:X%\"` so each bar has a different value.\n- Proficiency percentages should be **credible, not inflated**. A 19-year-old engineer with 90% in everything looks fake. Use 70-90% range for core domains, lower for secondary skills.\n- The scroll-reveal animation fires once per element. After the bar animates to its target width, it stays there. No additional JS needed.\n\n### Approach E: Integrations \u002F Tools Grid Section\n\nA dedicated section listing tools, platforms, and frameworks the founder works with. Organised into **categorical cards** with colour-coded icon badges and tag clouds. Best placed after the Skills section, labelled \"Tools & Integrations\" or \"My Stack\".\n\n**Implementation** (full code in `references\u002Fcatppuccin-portfolio-pattern.md`):\n\n- 5-card grid (auto-fill, min 260px) with coloured icon badges per category:\n  - AI & Cloud Platforms (mauve badge)\n  - PCB Design & CAD (blue badge)\n  - Languages & Frameworks (green badge)\n  - Hardware & Embedded (peach badge)\n  - Agentic & Automation (pink badge)\n- Each card: header row with coloured icon `div` + title\u002Fsubtitle, then a `\u003Cdiv class=\"int-tags\">` with `\u003Cspan>` chips for each tool.\n- Nav link in the nav bar (e.g. \"Tools\") that scrolls to `#integrations`.\n\n**Pitfalls:**\n- Card icon backgrounds use `color-mix(in srgb, var(--mauve) 20%, transparent)` — this adapts to both dark and light themes without hardcoded rgba.\n- This section works best as a **visual complement** to the skills section, not a replacement. Skills says \"how good I am\", Integrations says \"what I actually use\".\n- **Some founders prefer SVG icons over emoji** for the category header icons. Offer the choice. SVGs look more premium on engineering\u002Ftechnical portfolios. Use inline Lucide-style `\u003Csvg>` elements with `currentColor` so they adapt to both dark and light themes.\n- **Variant: Brand Logo Tool Chips** — Instead of plain `\u003Cspan>` text tags, you can render each tool as a pill with its official logo from the Simple Icons CDN (`https:\u002F\u002Fcdn.simpleicons.org\u002F{slug}\u002Ffff`). See Approach G below for full implementation.\n\n### Approach F: Custom SVG Background Texture\nFor deep-tech \u002F engineering portfolios, replace the grid or solid dark background with a **programmatically generated SVG** that mirrors the founder's domain:\n\n- **Circuit traces**: horizontal bus lines, vertical bus lines, diagonal data paths — drawn as thin lines at low opacity (0.02–0.06)\n- **Glowing vias\u002Fnodes**: small circles at trace intersections with SVG blur filters (feGaussianBlur)\n- **Geographic outline**: a subtle polygon of the founder's continent\u002Fcountry — grounds the portfolio in place\n- **Data waveforms**: `\u003Cpolyline>` with sine-wave math (sin + sin harmonics) across the full viewport width\n- **Binary \u002F data stream accents**: text elements with \"01001110\" patterns in corners\n- **Ambient orbs**: large blurred radial gradient circles that float via CSS animation (inherits from the orb system)\n\nThis background should be **extremely subtle** (overall opacity 0.03-0.08) — it's a premium texture, not a wallpaper. Content readability always comes first.\n\nSee `references\u002Fcircuit-svg-background-pattern.md` for the full generation pattern and Python script.\n\n### Approach G: Brand Logo Tool Chips (Simple Icons CDN)\n\nFor the integrations grid, replace plain `\u003Cspan>` text tags with **brand logo chips** — each tool appears as a small pill with its official logo from the Simple Icons CDN. This dramatically increases visual polish and credibility.\n\n**How it works:**\n\n```html\n\u003Cspan class=\"tool-chip\">\n    \u003Cimg class=\"tool-logo\" src=\"https:\u002F\u002Fcdn.simpleicons.org\u002Fanthropic\u002Ffff\"\n         alt=\"Anthropic\" loading=\"lazy\"\n         onerror=\"this.style.display='none';this.nextElementSibling.style.display='flex'\">\n    \u003Cspan class=\"tool-logo-fallback\" style=\"background:#d97757\">A\u003C\u002Fspan>\n    \u003Cspan class=\"tool-chip-name\">Anthropic\u003C\u002Fspan>\n\u003C\u002Fspan>\n```\n\nThe `\u003Cimg>` attempts to load the official SVG logo from the CDN. On failure (no icon for that slug), the `onerror` handler hides the image and reveals the `.tool-logo-fallback` span — a colored letter-initial badge. This means **every tool always has a visual**, even obscure ones without a Simple Icons entry.\n\n**CSS pattern:**\n```css\n.tool-grid { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 14px; }\n.tool-chip {\n    display: inline-flex; align-items: center; gap: 7px;\n    padding: 6px 12px; border-radius: 8px;\n    background: var(--surface0); border: 1px solid var(--glass-border);\n    transition: all 0.2s; cursor: default;\n}\n.tool-chip:hover {\n    transform: translateY(-2px);\n    border-color: color-mix(in srgb, var(--mauve) 30%, transparent);\n}\n.tool-chip img.tool-logo { width: 18px; height: 18px; object-fit: contain; flex-shrink: 0; }\n.tool-logo-fallback {\n    width: 18px; height: 18px; border-radius: 4px;\n    display: none; align-items: center; justify-content: center;\n    font-size: 10px; font-weight: 700; color: #fff; flex-shrink: 0;\n}\n.tool-chip-name { font-size: 0.75rem; font-weight: 500; white-space: nowrap; }\n```\n\n**Sizing guide:** Logo = 18×18px. Chip padding = 6px 12px. These are compact enough to fit many in a row on desktop, but large enough to be readable and touch-friendly.\n\n**Integration with Approach E:** Replace `\u003Cdiv class=\"int-tags\">` with `\u003Cdiv class=\"tool-grid\">`. Keep the card framework (header, icon badge, title, subtitle) identical. The card categories and colored icon badges remain.\n\n**Pitfalls:**\n- Simple Icons CDN is a third-party dependency (3100+ brands, MIT-licensed). The onerror+fallback pattern means zero visual breakage if the CDN is down — it degrades to colored initials.\n- Not every tool has a Simple Icons entry (e.g., Gazebo, Railway, Ollama). Assign a reasonable brand-hex color for the fallback background.\n- `\u002Ffff` renders the icon white. Works on dark chip backgrounds. For light theme, use `...\u002F000` or omit the suffix for the default colored icon. Since icons are tiny (18px), a single white-on-semi-dark-chip style works acceptably in both themes with the fallback providing brand color.\n- Loading from CDN adds ~44 HTTP requests (one per tool). Each SVG is ~200-800 bytes. Total page weight impact is negligible (~20KB). Use `loading=\"lazy\"` on each `\u003Cimg>`.\n- Simple Icons' URL pattern follows `https:\u002F\u002Fcdn.simpleicons.org\u002F{slug}\u002Fcolor` — the `\u002Ffff` suffix overrides the color to white. For brand-colored icons (e.g., if the chip background changes), omit the suffix.\n\n### Approach H: Mass Emoji→SVG Icon Replacement\n\nSome founders want **zero emoji** on their portfolio — everything replaced with clean SVG icons. This is common for deep-tech and engineering profiles where emoji can feel informal. This approach covers the full-site migration.\n\n#### When to apply\n\nOffer this when:\n- The user says \"no emoji, use icons\", \"replace emojis with icons\", or \"make it look more premium\"\n- During the initial build, before showing the founder a draft (ask: \"Do you prefer emoji or icons on the skill badges and section headers?\")\n- As a polish pass after the first deploy\n\n#### Icon source: inline Lucide-style SVGs\n\nUse inline `\u003Csvg>` elements from the Lucide icon set (MIT license, ~800 icons). Every icon is a self-contained `viewBox=\"0 0 24 24\"` with `fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"`. They automatically inherit the text color via `currentColor` and adapt to both theme modes.\n\n**Key icons used in the production portfolio:**\n\n| Context | Lucide icon name | SVG path count |\n|---------|-----------------|----------------|\n| About: Mind\u002FBrain | `brain` | 6 paths |\n| About: AI\u002FRobotics | `bot` | 4 paths + 1 rect + 1 circle |\n| About: Code | `code-2` (angle brackets) | 2 polylines |\n| About: Satellite\u002FTech | `hard-drive` | 4 paths |\n| Flywheel: Growth | `sprout` | 2 paths |\n| Flywheel: Connection | `link-2` | 2 paths |\n| Flywheel: Swarm | (custom ant\u002Fbug) | 8 paths |\n| Flywheel: Ghost\u002Flanguage | `ghost` | 7 paths |\n| Flywheel: Water\u002Fspace | `droplet` | 1 path |\n| Skills: Settings\u002FEmbedded | `settings` (gear) | 12 paths |\n| Skills: AI Agentic | `bot` | 4 paths + 1 rect + 1 circle |\n| Skills: AI\u002FLLMs | `brain` | 6 paths |\n| Skills: Mobile | `smartphone` | 1 rect + 1 line |\n| Skills: IoT | `globe` | 1 circle + 1 line + 1 ellipse path |\n| Skills: Mechatronics | `wrench` | 3 paths |\n| Skills: Full-Stack | `monitor` | 1 rect + 2 lines |\n| Skills: PCB Design | `hexagon` (hex grid) | 3 lines + 1 polygon |\n| Integrations: Cloud | `cloud` | 1 path |\n| Integrations: Circuit | `cpu` \u002F `rectangle` | 3 paths + 1 rect |\n| Integrations: Languages | `code-2` | 2 polylines |\n| Integrations: Hardware | `microchip` | 5 lines + 1 rect |\n| Integrations: Agentic | `settings` (gear) | 12 paths |\n| Nav\u002FFooter: Globe | `globe` | 1 circle + 1 line + 1 ellipse path |\n| Email | `mail` | 1 rect + 1 path |\n| LinkedIn | `linkedin` | 1 path + 1 rect + 1 circle |\n| GitHub | `github` | 2 polylines |\n| X\u002FTwitter | `x` | 2 lines |\n| YouTube | `youtube` | 1 polygon |\n| Chat (closed) | `message-circle` | 1 path |\n| Chat (close\u002FX) | `x` | 2 lines |\n| Chat send | `send` | 1 line + 1 polygon |\n| Play button | `play` | 1 polygon |\n| Lightning\u002Fenergy | `zap` | 1 polygon |\n| Check\u002Fcorrect | `check` | 1 polyline |\n\n#### Mass replacement technique\n\nUse a Python script with a `replacements` array to batch-find every emoji in the HTML and replace it with its SVG equivalent:\n\n```python\nwith open('index.html', 'r') as f:\n    content = f.read()\n\nreplacements = [\n    # About stat cards\n    ('\u003Cdiv class=\"icon\">🧠\u003C\u002Fdiv>', '\u003Cdiv class=\"icon\">\u003Csvg width=\"1em\" ...brain paths...>\u003C\u002Fsvg>\u003C\u002Fdiv>'),\n    ('\u003Cdiv class=\"icon\">🤖\u003C\u002Fdiv>', '\u003Cdiv class=\"icon\">\u003Csvg width=\"1em\" ...bot paths...>\u003C\u002Fsvg>\u003C\u002Fdiv>'),\n    # ... every emoji occurrence ...\n]\n\nfor old, new in replacements:\n    if old in content:\n        content = content.replace(old, new)\n        print(f\"✓ Replaced: {old[:30]}...\")\n    else:\n        print(f\"✗ NOT FOUND: {old[:40]}...\")\n\nwith open('index.html', 'w') as f:\n    f.write(content)\n```\n\n**Where emojis typically hide:**\n\n| Location | Typical emojis |\n|----------|---------------|\n| Skill names (progress bar labels) | ⚙️ 🤖 🧠 📱 🌐 🔧 💻 📐 |\n| Integration category icons | ☁️ 🔬 ⌨️ 🔌 🧩 |\n| About stat card icons | 🧠 🤖 ⌨️ 🛰️ |\n| Flywheel card emoji spans | 🌿 🔗 🐜 👻 💧 |\n| Project visual placeholders | 🐜 👻 🌿 🔗 💧 |\n| Contact link labels | 📧 💻 🐦 🔗 ▶ |\n| Nav link CTA \u002F section labels | Various |\n| Chatbot JS strings (greetings, responses) | 👋 😊 🤔 🌍 🤝 💪 🌟 |\n| Footer | 🌍 or similar globe |\n| Chat toggle \u002F send buttons | 💬 ✕ ➤ |\n| YouTube section | 🎬 ▶ |\n| Favicon (data URI) | ⚡ in `\u003Ctext>` element |\n\n**Chatbot JS strings require special handling:** Emojis embedded in JavaScript string literals (the chatbot's response objects) need text equivalents or trimming. Example:\n\n```python\n# JS string replacements (strip emoji from chatbot response text)\njs_emoji_fixes = [\n    (' from Africa. 🌍', ' from Africa.'),\n    ('anything! 😊', 'anything!'),\n    ('👋 I\\'m Ibrahim\\'s virtual', 'I\\'m Ibrahim\\'s virtual'),\n    ('you? 🤔', 'you?'),\n]\nfor old, new in js_emoji_fixes:\n    content = content.replace(old, new)\n```\n\n#### Favicon (no-emoji variant)\n\nReplace an emoji-based favicon (`\u003Ctext y='.9em' font-size='90'>⚡\u003C\u002Ftext>`) with an inline SVG polygon:\n\n```html\n\u003Clink rel=\"icon\" type=\"image\u002Fsvg+xml\"\n      href=\"data:image\u002Fsvg+xml,&lt;svg xmlns='http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg' viewBox='0 0 100 100'&gt;&lt;polygon points='60,10 20,55 50,55 40,90 80,45 50,45' fill='%23a6e3a1'\u002F&gt;&lt;\u002Fsvg&gt;\">\n```\n\n**Key points:** URL-encode the `\u003C` and `>` as `&lt;` and `&gt;` in the data URI to avoid HTML parser conflicts. The `%23` encodes the `#` in hex colors.\n\n#### Verification\n\nAfter replacement, verify zero emoji remain:\n\n```python\nremaining = []\nfor i, ch in enumerate(content):\n    cp = ord(ch)\n    if (0x1F300 \u003C= cp \u003C= 0x1F9FF) or (0x2600 \u003C= cp \u003C= 0x27BF):\n        remaining.append(f'U+{cp:04X} {ch} at pos {i}')\nif remaining:\n    print(f'{len(remaining)} emojis remaining:')\n    for r in remaining:\n        print(r)\nelse:\n    print('✅ Zero emojis!')\n```\n\nThe only expected survivor is the favicon if it still uses an emoji — intentionally replace it with a polygon.\n\n#### Pitfalls\n\n- **Every emoji occurrence is a separate entry in the replacements array.** There's no one-size-fits-all regex for this. Expect 30-50 replacements for a full portfolio.\n- **Inline SVGs in chatbot JS strings:** The chatbot responses are JS string literals, not HTML. You cannot put `\u003Csvg>...\u003C\u002Fsvg>` inside a JS string used as `textContent`. Instead, strip the emoji and use clean text. The chatbot's greeting becomes \"Hi! I'm Ibrahim's virtual assistant.\" instead of \"👋 Hi! I'm...\".\n- **Chat toggle button emoji→SVG swap uses innerHTML, not textContent.** After replacing the emoji with an SVG, the JS that toggles the button must also use `innerHTML = '\u003Csvg>...'` instead of `textContent = '💬'`. Update both the initial HTML and the JS toggle handler.\n- **Preserve JS string integrity.** When you replace emoji inside JS strings (greetings, responses), only remove the emoji character — don't break the string delimiters or escape sequences.\n- **Deploy and hard-refresh.** After the replacement, force a Vercel deploy with `--force` flag to CDN-bust: `vercel deploy --prod --yes --force`. Users must hard-refresh (Ctrl+Shift+R) since the old HTML may be cached by the browser, not just the CDN.\n\n### Approach I: AI Visibility & SEO for Portfolio Sites\n\nMaking a portfolio discoverable by AI crawlers (ChatGPT, Perplexity, Google AI) and search engines requires structured data and proper meta tags. Apply this after the visual design is final.\n\n#### Required Meta Tags\n\nInclude these in `\u003Chead>`:\n\n```html\n\u003Ctitle>Your Name — Title | Company — Tagline\u003C\u002Ftitle>\n\u003Cmeta name=\"description\" content=\"155-char rich summary with keywords, role, and location.\" \u002F>\n\u003Cmeta name=\"keywords\" content=\"targeted, keywords, separated, by, commas\" \u002F>\n\u003Cmeta name=\"author\" content=\"Full Name, Company\" \u002F>\n\u003Cmeta name=\"robots\" content=\"index, follow\" \u002F>\n\u003Cmeta name=\"referrer\" content=\"origin\" \u002F>\n\u003Cmeta name=\"theme-color\" content=\"#1e1e2e\" \u002F>\n\u003Clink rel=\"canonical\" href=\"https:\u002F\u002Fyour-site.vercel.app\u002F\" \u002F>\n\u003Clink rel=\"sitemap\" type=\"application\u002Fxml\" href=\"\u002Fsitemap.xml\" \u002F>\n```\n\n#### Open Graph & Twitter Cards\n\nFor rich link previews on Facebook, LinkedIn, Discord, Slack, and X\u002FTwitter:\n\n```html\n\u003C!-- Open Graph -->\n\u003Cmeta property=\"og:type\" content=\"website\" \u002F>\n\u003Cmeta property=\"og:url\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002F\" \u002F>\n\u003Cmeta property=\"og:title\" content=\"Your Name — Title | Company\" \u002F>\n\u003Cmeta property=\"og:description\" content=\"Rich description for social shares.\" \u002F>\n\u003Cmeta property=\"og:image\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002Fprofile.jpg\" \u002F>\n\u003Cmeta property=\"og:locale\" content=\"en_US\" \u002F>\n\n\u003C!-- Twitter Card -->\n\u003Cmeta name=\"twitter:card\" content=\"summary_large_image\" \u002F>\n\u003Cmeta name=\"twitter:title\" content=\"Your Name — Title | Company\" \u002F>\n\u003Cmeta name=\"twitter:description\" content=\"Rich description for X\u002FTwitter.\" \u002F>\n\u003Cmeta name=\"twitter:image\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002Fprofile.jpg\" \u002F>\n```\n\n#### JSON-LD Structured Data (Google & AI Crawlers)\n\nThis is the single most impactful addition for AI discoverability. ChatGPT, Google AI, and Perplexity parse JSON-LD directly.\n\n**Three-node pattern** (Person + Organization + WebSite):\n\n```html\n\u003Cscript type=\"application\u002Fld+json\">\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@graph\": [\n    {\n      \"@type\": \"Person\",\n      \"name\": \"Full Name\",\n      \"givenName\": \"First Name\",\n      \"description\": \"Rich bio — role, what you build, where.\",\n      \"birthDate\": \"2006\",\n      \"nationality\": { \"@type\": \"Country\", \"name\": \"Tanzania\" },\n      \"jobTitle\": \"Founder &amp; Engineer\",\n      \"knowsAbout\": [\"Swarm Robotics\", \"AI Agents\", \"Programming Language Design\"],\n      \"alumniOf\": \"University Name\",\n      \"affiliation\": {\n        \"@type\": \"Organization\",\n        \"name\": \"Your Company\",\n        \"description\": \"What the company does\"\n      },\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"sameAs\": [\"https:\u002F\u002Fgithub.com\u002Fyourhandle\"]\n    },\n    {\n      \"@type\": \"Organization\",\n      \"name\": \"Your Company\",\n      \"description\": \"Company description with subsidiary details.\",\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"foundingDate\": \"2026\",\n      \"founder\": { \"@type\": \"Person\", \"name\": \"Your Name\" },\n      \"subsidiary\": [\n        {\"@type\": \"Organization\", \"name\": \"Sub A\", \"description\": \"...\"},\n        {\"@type\": \"Organization\", \"name\": \"Sub B\", \"description\": \"...\"}\n      ]\n    },\n    {\n      \"@type\": \"WebSite\",\n      \"name\": \"Your Portfolio\",\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"description\": \"Portfolio site description.\"\n    }\n  ]\n}\n\u003C\u002Fscript>\n```\n\n**Key points:**\n- `@graph` wraps multiple nodes — cleanest way to describe a person + their company + their website in one block\n- `knowsAbout` is an array — list 5-8 core skills as plain strings\n- `sameAs` can include GitHub, LinkedIn, YouTube, X\u002FTwitter URLs\n- `alumniOf` helps establish credibility for young founders\n- All subsidiary companies within the holding company go under the Organization node\n\n#### Sitemap\n\nCreate `\u002Fsitemap.xml` at project root:\n\n```xml\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Curlset xmlns=\"http:\u002F\u002Fwww.sitemaps.org\u002Fschemas\u002Fsitemap\u002F0.9\">\n  \u003Curl>\n    \u003Cloc>https:\u002F\u002Fyour-site.vercel.app\u002F\u003C\u002Floc>\n    \u003Clastmod>2026-07-21\u003C\u002Flastmod>\n    \u003Cchangefreq>monthly\u003C\u002Fchangefreq>\n    \u003Cpriority>1.0\u003C\u002Fpriority>\n  \u003C\u002Furl>\n\u003C\u002Furlset>\n```\n\nLink it from the HTML `\u003Chead>`: `\u003Clink rel=\"sitemap\" type=\"application\u002Fxml\" href=\"\u002Fsitemap.xml\" \u002F>`\n\n#### Robots.txt\n\nCreate `\u002Frobots.txt` to explicitly welcome AI crawlers:\n\n```\nUser-agent: *\nAllow: \u002F\n\nUser-agent: GPTBot\nAllow: \u002F\n\nUser-agent: Claude-Web\nAllow: \u002F\n\nUser-agent: Googlebot\nAllow: \u002F\n\nSitemap: https:\u002F\u002Fyour-site.vercel.app\u002Fsitemap.xml\n```\n\n**Key point:** The default `Allow: \u002F` already permits all well-behaved crawlers. The explicit GPTBot and Claude-Web entries are a signal to AI companies that you want your content in their training data — some AI crawlers check for explicit opt-in before indexing.\n\n#### Alt Text for Images\n\nEvery `\u003Cimg>` should have descriptive alt text:\n\n```html\n\u003C!-- Bad -->\n\u003Cimg src=\"profile.jpg\" alt=\"Ibrahim\" \u002F>\n\n\u003C!-- Good -->\n\u003Cimg src=\"profile.jpg\" alt=\"Ibrahim — Founder &amp; Engineer at UMG Africa, Tanzania\" \u002F>\n```\n\nFor tool logos (Simple Icons chips), the `alt` attribute already carries the tool name — this is sufficient. For decorative SVGs (inline icon replacements), use `aria-hidden=\"true\"` instead of alt text.\n\n#### Verification\n\nAfter deploying, verify with curl:\n\n```bash\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c '\u003Cmeta '            # expect 15+\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'og:'              # expect 6\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'application\u002Fld+json'  # expect 1\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'rel=\"canonical\"'  # expect 1\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002Frobots.txt\" | head -3           # expect valid\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002Fsitemap.xml\" | head -3          # expect valid\n```\n\n**Pitfalls:**\n- JSON-LD must be valid JSON — no trailing commas, no HTML entities inside strings except `&amp;` for the `&` character. Use a JSON validator.\n- The `robots.txt` takes 24-48 hours for Google to re-crawl. It's not instant.\n- Open Graph images must be absolute URLs (`https:\u002F\u002F...`), not relative paths. Relative OG image URLs are silently ignored by all platforms.\n- `theme-color` meta tag sets the browser tab color on mobile Chrome. Use your dark background color so the tab doesn't flash white on page load.\n- Sitemap `lastmod` should be updated when significant content changes. For a single-page portfolio, monthly is reasonable.\n\n## Key Features\n\n1. **Glassmorphism Design** (both approaches):\n   - Semi-transparent backgrounds with backdrop blur\n   - Subtle borders for depth\n   - Proper contrast for readability (critical on dark themes)\n\n2. **Color Palette** (customizable per brand):\n   - Default: Olive (#3D9970), Light Green (#A8E6CF), Amber (#FFD700)\n   - Hybrid dark variant used in session: Green (#00d4aa), Green-dim (#00a884), Amber (#f5b342)\n   - **Principle:** pick 1 primary accent + 1 secondary accent (warm contrast). The primary should pop against the background. Gradient text titles using primary → secondary gradient.\n\n3. **Optional Interactive Features** (ask before building — not every founder wants these):\n   - **Profile photo upload** — SVG placeholder avatar with file-upload + localStorage persistence. User uploads their own photo and it survives page reloads. Implementation: inline SVG fallback, `\u003Cinput type=file>` hidden trigger, FileReader + localStorage save.\n   - **Interactive portfolio chatbot** — An AI-powered assistant that answers visitor questions about the founder's background, projects, skills, and contact info. Speed-dial toggle, intent-based response matching, suggestion chips for follow-up questions. See `references\u002Fportfolio-chatbot-implementation.md`.\n   - **Embedded educational game** — A visual programming puzzle themed around the founder's domain. 8+ levels teaching real concepts. Persistent progress in browser. **CRITICAL: always confirm with the founder before building a game — some consider games unprofessional on a portfolio and will ask for removal.** See `references\u002Fportfolio-game-implementation.md`.\n\n4. **Responsive Layout**:\n   - Mobile-first approach\n   - Flexible grid systems\n   - Media queries for all screen sizes\n\n5. **Complete Sections**:\n   - Hero section with call-to-action (profile photo + tagline grid layout for dark themes)\n   - About section with personal narrative (mission-driven, problem-first framing)\n   - Company\u002Fventures showcase (flywheel visualization for holding companies)\n   - Projects\u002Fportfolio gallery (alternating left-right card layout)\n   - Skills grid with category breakdown or animated progress bars (see Approach D)\n   - Integrations\u002Ftools grid section (see Approach E)\n   - Play\u002Fgame section (retention mechanic — confirm interest first)\n   - Contact section with social links\n   - Footer\n\n6. **Theme Toggle**: dual dark\u002Flight theme using Catppuccin palettes (see Approach C). Persistent across visits via localStorage. Toggle button in the nav bar. **Alternative: dark-only mode** — if the founder prefers permanent dark, strip the toggle entirely (see Approach C2).\n\n7. **Progress Bar Skills**: animated proficiency bars that fill from 0 to target width when scrolled into view (see Approach D).\n\n8. **Integrations \u002F Tools Grid**: categorical cards listing tools, platforms, and frameworks the founder uses — organised as icon-badge cards with tag clouds or brand logo chips from Simple Icons CDN (see Approaches E and G).\n\n9. **Custom SVG Backgrounds**: programmatic SVG textures that mirror the founder's engineering domain — circuit traces, geographic outlines, waveforms, glowing nodes. Generated via Python and saved as a standalone `.svg` referenced in CSS `background: url(...)`. Requires no external assets or CDN. See `references\u002Fcircuit-svg-background-pattern.md`.\n\n10. **AI Visibility & SEO**: JSON-LD structured data, Open Graph tags, Twitter Cards, sitemap, robots.txt, canonical URL, descriptive alt text, and comprehensive meta tags for discoverability by ChatGPT, Google AI, Perplexity, and search engines (see Approach I).\n\n## Workflow\n\n1. **Planning**:\n   - Define site structure based on user requirements\n   - Plan content organization\n   - Determine specific features needed\n\n2. **Design System**:\n   - Establish color palette (1 primary + 1 secondary accent)\n   - Define typography hierarchy\n   - Create glassmorphism component styles (lighter on light themes, subtle on dark themes)\n   - Plan responsive behavior\n\n3. **Implementation**:\n   - Build as a single self-contained HTML file (preferred — no build step, deployable anywhere)\n   - Write semantic HTML\n   - Implement CSS with glassmorphism effects\n   - Add JavaScript for interactivity (scroll reveals, nav, optional features)\n   - Ensure responsive design\n\n4. **Photo Integration** (when user already has a real photo):\n   - **Locate**: check `~\u002FDownloads\u002F` for \"WhatsApp Image\" or user-named files; use `ls -lt ~\u002FDownloads\u002F | head` to find the most recent\n   - **Choose frame shape before cropping**:\n     * **Circular frame** (default for portrait profiles): crop source image to square, then resize to 400x400.\n       ```python\n       from PIL import Image\n       img = Image.open('source.jpg')\n       min_dim = min(img.size)\n       left = (img.width - min_dim) \u002F\u002F 2\n       top = (img.height - min_dim) \u002F\u002F 2\n       img_square = img.crop((left, top, left + min_dim, top + min_dim))\n       img_resized = img_square.resize((400, 400), Image.LANCZOS)\n       img_resized.save('profile.jpg', 'JPEG', quality=85, optimize=True)\n       ```\n     * **Rectangle frame** (preferred by some founders — shows full body\u002Fportrait, more modern): do NOT crop to square. Preserve original aspect ratio. Resize width to ~300px and let height scale.\n       ```python\n       from PIL import Image\n       img = Image.open('source.jpg')\n       new_w = 300\n       new_h = int(img.height * new_w \u002F img.width)\n       img_resized = img.resize((new_w, new_h), Image.LANCZOS)\n       img_resized.save('profile.jpg', 'JPEG', quality=90, optimize=True)\n       ```\n       CSS changes for rectangle frame:\n       ```css\n       .profile-frame {\n           width: 300px; height: 420px;\n           border-radius: 16px; padding: 5px;\n       }\n       .profile-inner { border-radius: 12px; }\n       .profile-inner img { width: 100%; height: 100%; object-fit: cover; }\n       .profile-ring { display: none; }\n       ```\n   - **Default display pattern**: the `\u003Cimg>` tag should have `src=\"profile.jpg\"` and be visible by default; the SVG placeholder should be hidden (`style=\"display:none\"`) as a fallback for the upload flow. This is the **reverse** of the upload-only pattern where SVG is shown first.\n   - **Upload flow still works**: the FileReader + localStorage mechanism replaces `img.src` with the uploaded data URL on change, and restores from localStorage on page load — overriding the default `profile.jpg`.\n   - **Post-photo cleanup**: once the final photo is in place, the founder may want to remove the \"Upload your photo\" button entirely. Offer this as cleanup. To remove: delete the `\u003Cdiv class=\"photo-credit\">` block from HTML, and delete the photo upload JS section (FileReader listener + localStorage restore). This simplifies the page and removes unnecessary UI.\n\n5. **Deployment & Verification** (for static asset changes):\n   - `git add` the new\u002Fupdated assets and changed HTML\n   - Deploy: `vercel deploy --prod --yes --force` (the `--force` flag busts Vercel's CDN cache — critical for image changes)\n   - Verify with curl:\n     ```bash\n     curl -sI \"https:\u002F\u002F\u003Csite>.vercel.app\u002Fprofile.jpg\" | head -5\n     # Expect HTTP\u002F2 200\n     ```\n   - If the image is missing, check the HTML reference path — Vercel serves from project root, so `src=\"profile.jpg\"` resolves to `https:\u002F\u002Fsite.vercel.app\u002Fprofile.jpg`\n\n4. **Optional Interactive Features** (confirm interest first, then build):\n   - Propose options: theme toggle (dark\u002Flight), profile photo upload, chatbot, embedded game\n   - Let the founder choose which (if any) they want — never build all three\u002Flarge features by default\n   - **Theme toggle** is low-commitment — offer it early since it impresses and is ~50 lines of CSS+JS\n   - Profile photo with upload capability\n   - Portfolio chatbot with intent matching\n   - Embedded game themed to the founder's domain (only if confirmed)\n   - See reference files for implementation patterns\n\n5. **Assets**:\n   - Create placeholder images for projects\n   - Prepare icons (using inline SVG or Font Awesome)\n   - Optimize all assets for web\n\n5. **Testing**:\n   - Verify responsive behavior\n   - Check browser compatibility\n   - Test form validation\n   - Ensure accessibility standards\n\n## HTML Structure\n\nTwo viable approaches:\n\n### Option A: Single Self-Contained File (Recommended for simplicity)\n```\nindex.html  (all HTML + CSS + JS inline)\n```\n\nPreferred when there's no build step, no framework, and you want to deploy anywhere (Vercel, GitHub Pages, Netlify) with zero config. Best for founder\u002Fengineer portfolios with interactive features (game, chatbot).\n\n### Option B: Separate Directories (For larger projects)\n```\n- index.html\n- css\u002F\n  - styles.css\n- js\u002F\n  - main.js\n- assets\u002F\n  - images\u002F\n  - icons\u002F\n```\n\n## CSS Guidelines\n\n1. **Glassmorphism Implementation**:\n   ```css\n   .glass {\n     background: rgba(255, 255, 255, 0.85);\n     border-radius: 15px;\n     box-shadow: 0 8px 32px rgba(31, 38, 135, 0.37);\n     backdrop-filter: blur(10px);\n     -webkit-backdrop-filter: blur(10px);\n     border: 1px solid rgba(255, 255, 255, 0.18);\n   }\n   ```\n\n2. **Color Variables**:\n   ```css\n   :root {\n     --olive: #3D9970;\n     --light-green: #A8E6CF;\n     --amber: #FFD700;\n   }\n   ```\n\n3. **Responsive Design**:\n   - Mobile-first approach with media queries\n   - Flexible grids using CSS Grid and Flexbox\n   - Properly sized touch targets\n\n## JavaScript Functionality\n\n1. **Core**:\n   - Navigation: smooth scrolling, active link highlighting, mobile hamburger toggle\n   - Scroll reveal animations (IntersectionObserver)\n   - Glassmorphism hover effects on cards\n\n2. **Optional: Profile Photo Upload**:\n   - SVG placeholder avatar with circuit \u002F tech pattern\n   - Hidden `\u003Cinput type=\"file\">` triggered by label\n   - FileReader API to load image as data URL\n   - localStorage persistence so the photo survives page reloads\n   - **Default photo pattern**: if the user provides a real image, embed it as `\u003Cimg src=\"profile.jpg\">` visible by default, with the SVG hidden as fallback. The upload mechanism overrides `img.src` on new upload and restores from localStorage on page load — this way the site always shows a real face, even to first-time visitors.\n   - **Photo optimization**:\n     - **Circular frames** (default): crop to square, resize to 400x400, JPEG quality=85, optimize=True. Target ~25-35KB.\n     - **Rectangle frames**: preserve original aspect ratio, resize width to ~300px, JPEG quality=90, optimize=True. Target ~40-60KB for portrait shots.\n     - Always use `Image.LANCZOS` for downscaling (best quality).\n\n3. **Optional: Embedded Educational Game**:\n   - Grid-based visual programming puzzle themed to founder's domain\n   - Command palette (Forward, Left, Right, Repeat)\n   - Program list rendered as removable step chips\n   - Step-by-step execution with delay (simulates robot movement)\n   - Collision detection, boundary checking, win conditions\n   - Star rating system based on solution efficiency vs optimal\n   - Multi-level progression with browser localStorage persistence\n   - See `references\u002Fportfolio-game-implementation.md`\n\n4. **Optional: Portfolio Chatbot**:\n   - Floating action button (toggle open\u002Fclose)\n   - Chat panel with header, message area, input, suggestion chips\n   - Intent-matching response engine (regex keyword categories)\n   - Typing indicator simulation (delayed response)\n   - Markdown-like formatting in responses (bold, line breaks)\n   - See `references\u002Fportfolio-chatbot-implementation.md`\n\n## Verification\n\nBefore final delivery:\n1. Ensure all files are created in the correct structure\n2. Verify HTML is valid and semantic\n3. Check CSS for proper glassmorphism implementation\n4. Test JavaScript functionality\n5. Confirm responsive behavior across devices\n6. Validate form submission process\n\n## Content Strategy\n\n- **Position the founder's narrative** — don't just list what they build, explain WHY. Frame challenges as engineering opportunities. Mission-driven storytelling resonates more than feature lists.\n- **For holding companies \u002F multiple ventures**: use a flywheel visualization showing how each entity feeds the next. This communicates strategy, not just a list of brands.\n- **Interactive features**: confirm interest before building a game or chatbot. Some founders want a clean, professional portfolio without gamification. Offer the option, don't assume.\n\n## Pitfalls\n\n- Don't overuse glassmorphism effects (can impact readability, especially on dark themes with light text)\n- Ensure proper contrast for text on semi-transparent backgrounds — use text-shadow or solid-text variants on noisy backdrop-filter areas\n- Test performance of backdrop-filter on different devices (mobile Safari especially)\n- Don't forget to include fallbacks for older browsers\n- Make sure all interactive elements are accessible (keyboard navigation, ARIA labels)\n- **Custom SVG background opacity**: the background is a fixed `.svg` referenced via CSS `url()`. Keep overall opacity 0.03-0.08 so it textures without distracting. Use CSS `opacity` on the `::before` pseudo-element that loads it, not on the SVG itself — this allows the SVG to remain at full opacity for visual quality while the CSS layer controls the dimming.\n- **Custom SVG background file size**: a full-viewport circuit SVG with Africa outline and waveforms is ~20KB. That's acceptable, but avoid embedding raster images or complex gradients inside the SVG — keep it as vector lines and simple fills only.\n- **Custom SVG background viewport coverage**: use `background: url('bg.svg') center center \u002F cover no-repeat` so the SVG scales to fill any screen size. The SVG viewBox should be `0 0 1440 900` (a common laptop screen ratio) — elements near the edges may clip on ultrawide or portrait screens, but the low opacity makes this unnoticeable.\n- **Profile photo SVG placeholder**: ensure the SVG is visually appealing as a fallback — if the user never uploads a photo, the placeholder is their permanent avatar. Circuit\u002Fpattern SVGs work better than generic silhouettes for tech founders.\n- **Game levels**: design levels that progressively teach concepts (sequence → turns → loops → pathfinding). The game should be beatable but challenging. Always provide a \"Reset level\" option.\n- **Chatbot intent matching**: regex-based matching is simple and fast but misses typos. The suggestion chips pattern compensates — offer 3-4 contextual follow-ups after each response so users can click instead of type.\n- **Chatbot scope**: keep the knowledge base focused. A portfolio chatbot should know about the person's background, projects, skills, and contact info — not attempt general conversation.\n- **Confirm interactive features upfront**: before building a game, chatbot, or photo upload, verify the founder actually wants it. A developer who asked for a \"good portfolio to shine in the tech world\" may not want a game on it. Phrase as: \"I can add a game, chatbot, or photo upload if you'd like — or keep it clean. What suits your style?\" This avoids wasted work and the awkward removal conversation.\n- **When game is removed**: replace with a testimonial section, timeline\u002Fmilestones, or expanded project details. The portfolio should still feel complete without it. The chatbot suggestion chips and greeting should also be updated to remove game references.\n- **Default photo display**: when embedding a real photo, reverse the default visibility. The `\u003Cimg>` with the real photo should be visible (`display:block` or default inline) and the SVG placeholder should be hidden (`style=\"display:none\"`). The upload JavaScript should then modify the img.src (not toggle visibility between two elements). This prevents a flash of the SVG placeholder before the page JS runs.\n- **Deployment verification for assets**: after deploying images or static files to Vercel, verify with curl before assuming it worked. Vercel's CDN sometimes caches old versions of the HTML that reference missing images. Check: `curl -sI \"https:\u002F\u002F\u003Csite>.vercel.app\u002F\u003Casset>\" | head -5` — expect HTTP 200. Also check the HTML serves correctly: `curl -s \"https:\u002F\u002F\u003Csite>.vercel.app\u002F\" | grep 'src=\"profile.jpg\"'`\n\n### 🔴 Critical: Scroll-Reveal Animation Selector Bug\n\nWhen using `IntersectionObserver` for scroll-reveal animations, **never** use `document.querySelector('.reveal')` — this returns only the FIRST matching element. All other `.reveal` elements will remain invisible (opacity: 0) and never animate in, making the page appear broken or blank below the fold.\n\n**Always do this instead:**\n```javascript\n\u002F\u002F CORRECT — observes EVERY .reveal element individually\ndocument.querySelectorAll('.reveal').forEach(el => {\n    new IntersectionObserver((entries) => {\n        entries.forEach(e => {\n            if (e.isIntersecting) e.target.classList.add('visible');\n        });\n    }, { threshold: 0.1, rootMargin: '0px 0px -40px 0px' }).observe(el);\n});\n```\n\n**Why this is critical:** the page loads, CSS sets `.reveal { opacity: 0 }`, JS only attaches the observer to the first element. All sections below the hero stay transparent. The user sees a blank page and reports \"it doesn't load.\" Vercel's CDN can make the fix appear to not deploy — always force a `vercel deploy --prod --yes --force` after this fix, then hard-refresh in the browser (Ctrl+Shift+R \u002F Cmd+Shift+R).\n\nThis selector pitfall applies generally: anytime you query elements by class to attach behavior, default to `querySelectorAll` + iteration unless you have a specific reason to target only the first match.\n\n### 🔴 User Preference: Emoji-Free Portfolios (Deep-Tech Founders)\n\n**Some founders explicitly want zero emoji on their portfolio.** This is especially common for deep-tech \u002F engineering profiles where emoji can feel informal, unprofessional, or out of character. When building a portfolio for an AI\u002Frobotics\u002Fengineering founder:\n\n- **Ask upfront** during the planning phase: \"Do you prefer emoji or clean SVG icons on the skill badges, section headers, and cards?\" Defaulting to icons saves a correction cycle.\n- **If they say \"replace emojis with icons\" or \"use icons instead of emoji\"** — apply the full Mass Emoji→SVG Replacement (Approach H) across every section: skill names, integration category icons, about stat cards, flywheel cards, contact links, chatbot, footer, and even the favicon.\n- **Chatbot text** is a common oversight — emoji in JS string literals (greetings, responses) must be manually stripped. They can't hold SVG elements.\n- **The theme toggle button** uses moon\u002Fsun emoji. If going dark-only (Approach C2), the toggle is removed entirely, solving this naturally. If keeping the toggle, replace the moon\u002Fsun emoji with SVG versions using `innerHTML` instead of `textContent`.\n- **After replacement, verify with a character-range scan** (see Approach H Verification) — don't rely on visual review alone. Emoji can hide in JS strings, the favicon, and CSS `content:` pseudo-elements.\n\n## Reference Files\n\nThis skill includes the following reference files:\n\n- `references\u002Fibrahim-portfolio-2026.md` — Full case study of a hybrid dark-theme portfolio for a Tanzanian deep-tech founder (photo upload, chatbot, and the build-then-remove cycle of an embedded game).\n- `references\u002Fportfolio-game-implementation.md` — Pattern for building an embedded educational game (level system, grid rendering, execution engine, star ratings).\n- `references\u002Fportfolio-chatbot-implementation.md` — Pattern for building a portfolio chatbot (intent matching, suggestion chips, UI components).\n- `references\u002Fcircuit-svg-background-pattern.md` — Programmatic SVG background generator: circuit traces, geographic outlines, data waveforms, glowing nodes. Full Python script with customization guide.\n- `references\u002Fcatppuccin-portfolio-pattern.md` — Complete implementation of the Catppuccin dual-theme system (Mocha dark + Latte light), progress bar skills with animated fills, and integrations\u002Ftools grid section. CSS variables, theme toggle JS, grid layouts, and all category icons.","# Portfolio Website Design\n\nThis skill creates full portfolio websites with modern design elements including glassmorphism effects and a specific color palette of olive, light green, and amber.\n\n## When To Use\n\nUse this skill when the user requests:\n- A complete portfolio website\n- Modern design with glassmorphism effects\n- Specific color schemes (olive, light green, amber)\n- Responsive layouts for all device sizes\n- Professional presentation of projects and services\n\n## Design Approaches\n\n### Approach A: Glassmorphism (Light)\nThe classic glassmorphism look — semi-transparent cards on a light or patterned background. Best for creative\u002Fdesign portfolios.\n\n### Approach B: Dark Theme + Glass Elements (Hybrid)\nA dark background (#08080e range) with glass cards overlaid. The glass provides depth against the dark, while the dark background gives a premium, engineering\u002Fproduct feel. Preferred by technical founders, robotics\u002FAI engineers, and deep-tech builders.\n\n_This session produced a hybrid portfolio for a Tanzanian deep-tech founder — see `references\u002Fibrahim-portfolio-2026.md` for the full case study._\n\n### Approach C: Catppuccin Dual-Theme System (Dark\u002FLight Toggle)\n\nA complete dual-theme system using Catppuccin's Mocha (dark) and Latte (light) palettes. The user gets a persistent theme toggle (🌙\u002F☀️) in the navigation bar — their choice is saved to localStorage and survives reloads.\n\n#### C1: Dual Theme (Toggle Available)\n\n_See `references\u002Fcatppuccin-portfolio-pattern.md` for the full CSS variables, toggle HTML, and JS implementation._\n\n#### C2: Dark-Only Mode (No Toggle)\n\nSome founders prefer a permanent dark theme — no light mode, no toggle button, no flash of light on page load. This is common for deep-tech \u002F engineering profiles where dark mode signals a \"serious tools\" aesthetic.\n\n**To convert a dual-theme portfolio to dark-only:**\n\n1. **Remove the light CSS block entirely** — delete the entire `[data-theme=\"light\"] { ... }` ruleset. Only `:root` (dark) remains.\n2. **Fix the CSS comment** — change `:root, [data-theme=\"dark\"]` to just `:root` and update the comment to reflect dark-only.\n3. **Remove the theme toggle HTML** — delete the `\u003Cbutton class=\"theme-toggle\" id=\"themeToggle\">` element from the nav.\n4. **Remove the theme toggle CSS** — delete the `.theme-toggle { ... }` and `.theme-toggle:hover { ... }` rule blocks.\n5. **Remove the theme toggle JS** — delete the entire `const themeToggle = ... addEventListener('click', ...)` block. Renumber any remaining JS sections.\n6. **Remove `data-theme` from `\u003Chtml>`** — change `\u003Chtml lang=\"en\" data-theme=\"dark\">` to `\u003Chtml lang=\"en\">`. The CSS defaults are now dark without needing the attribute.\n7. **Replace all toggle-related emojis** — the moon\u002Fsun on the button and in JS are gone automatically with the toggle removal.\n\n**Verification after dark-only conversion:**\n```bash\ngrep -c '\\\\[data-theme=\"light\"\\\\]' index.html     # expect 0\ngrep -c 'themeToggle' index.html                 # expect 0\ngrep -c 'Latte' index.html                       # expect 0\n```\n\n**Pitfalls:**\n- If you remove `data-theme=\"dark\"` from `\u003Chtml>` but keep `[data-theme=\"dark\"]` in CSS, the page still works but the selector is an empty constraint. Clean both for a single source of truth.\n- The `--btn-text` variable (dark text on light buttons) must remain — it's not a light-theme artifact, it's needed for contrast even in dark mode.\n- The `--glass` and `--glass-border` values for dark mode (semi-transparent white) stay as-is.\n- Gradient orbs continue working — their `--orb-*-bg` variables were already dark-specific.\n\n### Approach D: Progress Bar Skills with Animated Proficiency\n\nFor engineering\u002Ftechnical portfolios, replace (or supplement) the standard tag-skill categories with **animated progress bars** that show proficiency levels by domain. Especially effective for audiences who want to see depth: embedded engineers, AI developers, and mechatronics founders.\n\n**Implementation** (see `references\u002Fcatppuccin-portfolio-pattern.md` for complete code):\n\n```html\n\u003Cdiv class=\"skill-progress-item\">\n    \u003Cdiv class=\"skill-progress-header\">\n        \u003Cspan class=\"skill-name\">⚙️ Embedded Systems\u003C\u002Fspan>\n        \u003Cspan class=\"skill-pct\">90%\u003C\u002Fspan>\n    \u003C\u002Fdiv>\n    \u003Cdiv class=\"skill-progress-track\">\n        \u003Cdiv class=\"skill-progress-fill\" style=\"width:90%\">\u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n```\n\n**CSS pattern:**\n- `.skill-progress-track`: full-width `8px` height, `border-radius: 100px`, background uses `--surface0`.\n- `.skill-progress-fill`: height `100%`, `border-radius: 100px`, `background: linear-gradient(90deg, var(--green), var(--teal))`, default `width: 0%`, transitions via `transition: width 1.2s cubic-bezier(0.16,1,0.3,1)`.\n- The `width: X%` is set as an inline style on each `.skill-progress-fill`. The scroll-reveal (`IntersectionObserver`) triggers the `.visible` class. With `transition` on the fill, the bars animate from 0 to their target width when they enter the viewport. **No JS needed beyond the existing reveal observer** — CSS transition handles the animation.\n- Container grid: `grid-template-columns: 1fr 1fr` (collapses to 1fr below 900px).\n\n**Pitfalls:**\n- Don't set `width` on the fill in CSS — use inline `style=\"width:X%\"` so each bar has a different value.\n- Proficiency percentages should be **credible, not inflated**. A 19-year-old engineer with 90% in everything looks fake. Use 70-90% range for core domains, lower for secondary skills.\n- The scroll-reveal animation fires once per element. After the bar animates to its target width, it stays there. No additional JS needed.\n\n### Approach E: Integrations \u002F Tools Grid Section\n\nA dedicated section listing tools, platforms, and frameworks the founder works with. Organised into **categorical cards** with colour-coded icon badges and tag clouds. Best placed after the Skills section, labelled \"Tools & Integrations\" or \"My Stack\".\n\n**Implementation** (full code in `references\u002Fcatppuccin-portfolio-pattern.md`):\n\n- 5-card grid (auto-fill, min 260px) with coloured icon badges per category:\n  - AI & Cloud Platforms (mauve badge)\n  - PCB Design & CAD (blue badge)\n  - Languages & Frameworks (green badge)\n  - Hardware & Embedded (peach badge)\n  - Agentic & Automation (pink badge)\n- Each card: header row with coloured icon `div` + title\u002Fsubtitle, then a `\u003Cdiv class=\"int-tags\">` with `\u003Cspan>` chips for each tool.\n- Nav link in the nav bar (e.g. \"Tools\") that scrolls to `#integrations`.\n\n**Pitfalls:**\n- Card icon backgrounds use `color-mix(in srgb, var(--mauve) 20%, transparent)` — this adapts to both dark and light themes without hardcoded rgba.\n- This section works best as a **visual complement** to the skills section, not a replacement. Skills says \"how good I am\", Integrations says \"what I actually use\".\n- **Some founders prefer SVG icons over emoji** for the category header icons. Offer the choice. SVGs look more premium on engineering\u002Ftechnical portfolios. Use inline Lucide-style `\u003Csvg>` elements with `currentColor` so they adapt to both dark and light themes.\n- **Variant: Brand Logo Tool Chips** — Instead of plain `\u003Cspan>` text tags, you can render each tool as a pill with its official logo from the Simple Icons CDN (`https:\u002F\u002Fcdn.simpleicons.org\u002F{slug}\u002Ffff`). See Approach G below for full implementation.\n\n### Approach F: Custom SVG Background Texture\nFor deep-tech \u002F engineering portfolios, replace the grid or solid dark background with a **programmatically generated SVG** that mirrors the founder's domain:\n\n- **Circuit traces**: horizontal bus lines, vertical bus lines, diagonal data paths — drawn as thin lines at low opacity (0.02–0.06)\n- **Glowing vias\u002Fnodes**: small circles at trace intersections with SVG blur filters (feGaussianBlur)\n- **Geographic outline**: a subtle polygon of the founder's continent\u002Fcountry — grounds the portfolio in place\n- **Data waveforms**: `\u003Cpolyline>` with sine-wave math (sin + sin harmonics) across the full viewport width\n- **Binary \u002F data stream accents**: text elements with \"01001110\" patterns in corners\n- **Ambient orbs**: large blurred radial gradient circles that float via CSS animation (inherits from the orb system)\n\nThis background should be **extremely subtle** (overall opacity 0.03-0.08) — it's a premium texture, not a wallpaper. Content readability always comes first.\n\nSee `references\u002Fcircuit-svg-background-pattern.md` for the full generation pattern and Python script.\n\n### Approach G: Brand Logo Tool Chips (Simple Icons CDN)\n\nFor the integrations grid, replace plain `\u003Cspan>` text tags with **brand logo chips** — each tool appears as a small pill with its official logo from the Simple Icons CDN. This dramatically increases visual polish and credibility.\n\n**How it works:**\n\n```html\n\u003Cspan class=\"tool-chip\">\n    \u003Cimg class=\"tool-logo\" src=\"https:\u002F\u002Fcdn.simpleicons.org\u002Fanthropic\u002Ffff\"\n         alt=\"Anthropic\" loading=\"lazy\"\n         onerror=\"this.style.display='none';this.nextElementSibling.style.display='flex'\">\n    \u003Cspan class=\"tool-logo-fallback\" style=\"background:#d97757\">A\u003C\u002Fspan>\n    \u003Cspan class=\"tool-chip-name\">Anthropic\u003C\u002Fspan>\n\u003C\u002Fspan>\n```\n\nThe `\u003Cimg>` attempts to load the official SVG logo from the CDN. On failure (no icon for that slug), the `onerror` handler hides the image and reveals the `.tool-logo-fallback` span — a colored letter-initial badge. This means **every tool always has a visual**, even obscure ones without a Simple Icons entry.\n\n**CSS pattern:**\n```css\n.tool-grid { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 14px; }\n.tool-chip {\n    display: inline-flex; align-items: center; gap: 7px;\n    padding: 6px 12px; border-radius: 8px;\n    background: var(--surface0); border: 1px solid var(--glass-border);\n    transition: all 0.2s; cursor: default;\n}\n.tool-chip:hover {\n    transform: translateY(-2px);\n    border-color: color-mix(in srgb, var(--mauve) 30%, transparent);\n}\n.tool-chip img.tool-logo { width: 18px; height: 18px; object-fit: contain; flex-shrink: 0; }\n.tool-logo-fallback {\n    width: 18px; height: 18px; border-radius: 4px;\n    display: none; align-items: center; justify-content: center;\n    font-size: 10px; font-weight: 700; color: #fff; flex-shrink: 0;\n}\n.tool-chip-name { font-size: 0.75rem; font-weight: 500; white-space: nowrap; }\n```\n\n**Sizing guide:** Logo = 18×18px. Chip padding = 6px 12px. These are compact enough to fit many in a row on desktop, but large enough to be readable and touch-friendly.\n\n**Integration with Approach E:** Replace `\u003Cdiv class=\"int-tags\">` with `\u003Cdiv class=\"tool-grid\">`. Keep the card framework (header, icon badge, title, subtitle) identical. The card categories and colored icon badges remain.\n\n**Pitfalls:**\n- Simple Icons CDN is a third-party dependency (3100+ brands, MIT-licensed). The onerror+fallback pattern means zero visual breakage if the CDN is down — it degrades to colored initials.\n- Not every tool has a Simple Icons entry (e.g., Gazebo, Railway, Ollama). Assign a reasonable brand-hex color for the fallback background.\n- `\u002Ffff` renders the icon white. Works on dark chip backgrounds. For light theme, use `...\u002F000` or omit the suffix for the default colored icon. Since icons are tiny (18px), a single white-on-semi-dark-chip style works acceptably in both themes with the fallback providing brand color.\n- Loading from CDN adds ~44 HTTP requests (one per tool). Each SVG is ~200-800 bytes. Total page weight impact is negligible (~20KB). Use `loading=\"lazy\"` on each `\u003Cimg>`.\n- Simple Icons' URL pattern follows `https:\u002F\u002Fcdn.simpleicons.org\u002F{slug}\u002Fcolor` — the `\u002Ffff` suffix overrides the color to white. For brand-colored icons (e.g., if the chip background changes), omit the suffix.\n\n### Approach H: Mass Emoji→SVG Icon Replacement\n\nSome founders want **zero emoji** on their portfolio — everything replaced with clean SVG icons. This is common for deep-tech and engineering profiles where emoji can feel informal. This approach covers the full-site migration.\n\n#### When to apply\n\nOffer this when:\n- The user says \"no emoji, use icons\", \"replace emojis with icons\", or \"make it look more premium\"\n- During the initial build, before showing the founder a draft (ask: \"Do you prefer emoji or icons on the skill badges and section headers?\")\n- As a polish pass after the first deploy\n\n#### Icon source: inline Lucide-style SVGs\n\nUse inline `\u003Csvg>` elements from the Lucide icon set (MIT license, ~800 icons). Every icon is a self-contained `viewBox=\"0 0 24 24\"` with `fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"`. They automatically inherit the text color via `currentColor` and adapt to both theme modes.\n\n**Key icons used in the production portfolio:**\n\n| Context | Lucide icon name | SVG path count |\n|---------|-----------------|----------------|\n| About: Mind\u002FBrain | `brain` | 6 paths |\n| About: AI\u002FRobotics | `bot` | 4 paths + 1 rect + 1 circle |\n| About: Code | `code-2` (angle brackets) | 2 polylines |\n| About: Satellite\u002FTech | `hard-drive` | 4 paths |\n| Flywheel: Growth | `sprout` | 2 paths |\n| Flywheel: Connection | `link-2` | 2 paths |\n| Flywheel: Swarm | (custom ant\u002Fbug) | 8 paths |\n| Flywheel: Ghost\u002Flanguage | `ghost` | 7 paths |\n| Flywheel: Water\u002Fspace | `droplet` | 1 path |\n| Skills: Settings\u002FEmbedded | `settings` (gear) | 12 paths |\n| Skills: AI Agentic | `bot` | 4 paths + 1 rect + 1 circle |\n| Skills: AI\u002FLLMs | `brain` | 6 paths |\n| Skills: Mobile | `smartphone` | 1 rect + 1 line |\n| Skills: IoT | `globe` | 1 circle + 1 line + 1 ellipse path |\n| Skills: Mechatronics | `wrench` | 3 paths |\n| Skills: Full-Stack | `monitor` | 1 rect + 2 lines |\n| Skills: PCB Design | `hexagon` (hex grid) | 3 lines + 1 polygon |\n| Integrations: Cloud | `cloud` | 1 path |\n| Integrations: Circuit | `cpu` \u002F `rectangle` | 3 paths + 1 rect |\n| Integrations: Languages | `code-2` | 2 polylines |\n| Integrations: Hardware | `microchip` | 5 lines + 1 rect |\n| Integrations: Agentic | `settings` (gear) | 12 paths |\n| Nav\u002FFooter: Globe | `globe` | 1 circle + 1 line + 1 ellipse path |\n| Email | `mail` | 1 rect + 1 path |\n| LinkedIn | `linkedin` | 1 path + 1 rect + 1 circle |\n| GitHub | `github` | 2 polylines |\n| X\u002FTwitter | `x` | 2 lines |\n| YouTube | `youtube` | 1 polygon |\n| Chat (closed) | `message-circle` | 1 path |\n| Chat (close\u002FX) | `x` | 2 lines |\n| Chat send | `send` | 1 line + 1 polygon |\n| Play button | `play` | 1 polygon |\n| Lightning\u002Fenergy | `zap` | 1 polygon |\n| Check\u002Fcorrect | `check` | 1 polyline |\n\n#### Mass replacement technique\n\nUse a Python script with a `replacements` array to batch-find every emoji in the HTML and replace it with its SVG equivalent:\n\n```python\nwith open('index.html', 'r') as f:\n    content = f.read()\n\nreplacements = [\n    # About stat cards\n    ('\u003Cdiv class=\"icon\">🧠\u003C\u002Fdiv>', '\u003Cdiv class=\"icon\">\u003Csvg width=\"1em\" ...brain paths...>\u003C\u002Fsvg>\u003C\u002Fdiv>'),\n    ('\u003Cdiv class=\"icon\">🤖\u003C\u002Fdiv>', '\u003Cdiv class=\"icon\">\u003Csvg width=\"1em\" ...bot paths...>\u003C\u002Fsvg>\u003C\u002Fdiv>'),\n    # ... every emoji occurrence ...\n]\n\nfor old, new in replacements:\n    if old in content:\n        content = content.replace(old, new)\n        print(f\"✓ Replaced: {old[:30]}...\")\n    else:\n        print(f\"✗ NOT FOUND: {old[:40]}...\")\n\nwith open('index.html', 'w') as f:\n    f.write(content)\n```\n\n**Where emojis typically hide:**\n\n| Location | Typical emojis |\n|----------|---------------|\n| Skill names (progress bar labels) | ⚙️ 🤖 🧠 📱 🌐 🔧 💻 📐 |\n| Integration category icons | ☁️ 🔬 ⌨️ 🔌 🧩 |\n| About stat card icons | 🧠 🤖 ⌨️ 🛰️ |\n| Flywheel card emoji spans | 🌿 🔗 🐜 👻 💧 |\n| Project visual placeholders | 🐜 👻 🌿 🔗 💧 |\n| Contact link labels | 📧 💻 🐦 🔗 ▶ |\n| Nav link CTA \u002F section labels | Various |\n| Chatbot JS strings (greetings, responses) | 👋 😊 🤔 🌍 🤝 💪 🌟 |\n| Footer | 🌍 or similar globe |\n| Chat toggle \u002F send buttons | 💬 ✕ ➤ |\n| YouTube section | 🎬 ▶ |\n| Favicon (data URI) | ⚡ in `\u003Ctext>` element |\n\n**Chatbot JS strings require special handling:** Emojis embedded in JavaScript string literals (the chatbot's response objects) need text equivalents or trimming. Example:\n\n```python\n# JS string replacements (strip emoji from chatbot response text)\njs_emoji_fixes = [\n    (' from Africa. 🌍', ' from Africa.'),\n    ('anything! 😊', 'anything!'),\n    ('👋 I\\'m Ibrahim\\'s virtual', 'I\\'m Ibrahim\\'s virtual'),\n    ('you? 🤔', 'you?'),\n]\nfor old, new in js_emoji_fixes:\n    content = content.replace(old, new)\n```\n\n#### Favicon (no-emoji variant)\n\nReplace an emoji-based favicon (`\u003Ctext y='.9em' font-size='90'>⚡\u003C\u002Ftext>`) with an inline SVG polygon:\n\n```html\n\u003Clink rel=\"icon\" type=\"image\u002Fsvg+xml\"\n      href=\"data:image\u002Fsvg+xml,&lt;svg xmlns='http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg' viewBox='0 0 100 100'&gt;&lt;polygon points='60,10 20,55 50,55 40,90 80,45 50,45' fill='%23a6e3a1'\u002F&gt;&lt;\u002Fsvg&gt;\">\n```\n\n**Key points:** URL-encode the `\u003C` and `>` as `&lt;` and `&gt;` in the data URI to avoid HTML parser conflicts. The `%23` encodes the `#` in hex colors.\n\n#### Verification\n\nAfter replacement, verify zero emoji remain:\n\n```python\nremaining = []\nfor i, ch in enumerate(content):\n    cp = ord(ch)\n    if (0x1F300 \u003C= cp \u003C= 0x1F9FF) or (0x2600 \u003C= cp \u003C= 0x27BF):\n        remaining.append(f'U+{cp:04X} {ch} at pos {i}')\nif remaining:\n    print(f'{len(remaining)} emojis remaining:')\n    for r in remaining:\n        print(r)\nelse:\n    print('✅ Zero emojis!')\n```\n\nThe only expected survivor is the favicon if it still uses an emoji — intentionally replace it with a polygon.\n\n#### Pitfalls\n\n- **Every emoji occurrence is a separate entry in the replacements array.** There's no one-size-fits-all regex for this. Expect 30-50 replacements for a full portfolio.\n- **Inline SVGs in chatbot JS strings:** The chatbot responses are JS string literals, not HTML. You cannot put `\u003Csvg>...\u003C\u002Fsvg>` inside a JS string used as `textContent`. Instead, strip the emoji and use clean text. The chatbot's greeting becomes \"Hi! I'm Ibrahim's virtual assistant.\" instead of \"👋 Hi! I'm...\".\n- **Chat toggle button emoji→SVG swap uses innerHTML, not textContent.** After replacing the emoji with an SVG, the JS that toggles the button must also use `innerHTML = '\u003Csvg>...'` instead of `textContent = '💬'`. Update both the initial HTML and the JS toggle handler.\n- **Preserve JS string integrity.** When you replace emoji inside JS strings (greetings, responses), only remove the emoji character — don't break the string delimiters or escape sequences.\n- **Deploy and hard-refresh.** After the replacement, force a Vercel deploy with `--force` flag to CDN-bust: `vercel deploy --prod --yes --force`. Users must hard-refresh (Ctrl+Shift+R) since the old HTML may be cached by the browser, not just the CDN.\n\n### Approach I: AI Visibility & SEO for Portfolio Sites\n\nMaking a portfolio discoverable by AI crawlers (ChatGPT, Perplexity, Google AI) and search engines requires structured data and proper meta tags. Apply this after the visual design is final.\n\n#### Required Meta Tags\n\nInclude these in `\u003Chead>`:\n\n```html\n\u003Ctitle>Your Name — Title | Company — Tagline\u003C\u002Ftitle>\n\u003Cmeta name=\"description\" content=\"155-char rich summary with keywords, role, and location.\" \u002F>\n\u003Cmeta name=\"keywords\" content=\"targeted, keywords, separated, by, commas\" \u002F>\n\u003Cmeta name=\"author\" content=\"Full Name, Company\" \u002F>\n\u003Cmeta name=\"robots\" content=\"index, follow\" \u002F>\n\u003Cmeta name=\"referrer\" content=\"origin\" \u002F>\n\u003Cmeta name=\"theme-color\" content=\"#1e1e2e\" \u002F>\n\u003Clink rel=\"canonical\" href=\"https:\u002F\u002Fyour-site.vercel.app\u002F\" \u002F>\n\u003Clink rel=\"sitemap\" type=\"application\u002Fxml\" href=\"\u002Fsitemap.xml\" \u002F>\n```\n\n#### Open Graph & Twitter Cards\n\nFor rich link previews on Facebook, LinkedIn, Discord, Slack, and X\u002FTwitter:\n\n```html\n\u003C!-- Open Graph -->\n\u003Cmeta property=\"og:type\" content=\"website\" \u002F>\n\u003Cmeta property=\"og:url\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002F\" \u002F>\n\u003Cmeta property=\"og:title\" content=\"Your Name — Title | Company\" \u002F>\n\u003Cmeta property=\"og:description\" content=\"Rich description for social shares.\" \u002F>\n\u003Cmeta property=\"og:image\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002Fprofile.jpg\" \u002F>\n\u003Cmeta property=\"og:locale\" content=\"en_US\" \u002F>\n\n\u003C!-- Twitter Card -->\n\u003Cmeta name=\"twitter:card\" content=\"summary_large_image\" \u002F>\n\u003Cmeta name=\"twitter:title\" content=\"Your Name — Title | Company\" \u002F>\n\u003Cmeta name=\"twitter:description\" content=\"Rich description for X\u002FTwitter.\" \u002F>\n\u003Cmeta name=\"twitter:image\" content=\"https:\u002F\u002Fyour-site.vercel.app\u002Fprofile.jpg\" \u002F>\n```\n\n#### JSON-LD Structured Data (Google & AI Crawlers)\n\nThis is the single most impactful addition for AI discoverability. ChatGPT, Google AI, and Perplexity parse JSON-LD directly.\n\n**Three-node pattern** (Person + Organization + WebSite):\n\n```html\n\u003Cscript type=\"application\u002Fld+json\">\n{\n  \"@context\": \"https:\u002F\u002Fschema.org\",\n  \"@graph\": [\n    {\n      \"@type\": \"Person\",\n      \"name\": \"Full Name\",\n      \"givenName\": \"First Name\",\n      \"description\": \"Rich bio — role, what you build, where.\",\n      \"birthDate\": \"2006\",\n      \"nationality\": { \"@type\": \"Country\", \"name\": \"Tanzania\" },\n      \"jobTitle\": \"Founder &amp; Engineer\",\n      \"knowsAbout\": [\"Swarm Robotics\", \"AI Agents\", \"Programming Language Design\"],\n      \"alumniOf\": \"University Name\",\n      \"affiliation\": {\n        \"@type\": \"Organization\",\n        \"name\": \"Your Company\",\n        \"description\": \"What the company does\"\n      },\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"sameAs\": [\"https:\u002F\u002Fgithub.com\u002Fyourhandle\"]\n    },\n    {\n      \"@type\": \"Organization\",\n      \"name\": \"Your Company\",\n      \"description\": \"Company description with subsidiary details.\",\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"foundingDate\": \"2026\",\n      \"founder\": { \"@type\": \"Person\", \"name\": \"Your Name\" },\n      \"subsidiary\": [\n        {\"@type\": \"Organization\", \"name\": \"Sub A\", \"description\": \"...\"},\n        {\"@type\": \"Organization\", \"name\": \"Sub B\", \"description\": \"...\"}\n      ]\n    },\n    {\n      \"@type\": \"WebSite\",\n      \"name\": \"Your Portfolio\",\n      \"url\": \"https:\u002F\u002Fyour-site.vercel.app\",\n      \"description\": \"Portfolio site description.\"\n    }\n  ]\n}\n\u003C\u002Fscript>\n```\n\n**Key points:**\n- `@graph` wraps multiple nodes — cleanest way to describe a person + their company + their website in one block\n- `knowsAbout` is an array — list 5-8 core skills as plain strings\n- `sameAs` can include GitHub, LinkedIn, YouTube, X\u002FTwitter URLs\n- `alumniOf` helps establish credibility for young founders\n- All subsidiary companies within the holding company go under the Organization node\n\n#### Sitemap\n\nCreate `\u002Fsitemap.xml` at project root:\n\n```xml\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Curlset xmlns=\"http:\u002F\u002Fwww.sitemaps.org\u002Fschemas\u002Fsitemap\u002F0.9\">\n  \u003Curl>\n    \u003Cloc>https:\u002F\u002Fyour-site.vercel.app\u002F\u003C\u002Floc>\n    \u003Clastmod>2026-07-21\u003C\u002Flastmod>\n    \u003Cchangefreq>monthly\u003C\u002Fchangefreq>\n    \u003Cpriority>1.0\u003C\u002Fpriority>\n  \u003C\u002Furl>\n\u003C\u002Furlset>\n```\n\nLink it from the HTML `\u003Chead>`: `\u003Clink rel=\"sitemap\" type=\"application\u002Fxml\" href=\"\u002Fsitemap.xml\" \u002F>`\n\n#### Robots.txt\n\nCreate `\u002Frobots.txt` to explicitly welcome AI crawlers:\n\n```\nUser-agent: *\nAllow: \u002F\n\nUser-agent: GPTBot\nAllow: \u002F\n\nUser-agent: Claude-Web\nAllow: \u002F\n\nUser-agent: Googlebot\nAllow: \u002F\n\nSitemap: https:\u002F\u002Fyour-site.vercel.app\u002Fsitemap.xml\n```\n\n**Key point:** The default `Allow: \u002F` already permits all well-behaved crawlers. The explicit GPTBot and Claude-Web entries are a signal to AI companies that you want your content in their training data — some AI crawlers check for explicit opt-in before indexing.\n\n#### Alt Text for Images\n\nEvery `\u003Cimg>` should have descriptive alt text:\n\n```html\n\u003C!-- Bad -->\n\u003Cimg src=\"profile.jpg\" alt=\"Ibrahim\" \u002F>\n\n\u003C!-- Good -->\n\u003Cimg src=\"profile.jpg\" alt=\"Ibrahim — Founder &amp; Engineer at UMG Africa, Tanzania\" \u002F>\n```\n\nFor tool logos (Simple Icons chips), the `alt` attribute already carries the tool name — this is sufficient. For decorative SVGs (inline icon replacements), use `aria-hidden=\"true\"` instead of alt text.\n\n#### Verification\n\nAfter deploying, verify with curl:\n\n```bash\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c '\u003Cmeta '            # expect 15+\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'og:'              # expect 6\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'application\u002Fld+json'  # expect 1\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002F\" | grep -c 'rel=\"canonical\"'  # expect 1\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002Frobots.txt\" | head -3           # expect valid\ncurl -s \"https:\u002F\u002Fsite.vercel.app\u002Fsitemap.xml\" | head -3          # expect valid\n```\n\n**Pitfalls:**\n- JSON-LD must be valid JSON — no trailing commas, no HTML entities inside strings except `&amp;` for the `&` character. Use a JSON validator.\n- The `robots.txt` takes 24-48 hours for Google to re-crawl. It's not instant.\n- Open Graph images must be absolute URLs (`https:\u002F\u002F...`), not relative paths. Relative OG image URLs are silently ignored by all platforms.\n- `theme-color` meta tag sets the browser tab color on mobile Chrome. Use your dark background color so the tab doesn't flash white on page load.\n- Sitemap `lastmod` should be updated when significant content changes. For a single-page portfolio, monthly is reasonable.\n\n## Key Features\n\n1. **Glassmorphism Design** (both approaches):\n   - Semi-transparent backgrounds with backdrop blur\n   - Subtle borders for depth\n   - Proper contrast for readability (critical on dark themes)\n\n2. **Color Palette** (customizable per brand):\n   - Default: Olive (#3D9970), Light Green (#A8E6CF), Amber (#FFD700)\n   - Hybrid dark variant used in session: Green (#00d4aa), Green-dim (#00a884), Amber (#f5b342)\n   - **Principle:** pick 1 primary accent + 1 secondary accent (warm contrast). The primary should pop against the background. Gradient text titles using primary → secondary gradient.\n\n3. **Optional Interactive Features** (ask before building — not every founder wants these):\n   - **Profile photo upload** — SVG placeholder avatar with file-upload + localStorage persistence. User uploads their own photo and it survives page reloads. Implementation: inline SVG fallback, `\u003Cinput type=file>` hidden trigger, FileReader + localStorage save.\n   - **Interactive portfolio chatbot** — An AI-powered assistant that answers visitor questions about the founder's background, projects, skills, and contact info. Speed-dial toggle, intent-based response matching, suggestion chips for follow-up questions. See `references\u002Fportfolio-chatbot-implementation.md`.\n   - **Embedded educational game** — A visual programming puzzle themed around the founder's domain. 8+ levels teaching real concepts. Persistent progress in browser. **CRITICAL: always confirm with the founder before building a game — some consider games unprofessional on a portfolio and will ask for removal.** See `references\u002Fportfolio-game-implementation.md`.\n\n4. **Responsive Layout**:\n   - Mobile-first approach\n   - Flexible grid systems\n   - Media queries for all screen sizes\n\n5. **Complete Sections**:\n   - Hero section with call-to-action (profile photo + tagline grid layout for dark themes)\n   - About section with personal narrative (mission-driven, problem-first framing)\n   - Company\u002Fventures showcase (flywheel visualization for holding companies)\n   - Projects\u002Fportfolio gallery (alternating left-right card layout)\n   - Skills grid with category breakdown or animated progress bars (see Approach D)\n   - Integrations\u002Ftools grid section (see Approach E)\n   - Play\u002Fgame section (retention mechanic — confirm interest first)\n   - Contact section with social links\n   - Footer\n\n6. **Theme Toggle**: dual dark\u002Flight theme using Catppuccin palettes (see Approach C). Persistent across visits via localStorage. Toggle button in the nav bar. **Alternative: dark-only mode** — if the founder prefers permanent dark, strip the toggle entirely (see Approach C2).\n\n7. **Progress Bar Skills**: animated proficiency bars that fill from 0 to target width when scrolled into view (see Approach D).\n\n8. **Integrations \u002F Tools Grid**: categorical cards listing tools, platforms, and frameworks the founder uses — organised as icon-badge cards with tag clouds or brand logo chips from Simple Icons CDN (see Approaches E and G).\n\n9. **Custom SVG Backgrounds**: programmatic SVG textures that mirror the founder's engineering domain — circuit traces, geographic outlines, waveforms, glowing nodes. Generated via Python and saved as a standalone `.svg` referenced in CSS `background: url(...)`. Requires no external assets or CDN. See `references\u002Fcircuit-svg-background-pattern.md`.\n\n10. **AI Visibility & SEO**: JSON-LD structured data, Open Graph tags, Twitter Cards, sitemap, robots.txt, canonical URL, descriptive alt text, and comprehensive meta tags for discoverability by ChatGPT, Google AI, Perplexity, and search engines (see Approach I).\n\n## Workflow\n\n1. **Planning**:\n   - Define site structure based on user requirements\n   - Plan content organization\n   - Determine specific features needed\n\n2. **Design System**:\n   - Establish color palette (1 primary + 1 secondary accent)\n   - Define typography hierarchy\n   - Create glassmorphism component styles (lighter on light themes, subtle on dark themes)\n   - Plan responsive behavior\n\n3. **Implementation**:\n   - Build as a single self-contained HTML file (preferred — no build step, deployable anywhere)\n   - Write semantic HTML\n   - Implement CSS with glassmorphism effects\n   - Add JavaScript for interactivity (scroll reveals, nav, optional features)\n   - Ensure responsive design\n\n4. **Photo Integration** (when user already has a real photo):\n   - **Locate**: check `~\u002FDownloads\u002F` for \"WhatsApp Image\" or user-named files; use `ls -lt ~\u002FDownloads\u002F | head` to find the most recent\n   - **Choose frame shape before cropping**:\n     * **Circular frame** (default for portrait profiles): crop source image to square, then resize to 400x400.\n       ```python\n       from PIL import Image\n       img = Image.open('source.jpg')\n       min_dim = min(img.size)\n       left = (img.width - min_dim) \u002F\u002F 2\n       top = (img.height - min_dim) \u002F\u002F 2\n       img_square = img.crop((left, top, left + min_dim, top + min_dim))\n       img_resized = img_square.resize((400, 400), Image.LANCZOS)\n       img_resized.save('profile.jpg', 'JPEG', quality=85, optimize=True)\n       ```\n     * **Rectangle frame** (preferred by some founders — shows full body\u002Fportrait, more modern): do NOT crop to square. Preserve original aspect ratio. Resize width to ~300px and let height scale.\n       ```python\n       from PIL import Image\n       img = Image.open('source.jpg')\n       new_w = 300\n       new_h = int(img.height * new_w \u002F img.width)\n       img_resized = img.resize((new_w, new_h), Image.LANCZOS)\n       img_resized.save('profile.jpg', 'JPEG', quality=90, optimize=True)\n       ```\n       CSS changes for rectangle frame:\n       ```css\n       .profile-frame {\n           width: 300px; height: 420px;\n           border-radius: 16px; padding: 5px;\n       }\n       .profile-inner { border-radius: 12px; }\n       .profile-inner img { width: 100%; height: 100%; object-fit: cover; }\n       .profile-ring { display: none; }\n       ```\n   - **Default display pattern**: the `\u003Cimg>` tag should have `src=\"profile.jpg\"` and be visible by default; the SVG placeholder should be hidden (`style=\"display:none\"`) as a fallback for the upload flow. This is the **reverse** of the upload-only pattern where SVG is shown first.\n   - **Upload flow still works**: the FileReader + localStorage mechanism replaces `img.src` with the uploaded data URL on change, and restores from localStorage on page load — overriding the default `profile.jpg`.\n   - **Post-photo cleanup**: once the final photo is in place, the founder may want to remove the \"Upload your photo\" button entirely. Offer this as cleanup. To remove: delete the `\u003Cdiv class=\"photo-credit\">` block from HTML, and delete the photo upload JS section (FileReader listener + localStorage restore). This simplifies the page and removes unnecessary UI.\n\n5. **Deployment & Verification** (for static asset changes):\n   - `git add` the new\u002Fupdated assets and changed HTML\n   - Deploy: `vercel deploy --prod --yes --force` (the `--force` flag busts Vercel's CDN cache — critical for image changes)\n   - Verify with curl:\n     ```bash\n     curl -sI \"https:\u002F\u002F\u003Csite>.vercel.app\u002Fprofile.jpg\" | head -5\n     # Expect HTTP\u002F2 200\n     ```\n   - If the image is missing, check the HTML reference path — Vercel serves from project root, so `src=\"profile.jpg\"` resolves to `https:\u002F\u002Fsite.vercel.app\u002Fprofile.jpg`\n\n4. **Optional Interactive Features** (confirm interest first, then build):\n   - Propose options: theme toggle (dark\u002Flight), profile photo upload, chatbot, embedded game\n   - Let the founder choose which (if any) they want — never build all three\u002Flarge features by default\n   - **Theme toggle** is low-commitment — offer it early since it impresses and is ~50 lines of CSS+JS\n   - Profile photo with upload capability\n   - Portfolio chatbot with intent matching\n   - Embedded game themed to the founder's domain (only if confirmed)\n   - See reference files for implementation patterns\n\n5. **Assets**:\n   - Create placeholder images for projects\n   - Prepare icons (using inline SVG or Font Awesome)\n   - Optimize all assets for web\n\n5. **Testing**:\n   - Verify responsive behavior\n   - Check browser compatibility\n   - Test form validation\n   - Ensure accessibility standards\n\n## HTML Structure\n\nTwo viable approaches:\n\n### Option A: Single Self-Contained File (Recommended for simplicity)\n```\nindex.html  (all HTML + CSS + JS inline)\n```\n\nPreferred when there's no build step, no framework, and you want to deploy anywhere (Vercel, GitHub Pages, Netlify) with zero config. Best for founder\u002Fengineer portfolios with interactive features (game, chatbot).\n\n### Option B: Separate Directories (For larger projects)\n```\n- index.html\n- css\u002F\n  - styles.css\n- js\u002F\n  - main.js\n- assets\u002F\n  - images\u002F\n  - icons\u002F\n```\n\n## CSS Guidelines\n\n1. **Glassmorphism Implementation**:\n   ```css\n   .glass {\n     background: rgba(255, 255, 255, 0.85);\n     border-radius: 15px;\n     box-shadow: 0 8px 32px rgba(31, 38, 135, 0.37);\n     backdrop-filter: blur(10px);\n     -webkit-backdrop-filter: blur(10px);\n     border: 1px solid rgba(255, 255, 255, 0.18);\n   }\n   ```\n\n2. **Color Variables**:\n   ```css\n   :root {\n     --olive: #3D9970;\n     --light-green: #A8E6CF;\n     --amber: #FFD700;\n   }\n   ```\n\n3. **Responsive Design**:\n   - Mobile-first approach with media queries\n   - Flexible grids using CSS Grid and Flexbox\n   - Properly sized touch targets\n\n## JavaScript Functionality\n\n1. **Core**:\n   - Navigation: smooth scrolling, active link highlighting, mobile hamburger toggle\n   - Scroll reveal animations (IntersectionObserver)\n   - Glassmorphism hover effects on cards\n\n2. **Optional: Profile Photo Upload**:\n   - SVG placeholder avatar with circuit \u002F tech pattern\n   - Hidden `\u003Cinput type=\"file\">` triggered by label\n   - FileReader API to load image as data URL\n   - localStorage persistence so the photo survives page reloads\n   - **Default photo pattern**: if the user provides a real image, embed it as `\u003Cimg src=\"profile.jpg\">` visible by default, with the SVG hidden as fallback. The upload mechanism overrides `img.src` on new upload and restores from localStorage on page load — this way the site always shows a real face, even to first-time visitors.\n   - **Photo optimization**:\n     - **Circular frames** (default): crop to square, resize to 400x400, JPEG quality=85, optimize=True. Target ~25-35KB.\n     - **Rectangle frames**: preserve original aspect ratio, resize width to ~300px, JPEG quality=90, optimize=True. Target ~40-60KB for portrait shots.\n     - Always use `Image.LANCZOS` for downscaling (best quality).\n\n3. **Optional: Embedded Educational Game**:\n   - Grid-based visual programming puzzle themed to founder's domain\n   - Command palette (Forward, Left, Right, Repeat)\n   - Program list rendered as removable step chips\n   - Step-by-step execution with delay (simulates robot movement)\n   - Collision detection, boundary checking, win conditions\n   - Star rating system based on solution efficiency vs optimal\n   - Multi-level progression with browser localStorage persistence\n   - See `references\u002Fportfolio-game-implementation.md`\n\n4. **Optional: Portfolio Chatbot**:\n   - Floating action button (toggle open\u002Fclose)\n   - Chat panel with header, message area, input, suggestion chips\n   - Intent-matching response engine (regex keyword categories)\n   - Typing indicator simulation (delayed response)\n   - Markdown-like formatting in responses (bold, line breaks)\n   - See `references\u002Fportfolio-chatbot-implementation.md`\n\n## Verification\n\nBefore final delivery:\n1. Ensure all files are created in the correct structure\n2. Verify HTML is valid and semantic\n3. Check CSS for proper glassmorphism implementation\n4. Test JavaScript functionality\n5. Confirm responsive behavior across devices\n6. Validate form submission process\n\n## Content Strategy\n\n- **Position the founder's narrative** — don't just list what they build, explain WHY. Frame challenges as engineering opportunities. Mission-driven storytelling resonates more than feature lists.\n- **For holding companies \u002F multiple ventures**: use a flywheel visualization showing how each entity feeds the next. This communicates strategy, not just a list of brands.\n- **Interactive features**: confirm interest before building a game or chatbot. Some founders want a clean, professional portfolio without gamification. Offer the option, don't assume.\n\n## Pitfalls\n\n- Don't overuse glassmorphism effects (can impact readability, especially on dark themes with light text)\n- Ensure proper contrast for text on semi-transparent backgrounds — use text-shadow or solid-text variants on noisy backdrop-filter areas\n- Test performance of backdrop-filter on different devices (mobile Safari especially)\n- Don't forget to include fallbacks for older browsers\n- Make sure all interactive elements are accessible (keyboard navigation, ARIA labels)\n- **Custom SVG background opacity**: the background is a fixed `.svg` referenced via CSS `url()`. Keep overall opacity 0.03-0.08 so it textures without distracting. Use CSS `opacity` on the `::before` pseudo-element that loads it, not on the SVG itself — this allows the SVG to remain at full opacity for visual quality while the CSS layer controls the dimming.\n- **Custom SVG background file size**: a full-viewport circuit SVG with Africa outline and waveforms is ~20KB. That's acceptable, but avoid embedding raster images or complex gradients inside the SVG — keep it as vector lines and simple fills only.\n- **Custom SVG background viewport coverage**: use `background: url('bg.svg') center center \u002F cover no-repeat` so the SVG scales to fill any screen size. The SVG viewBox should be `0 0 1440 900` (a common laptop screen ratio) — elements near the edges may clip on ultrawide or portrait screens, but the low opacity makes this unnoticeable.\n- **Profile photo SVG placeholder**: ensure the SVG is visually appealing as a fallback — if the user never uploads a photo, the placeholder is their permanent avatar. Circuit\u002Fpattern SVGs work better than generic silhouettes for tech founders.\n- **Game levels**: design levels that progressively teach concepts (sequence → turns → loops → pathfinding). The game should be beatable but challenging. Always provide a \"Reset level\" option.\n- **Chatbot intent matching**: regex-based matching is simple and fast but misses typos. The suggestion chips pattern compensates — offer 3-4 contextual follow-ups after each response so users can click instead of type.\n- **Chatbot scope**: keep the knowledge base focused. A portfolio chatbot should know about the person's background, projects, skills, and contact info — not attempt general conversation.\n- **Confirm interactive features upfront**: before building a game, chatbot, or photo upload, verify the founder actually wants it. A developer who asked for a \"good portfolio to shine in the tech world\" may not want a game on it. Phrase as: \"I can add a game, chatbot, or photo upload if you'd like — or keep it clean. What suits your style?\" This avoids wasted work and the awkward removal conversation.\n- **When game is removed**: replace with a testimonial section, timeline\u002Fmilestones, or expanded project details. The portfolio should still feel complete without it. The chatbot suggestion chips and greeting should also be updated to remove game references.\n- **Default photo display**: when embedding a real photo, reverse the default visibility. The `\u003Cimg>` with the real photo should be visible (`display:block` or default inline) and the SVG placeholder should be hidden (`style=\"display:none\"`). The upload JavaScript should then modify the img.src (not toggle visibility between two elements). This prevents a flash of the SVG placeholder before the page JS runs.\n- **Deployment verification for assets**: after deploying images or static files to Vercel, verify with curl before assuming it worked. Vercel's CDN sometimes caches old versions of the HTML that reference missing images. Check: `curl -sI \"https:\u002F\u002F\u003Csite>.vercel.app\u002F\u003Casset>\" | head -5` — expect HTTP 200. Also check the HTML serves correctly: `curl -s \"https:\u002F\u002F\u003Csite>.vercel.app\u002F\" | grep 'src=\"profile.jpg\"'`\n\n### 🔴 Critical: Scroll-Reveal Animation Selector Bug\n\nWhen using `IntersectionObserver` for scroll-reveal animations, **never** use `document.querySelector('.reveal')` — this returns only the FIRST matching element. All other `.reveal` elements will remain invisible (opacity: 0) and never animate in, making the page appear broken or blank below the fold.\n\n**Always do this instead:**\n```javascript\n\u002F\u002F CORRECT — observes EVERY .reveal element individually\ndocument.querySelectorAll('.reveal').forEach(el => {\n    new IntersectionObserver((entries) => {\n        entries.forEach(e => {\n            if (e.isIntersecting) e.target.classList.add('visible');\n        });\n    }, { threshold: 0.1, rootMargin: '0px 0px -40px 0px' }).observe(el);\n});\n```\n\n**Why this is critical:** the page loads, CSS sets `.reveal { opacity: 0 }`, JS only attaches the observer to the first element. All sections below the hero stay transparent. The user sees a blank page and reports \"it doesn't load.\" Vercel's CDN can make the fix appear to not deploy — always force a `vercel deploy --prod --yes --force` after this fix, then hard-refresh in the browser (Ctrl+Shift+R \u002F Cmd+Shift+R).\n\nThis selector pitfall applies generally: anytime you query elements by class to attach behavior, default to `querySelectorAll` + iteration unless you have a specific reason to target only the first match.\n\n### 🔴 User Preference: Emoji-Free Portfolios (Deep-Tech Founders)\n\n**Some founders explicitly want zero emoji on their portfolio.** This is especially common for deep-tech \u002F engineering profiles where emoji can feel informal, unprofessional, or out of character. When building a portfolio for an AI\u002Frobotics\u002Fengineering founder:\n\n- **Ask upfront** during the planning phase: \"Do you prefer emoji or clean SVG icons on the skill badges, section headers, and cards?\" Defaulting to icons saves a correction cycle.\n- **If they say \"replace emojis with icons\" or \"use icons instead of emoji\"** — apply the full Mass Emoji→SVG Replacement (Approach H) across every section: skill names, integration category icons, about stat cards, flywheel cards, contact links, chatbot, footer, and even the favicon.\n- **Chatbot text** is a common oversight — emoji in JS string literals (greetings, responses) must be manually stripped. They can't hold SVG elements.\n- **The theme toggle button** uses moon\u002Fsun emoji. If going dark-only (Approach C2), the toggle is removed entirely, solving this naturally. If keeping the toggle, replace the moon\u002Fsun emoji with SVG versions using `innerHTML` instead of `textContent`.\n- **After replacement, verify with a character-range scan** (see Approach H Verification) — don't rely on visual review alone. Emoji can hide in JS strings, the favicon, and CSS `content:` pseudo-elements.\n\n## Reference Files\n\nThis skill includes the following reference files:\n\n- `references\u002Fibrahim-portfolio-2026.md` — Full case study of a hybrid dark-theme portfolio for a Tanzanian deep-tech founder (photo upload, chatbot, and the build-then-remove cycle of an embedded game).\n- `references\u002Fportfolio-game-implementation.md` — Pattern for building an embedded educational game (level system, grid rendering, execution engine, star ratings).\n- `references\u002Fportfolio-chatbot-implementation.md` — Pattern for building a portfolio chatbot (intent matching, suggestion chips, UI components).\n- `references\u002Fcircuit-svg-background-pattern.md` — Programmatic SVG background generator: circuit traces, geographic outlines, data waveforms, glowing nodes. Full Python script with customization guide.\n- `references\u002Fcatppuccin-portfolio-pattern.md` — Complete implementation of the Catppuccin dual-theme system (Mocha dark + Latte light), progress bar skills with animated fills, and integrations\u002Ftools grid section. CSS variables, theme toggle JS, grid layouts, and all category icons.",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":39,"description":7},"Hermes Agent","1.4.0",{"hermes":27},{"tags":28,"related_skills":36},[29,30,31,32,33,34,35],"design","html","css","portfolio","glassmorphism","ux","ui",[37,38],"claude-design","popular-web-designs",[40,41,42],"linux","macos","windows","main","1f420fcb3f20524e8a830b9d010e0c0ee312d437","hermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel","I am a developer at UMG Africa and i have 2 years of software development also i engage with embedded softwares i am good in rust, cpp, python and kotlin","2026-08-16 18:04:02",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add abdullibrahim733-pixel\u002FEagle --skill portfolio-website-design",{"tool":56,"command":57},"bunx","bunx skills add abdullibrahim733-pixel\u002FEagle --skill portfolio-website-design",{"tool":59,"command":60},"pnpm","pnpm dlx skills add abdullibrahim733-pixel\u002FEagle --skill portfolio-website-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002FSKILL.md",true,[64,70,74,78,82,86,90,96],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fcatppuccin-portfolio-pattern.md","REFERENCE","参考文档",20920,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Freferences\u002Fcatppuccin-portfolio-pattern.md",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"references\u002Fcircuit-svg-background-pattern.md",10683,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Freferences\u002Fcircuit-svg-background-pattern.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"references\u002Fibrahim-portfolio-2026.md",4098,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Freferences\u002Fibrahim-portfolio-2026.md",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fportfolio-chatbot-implementation.md",3713,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Freferences\u002Fportfolio-chatbot-implementation.md",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"references\u002Fportfolio-game-implementation.md",3020,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Freferences\u002Fportfolio-game-implementation.md",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"templates\u002Findex.html",4858,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Ftemplates\u002Findex.html",{"path":91,"resourceType":92,"resourceTypeDesc":93,"sizeBytes":94,"sourceHtmlUrl":95},"templates\u002Fmain.js","SCRIPT","脚本",970,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Ftemplates\u002Fmain.js",{"path":97,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":100,"sourceHtmlUrl":101},"templates\u002Fstyles.css","OTHER","其他",3870,"https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fprofiles\u002Falexender_ceo\u002Fskills\u002Fcreative\u002Fportfolio-website-design\u002Ftemplates\u002Fstyles.css",[103,110,117,124,131,138],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M78BBHAQCSZNG7HYMB97YG3Y","web-ui-verification","Verify web UIs via headless Chrome CDP, no vision needed.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fweb-ui-verification\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M78BB60RHXBY2QV4TA9S917B","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M78BB16QRJZA9P3TXN5SHCQH","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fsystematic-debugging\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":19},"01M78BAY69B9JP3SK2NAF3EH2D","spike","Throwaway experiments to validate an idea before build.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fspike\u002FSKILL.md",[],[],{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":137,"publishedAt":19},"01M78BAVDMEBYN49PRDQ8QXTBJ","simplify-code","Parallel 4-agent cleanup of recent code changes.","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fsimplify-code\u002FSKILL.md",[],[],{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":144,"publishedAt":19},"01M78BAE09PQ5RV5MSJN1S788A","scroll-driven-3d-websites","Scroll-scrubbed 3D promo sites (Three.js + GSAP).","https:\u002F\u002Fgithub.com\u002Fabdullibrahim733-pixel\u002FEagle\u002Fblob\u002Fmain\u002Fhermes-backup\u002Fskills\u002Fsoftware-development\u002Fscroll-driven-3d-websites\u002FSKILL.md",[],[]]