Profile
Back to NewsBack
GitHub Trending 15 min
Reader Mode
Illyism/seo-skills: 30 open-source SEO skills (SKILL.md) for Claude Code, Cursor, Codex & AI agents: technical SEO roasts, Ahrefs & DataForSEO SERP workflows, first-hand proof KBs, backlinks & GEO.

Illyism/seo-skills: 30 open-source SEO skills (SKILL.md) for Claude Code, Cursor, Codex & AI agents: technical SEO roasts, Ahrefs & DataForSEO SERP workflows, first-hand proof KBs, backlinks & GEO.

SEO Skills for Claude Code, Cursor & AI Agents

30 open-source SKILL.md workflows that ship real SEO outputs instead of 50-page audit PDFs nobody reads.
Run daily repo SEO on autopilot, pull live Ahrefs & DataForSEO SERP gaps, build a First-Hand Proof KB, ship honest /vs/ pages, de-slop MDX for AI search, track ChatGPT & Perplexity citations (GEO), and build DR 30–60+ backlinks.

GitHub Stars Agent Skills Specification Browse SEO Skills at il.ly/skills MIT License

Browse Web Catalog · Quick Install · All 30 Skills · Workflows · MCP Servers · Sponsors · FAQ

!30 Open-Source SEO Skills installed with npx skills add Illyism/seo-skills: terminal install, merged GitHub pull request unblocking Bing and AI crawlers, and rising Google Search Console clicks


Install

Install every skill in one command using the skills CLI, or install individual skills on demand:

# Install all 30 SEO, GEO, Ahrefs/DataForSEO research, proof KB, link building & copywriting skills
npx skills add Illyism/seo-skills

Install a single skill (for example, daily autonomous repo SEO)

npx skills add Illyism/seo-skills --skill seo-autopilot

List every available skill in this repository

npx skills add Illyism/seo-skills --list

Works Across Every Coding Agent & AI Chat App

Each skill is a self-contained folder with a plain Markdown SKILL.md following the open Agent Skills specification. Your agent loads only the short name and description at startup and opens the full instructions only when your prompt matches, keeping your context window fast and clean.

| Environment | Where SKILL.md lives | How to install | | --- | --- | --- | | Claude Code | .claude/skills/ or ~/.claude/skills/ | npx skills add Illyism/seo-skills -a claude-code | | Cursor | .cursor/skills/ or .agents/skills/ | npx skills add Illyism/seo-skills -a cursor | | OpenAI Codex / OpenCode | .agents/skills/ | npx skills add Illyism/seo-skills | | Windsurf / Cline / Roo Code | .agents/skills/ | npx skills add Illyism/seo-skills | | ChatGPT, Claude.ai, Perplexity, Grok | Paste or attach raw Markdown | Copy any skill directly at il.ly/skills |


Why Output-First SEO Skills?

Most "AI SEO prompt packs" generate giant checklists and health scores that sit in a folder forever.

Every skill in Illyism/seo-skills is built to end in a concrete, shippable output inside your repository or marketing workflow:

  • Codebase diffs you can merge: Rewritten </code> tags, <code><h1></code> alignment, MDX blog refreshes grounded in SERP gap analysis, <code>robots.txt</code> / bot-firewall middleware, verified <code>301</code> redirect maps, and new <code>/vs/</code> comparison routes.</li> <li><strong>First-hand proof over AI commodity fluff:</strong> <code>proof-kb</code>, <code>seo-blog-images</code>, and <code>unslop-seo</code> replace generic filler with atomic product benchmarks, real screenshots/SVG charts, and answer-engine HTML structure.</li> <li><strong>Focused 30-day execution:</strong> Instead of spreading effort across 200 low-intent keywords, <code>blitz-seo</code> concentrates technical fixes, internal links, SERP proof, and authority links onto <strong>one money page</strong> until it reaches Page 1.</li> <li><strong>Google + AI Search (GEO / AEO) together:</strong> Map the exact prompts buyers ask ChatGPT, Perplexity, Gemini, and Google AI Overviews, measure live citation share, and ship pages and third-party placements that close missing prompt clusters.</li></ul> !<a href="assets/seo-skills-output-engine.webp" target="_blank" rel="noopener">Concrete mergeable SEO outputs shipped by Illyism/seo-skills: robots.ts crawler fix, verified seo/kb/proof folder, competitor /vs/ pricing page, and ChatGPT and Perplexity citations</a> <hr> <h2>All 30 SEO Skills</h2> <h3>1. Technical, Research & On-Page SEO Skills</h3> <p>| Skill | What it ships | Example prompt | | --- | --- | --- | | <a href="seo/seo-autopilot/SKILL.md" target="_blank" rel="noopener"><strong><code>seo-autopilot</code></strong></a> | Daily end-to-end repo SEO agent with persistent state in <code>seo/</code>: site health checks, commit fact-checking, Page-2-to-Page-1 pushes, competitor sitemap diffs, monthly keyword map, comparison pages, free tools & link drafts | <em>"Run <code>seo-autopilot</code> on this repo and open a PR with today's highest-leverage fix"</em> | | <a href="seo/seo-roast/SKILL.md" target="_blank" rel="noopener"><strong><code>seo-roast</code></strong></a> | Brutal revenue-first SEO teardown that fixes fatal crawl, <code>robots.txt</code>, programmatic, above-the-fold layout, and AI-visibility blockers in code, plus a revenue-ordered <code>seo/roast-roadmap.md</code> | <em>"Run <code>seo-roast</code> on our repo, fix fatal blockers in a PR, and write <code>seo/roast-roadmap.md</code>"</em> | | <a href="seo/blitz-seo/SKILL.md" target="_blank" rel="noopener"><strong><code>blitz-seo</code></strong></a> | Aggressive 30-day sprint to rank <strong>one high-value page</strong> for one money keyword using search-intent lock-in, internal link concentration, proof upgrades, and targeted authority | <em>"Run a 30-day <code>blitz-seo</code> sprint to push <code>/pricing</code> from #14 to Top 3"</em> | | <a href="seo/ahrefs-research/SKILL.md" target="_blank" rel="noopener"><strong><code>ahrefs-research</code></strong></a> | Ahrefs MCP + API v3 workflows: competitor <code>top-pages</code> gap Kanban (<code>seo/competitor-gaps.md</code>) + scaffolded routes, fake-DR filter (<code>seo/link-targets.csv</code>), subreddit pain mining, and link-insertion page matcher | <em>"Use <code>ahrefs-research</code> to diff our top pages against our top 5 competitors and scaffold the #1 gap"</em> | | <a href="seo/dataforseo-serp/SKILL.md" target="_blank" rel="noopener"><strong><code>dataforseo-serp</code></strong></a> | Live DataForSEO SERP URL-overlap keyword clustering (<code>seo/keyword-clusters.json</code>), <code>CPC x Volume</code> free-tool filter + route scaffold, AI Overview citation extraction, and pre-write SERP intent locks | <em>"Use <code>dataforseo-serp</code> to cluster these 40 keywords by live Top-10 URL overlap so we don't cannibalize"</em> | | <a href="seo/proof-kb/SKILL.md" target="_blank" rel="noopener"><strong><code>proof-kb</code></strong></a> | Atomic First-Hand Proof Knowledge Base (<code>seo/kb/</code>): <code>brand-ssot.md</code>, verifiable benchmark/customer proof cards, <code>[CONSENSUS] + [PROOF]</code> draft architecture, and <code>route-fact</code> multi-page propagation | <em>"Run <code>proof-kb</code> init and upgrade <code>content/blog/postgres-branching.mdx</code> with real benchmark receipts"</em> | | <a href="seo/vs-and-alternatives/SKILL.md" target="_blank" rel="noopener"><strong><code>vs-and-alternatives</code></strong></a> | High-converting <code>/vs/[competitor]</code>, <code>/[competitor]-alternative</code>, and micro-persona <code>Best [Category] for [Persona]</code> routes built on verified public switching triggers, 1/5/25-seat pricing math, and 10-minute switch steps | <em>"Use <code>vs-and-alternatives</code> to mine switching triggers and ship <code>/vs/billstack</code> wired into the footer"</em> | | <a href="seo/internal-linking/SKILL.md" target="_blank" rel="noopener"><strong><code>internal-linking</code></strong></a> | Reverse internal linking ("traffic-to-money routing"): audits the repo link graph (<code>scripts/internal-link-graph.mjs</code>) and injects upper-40% contextual anchors + prefilled tool callouts from top blog posts into <code>/pricing</code>, <code>/vs/<em></code>, and <code>/tools/</em></code> | <em>"Run <code>internal-linking</code> to eliminate orphan money pages and route blog equity to <code>/pricing</code>"</em> | | <a href="seo/domain-migration/SKILL.md" target="_blank" rel="noopener"><strong><code>domain-migration</code></strong></a> | Zero-traffic-loss domain rebrand, subdomain-to-subfolder merge, or URL consolidation: full URL + backlink union, 1-hop <code>301</code> config, <code>scripts/verify-redirects.sh</code>, schema <code>alternateName</code>, and <code>seo/backlink-transfer-emails.md</code> | <em>"Run <code>domain-migration</code> to move <code>blog.acme.com</code> into <code>acme.com/blog</code> with verified 1-to-1 redirects"</em> | | <a href="seo/seo-title-optimization/SKILL.md" target="_blank" rel="noopener"><strong><code>seo-title-optimization</code></strong></a> | Bulk title tag, MDX frontmatter <code>title</code>, and <code><h1></code> rewrites calibrated against live SERP winners, pixel/character truncation limits, and click-through rate (CTR) | <em>"Audit every page title in <code>app/</code> and <code>content/blog/</code> for CTR and SERP truncation"</em> | | <a href="seo/blog-refresher/SKILL.md" target="_blank" rel="noopener"><strong><code>blog-refresher</code></strong></a> | 6-phase content refresh and SERP gap analysis that compares a slipping post against current Top-10 pages and rewrites weak sections while preserving your voice | <em>"Use <code>blog-refresher</code> on <code>content/blog/best-crm.mdx</code> so it outranks the Top 3"</em> | | <a href="seo/block-ai-scrapers/SKILL.md" target="_blank" rel="noopener"><strong><code>block-ai-scrapers</code></strong></a> | Multi-layer bot firewall that blocks AI coding agents, <code>WebFetch</code>, <code>curl</code>, and headless scrapers from burning API/DB credits while keeping verified <code>Googlebot</code> indexing intact and turning blocked scrapes into product links | <em>"Add <code>block-ai-scrapers</code> to protect our <code>/directory</code> dataset routes without hurting Googlebot"</em> |</p> <h3>2. AI Search & GEO (Generative Engine Optimization) Skills</h3> <p>| Skill | What it ships | Example prompt | | --- | --- | --- | | <a href="marketing/customer-journey/SKILL.md" target="_blank" rel="noopener"><strong><code>customer-journey</code></strong></a> | 5-stage buyer awareness map pairing traditional Google keywords with the conversational prompts buyers type into ChatGPT, Claude, and Perplexity at each stage | <em>"Map the 5-stage <code>customer-journey</code> and AI search prompts for our B2B analytics SaaS"</em> | | <a href="seo/aiseotracker/SKILL.md" target="_blank" rel="noopener"><strong><code>aiseotracker</code></strong></a> | One-time OAuth MCP setup (<code>https://aiseotracker.com/api/agent/mcp</code>) and project wiring for <a href="https://aiseotracker.com" target="_blank" rel="noopener">AI SEO Tracker</a> to track brand mentions, citations, and competitors across ChatGPT, Perplexity, Gemini, Copilot & Google AI Overviews | <em>"Connect <code>aiseotracker</code> and check how ChatGPT and Perplexity rank our domain"</em> | | <a href="seo/ai-seo-report/SKILL.md" target="_blank" rel="noopener"><strong><code>ai-seo-report</code></strong></a> | Executive AI visibility brief synthesized from live prompt scans, cited competitor URLs, and share-of-voice shifts, with zero raw JSON dumps | <em>"Give me this week's <code>ai-seo-report</code> brief and tell me why competitors beat us in ChatGPT"</em> | | <a href="seo/content-coverage/SKILL.md" target="_blank" rel="noopener"><strong><code>content-coverage</code></strong></a> | Evidence-backed content plan and article drafts targeting the exact AI search prompt clusters where competitors get cited and your site is missing | <em>"Run <code>content-coverage</code> to plan and draft pages for our missing Perplexity & ChatGPT prompts"</em> | | <a href="seo/reddit-serp/SKILL.md" target="_blank" rel="noopener"><strong><code>reddit-serp</code></strong></a> | Finds unlocked Reddit threads that already rank Page 1 on Google or get cited by AI Overviews and ChatGPT, checks subreddit rules via JSON, and writes <code>seo/reddit-serp-queue.md</code> with practitioner replies that survive moderation | <em>"Run <code>reddit-serp</code> to find unlocked Page-1 Reddit threads for our category and draft replies"</em> |</p> <h3>3. Off-Page SEO, Link Building & Directory Submissions</h3> <p>| Skill | What it ships | Example prompt | | --- | --- | --- | | <a href="seo/directory-submissions/SKILL.md" target="_blank" rel="noopener"><strong><code>directory-submissions</code></strong></a> | Autonomous startup, AI tool, MCP registry & GitHub Awesome directory submission workflow: builds <code>submission-manifest.json</code>, cascades 1 repo across 15+ MCP/agent registries, and works through 50 high-DR launchpads (<a href="https://linkdr.com/resources/directories" target="_blank" rel="noopener">850+ directory database</a>) | <em>"Run <code>directory-submissions</code> to generate our manifest and submit across Wave 1–3 directories"</em> | | <a href="seo/linkdr/SKILL.md" target="_blank" rel="noopener"><strong><code>linkdr</code></strong></a> | Managed authority link-building planner for <a href="https://linkdr.com" target="_blank" rel="noopener">LinkDR</a>: calculates a DR 30+ to DR 60+ backlink, niche-edit, or listicle mix for your budget and returns a single approval-gated checkout link | <em>"Plan a $1,000 DR 40–50+ backlink campaign for our SaaS homepage using <code>linkdr</code>"</em> | | <a href="seo/honest-link-outreach/SKILL.md" target="_blank" rel="noopener"><strong><code>honest-link-outreach</code></strong></a> | Vetted backlink outreach batch (<code>seo/outreach-batch-YYYY-MM-DD.md</code>) with a <code>SEND / CUT</code> table targeting ranking <code>/blog</code>, <code>/guides</code>, and <code>/docs</code> URLs, Ask-First structure, and a 7-axis Anti-Template Variety Matrix | <em>"Run <code>honest-link-outreach</code> on these 8 partner and blog domains and write the batch file"</em> | | <a href="seo/awesome-tools/SKILL.md" target="_blank" rel="noopener"><strong><code>awesome-tools</code></strong></a> | Agent submission workflow for <a href="https://awesome.tools" target="_blank" rel="noopener">Awesome Tools</a> via Streamable HTTP MCP (<code>https://awesome.tools/mcp</code>), JSON API, or WebMCP to earn a verified <code>dofollow</code> SaaS directory backlink | <em>"Submit our app to <code>awesome-tools</code> and check eligibility for the free dofollow listing"</em> |</p> <h3>4. Content & Shipped-Code Distribution Skills</h3> <p>| Skill | What it ships | Example prompt | | --- | --- | --- | | <a href="content/unslop-seo/SKILL.md" target="_blank" rel="noopener"><strong><code>unslop-seo</code></strong></a> | 3-phase in-place editorial de-slopping and Answer-Engine (GEO) HTML pass: grounds vague claims in <code>seo/kb/brand-ssot.md</code>, enforces a 40-word direct opening answer and question <code><h2></code> tags, and strips 20 AI slop patterns | <em>"Run <code>unslop-seo</code> on <code>content/blog/ci-guide.mdx</code> and verify the slop check exits 0"</em> | | <a href="content/seo-blog-images/SKILL.md" target="_blank" rel="noopener"><strong><code>seo-blog-images</code></strong></a> | Plans, generates, compresses (<code>scripts/seo-image.mjs</code>), visually verifies, and wires high-CTR cover images, Playwright screenshots, and deterministic SVG charts into posts with strict filename, size (<code><= 220 KB</code>), and <code>80–160</code> char <code>alt</code> checks | <em>"Use <code>seo-blog-images</code> to add a cover image and benchmark chart to <code>content/blog/benchmark.mdx</code>"</em> | | <a href="content/youtube-seo/SKILL.md" target="_blank" rel="noopener"><strong><code>youtube-seo</code></strong></a> | Turns a demo, tutorial, or <code>.srt</code> transcript into 2 YouTube title options (with char counts), a Google Key-Moments <code>00:00</code> description (<code>>= 10s</code> chapters), X/LinkedIn launch posts, and a <code>VideoObject</code> JSON-LD blog embed | <em>"Run <code>youtube-seo</code> on <code>demo.srt</code> and embed the <code>VideoObject</code> schema into our matching blog post"</em> | | <a href="marketing/parasite-and-pr/SKILL.md" target="_blank" rel="noopener"><strong><code>parasite-and-pr</code></strong></a> | Ready-to-publish third-party syndication bundle (<code>marketing/distribution/<slug>/</code>): privacy-audited wire press release (zero personal/LLC leaks across 500+ scrapers), canonicalized Dev.to draft, LinkedIn/parasite article, and verification checklist | <em>"Run <code>parasite-and-pr</code> for our 2026 latency benchmark so ChatGPT and Google triangulate it fast"</em> | | <a href="content/intro/SKILL.md" target="_blank" rel="noopener"><strong><code>intro</code></strong></a> | High-retention blog introductions with a proof hook and journey teaser tailored to listicle, how-to, comparison, or definition search intent (includes <a href="content/intro/examples.md" target="_blank" rel="noopener">real examples</a>) | <em>"Rewrite the opening 80 words of this post using the <code>intro</code> skill for listicle intent"</em> | | <a href="content/scribiz/SKILL.md" target="_blank" rel="noopener"><strong><code>scribiz</code></strong></a> | Video, YouTube, podcast, and screen-recording transcription with speaker labels, on-screen OCR text, chapters, and video-to-SEO-blog conversion via <a href="https://scribiz.com" target="_blank" rel="noopener">Scribiz</a> (<code>https://scribiz.com/mcp</code>) | <em>"Transcribe this YouTube demo with <code>scribiz</code> and turn it into a step-by-step tutorial post"</em> | | <a href="marketing/diff-marketing/SKILL.md" target="_blank" rel="noopener"><strong><code>diff-marketing</code></strong></a> | Reads recent <code>git log</code> commits and merged PRs to ship customer-facing changelog entries, SEO feature articles, launch tweets, and release emails based on what actually shipped | <em>"Read the last 2 weeks of git commits with <code>diff-marketing</code> and draft 3 blog/launch angles"</em> |</p> <h3>5. Conversion Copywriting Skills</h3> <p>| Skill | What it ships | Example prompt | | --- | --- | --- | | <a href="copywriting/understand-customers/SKILL.md" target="_blank" rel="noopener"><strong><code>understand-customers</code></strong></a> | Deep buyer-psychology brief uncovering customer pains, switching triggers, objections, and exact verbatim phrasing before writing a word of copy | <em>"Run <code>understand-customers</code> for indie Next.js founders tired of slow CI builds"</em> | | <a href="copywriting/blitz-copy/SKILL.md" target="_blank" rel="noopener"><strong><code>blitz-copy</code></strong></a> | High-converting landing pages, hero headlines, cold outreach emails, social hooks, and SERP titles built on the <strong>Hook → Spike → Payoff</strong> dopamine copywriting system | <em>"Rewrite our hero section and pricing CTAs using <code>blitz-copy</code>"</em> |</p> <blockquote>Looking for engineering skills like AI evals and Chrome Web Store release pipelines? Check out <strong><a href="https://github.com/Illyism/dev-skills" target="_blank" rel="noopener">Illyism/dev-skills</a></strong>.</blockquote> <hr> <h2>End-to-End SEO Workflows</h2> <p>Skills compose naturally inside Claude Code, Cursor, and Codex. Six battle-tested chains:</p> <ol><li><strong>Ship a Proof-Backed Post That Ranks Top 3 & Earns AI Citations</strong></li></ol> <code>dataforseo-serp</code> <em>(cluster keywords by live URL overlap & lock SERP intent)</em> → <code>proof-kb</code> <em>(inject atomic first-hand benchmarks & write the receipt intro last)</em> → <code>seo-blog-images</code> <em>(add real screenshots, deterministic SVG charts & cover WebP)</em> → <code>unslop-seo</code> <em>(strip AI tells & enforce answer-engine HTML)</em> → <code>internal-linking</code> <em>(route upper-40% anchors to money pages)</em> → <code>parasite-and-pr</code> <em>(syndicate across wires, Dev.to & LinkedIn for 48h triangulation)</em>. <ol><li><strong>Capture High-Intent Competitor Switchers Across Google, Reddit & LLMs</strong></li></ol> <code>ahrefs-research</code> <em>(diff competitor <code>top-pages</code> & filter real backlinks)</em> → <code>vs-and-alternatives</code> <em>(mine verified switching triggers, 1/5/25-seat pricing math & ship <code>/vs/[competitor]</code> + persona listicles)</em> → <code>reddit-serp</code> <em>(find unlocked Page-1 Reddit threads & draft practitioner replies)</em> → <code>honest-link-outreach</code> <em>(pitch varied, ask-first emails to ranking partner & editorial guides)</em>. <ol><li><strong>Push a Page-2 URL into the Google Top 3</strong></li></ol> <code>seo-title-optimization</code> <em>(fix CTR & SERP intent)</em> → <code>blog-refresher</code> <em>(close Top-10 entity & proof gaps)</em> → <code>intro</code> <em>(cut pogo-sticking in the first 80 words)</em> → <code>linkdr</code> <em>(point 2–4 DR 40+ contextual links at the refreshed URL)</em>. <ol><li><strong>Win Citations in ChatGPT, Perplexity & Google AI Overviews (GEO)</strong></li></ol> <code>customer-journey</code> <em>(map buyer prompts across 5 stages)</em> → <code>aiseotracker</code> <em>(scan live AI answers)</em> → <code>ai-seo-report</code> <em>(spot third-party listicles & missing topics)</em> → <code>content-coverage</code> <em>(ship pages covering unowned prompt clusters)</em>. <ol><li><strong>Launch a New Product from DR 0</strong></li></ol> <code>understand-customers</code> <em>(extract buyer language)</em> → <code>blitz-copy</code> <em>(write the landing page)</em> → <code>directory-submissions</code> & <code>awesome-tools</code> <em>(cascade across 15+ MCP registries & 50+ high-DR directories)</em> → <code>blitz-seo</code> <em>(run a focused 30-day sprint on your #1 commercial keyword)</em>. <ol><li><strong>Autonomous Daily Repo SEO</strong></li></ol> Drop <code>seo-autopilot</code> on a daily schedule so your coding agent checks site health, verifies product claims against recent commits, refreshes decaying posts, and opens reviewable PRs. Pair it with <code>diff-marketing</code> every Friday to turn shipped code into distribution. <hr> <h2>Live SEO Data via MCP Servers</h2> <p>A <code>SKILL.md</code> gives your agent the <strong>methodology</strong>. Pairing it with a <a href="https://modelcontextprotocol.io" target="_blank" rel="noopener">Model Context Protocol (MCP)</a> server (preconfigured in <a href=".mcp.json" target="_blank" rel="noopener"><code>.mcp.json</code></a>) gives your agent <strong>live search, citation, directory, and transcript data</strong>:</p> <p>| Server / Integration | Endpoint / Repo | Live capabilities | | --- | --- | --- | | <strong><a href="https://aiseotracker.com" target="_blank" rel="noopener">AI SEO Tracker MCP</a></strong> | <code>https://aiseotracker.com/api/agent/mcp</code> (<a href="https://github.com/Illyism/aiseotracker-mcp" target="_blank" rel="noopener"><code>Illyism/aiseotracker-mcp</code></a>) | Live prompt rankings, cited source URLs, competitor share of voice & weekly scan diffs across ChatGPT, Perplexity, Gemini, Copilot & Google AIO | | <strong><a href="https://scribiz.com" target="_blank" rel="noopener">Scribiz MCP</a></strong> | <code>https://scribiz.com/mcp</code> | Transcribe YouTube videos, podcasts, and recordings with speaker diarization, screen OCR, summaries & <code>00:00</code> chapters | | <strong><a href="https://awesome.tools" target="_blank" rel="noopener">Awesome Tools MCP</a></strong> | <code>https://awesome.tools/mcp</code> (<a href="https://github.com/Illyism/awesome-tools-mcp" target="_blank" rel="noopener"><code>Illyism/awesome-tools-mcp</code></a>) | Search curated SaaS & AI tools, submit products for <code>dofollow</code> directory listings, and verify badge backlinks | | <strong><a href="https://linkdr.com" target="_blank" rel="noopener">LinkDR Agent Skill</a></strong> | <a href="https://linkdr.com/SKILL.md" target="_blank" rel="noopener"><code>https://linkdr.com/SKILL.md</code></a> | Plan vetted DR 30–60+ contextual backlinks, link insertions, and SaaS listicle placements with a single approval-gated <code>/agent/checkout</code> link | | <strong><a href="https://genppt.com" target="_blank" rel="noopener">GenPPT MCP</a></strong> | <a href="https://github.com/Illyism/genppt-mcp" target="_blank" rel="noopener"><code>Illyism/genppt-mcp</code></a> | Turn SEO audits, <code>seo-roast</code> roadmaps, and competitor gap analyses into designed PowerPoint (<code>.pptx</code>) & PDF slide decks from your IDE |</p> <hr> <h2>Repository Structure</h2> <p>Every skill lives in <code><category>/<skill-name>/SKILL.md</code> with clean YAML frontmatter (<code>name</code>, <code>description</code>, <code>metadata</code>) and zero build step:</p> <pre><code class="text">seo-skills/ ├── seo/ │ ├── ahrefs-research/SKILL.md │ ├── ai-seo-report/SKILL.md │ ├── aiseotracker/SKILL.md │ ├── awesome-tools/SKILL.md │ ├── blitz-seo/SKILL.md │ ├── block-ai-scrapers/SKILL.md │ ├── blog-refresher/SKILL.md │ ├── content-coverage/SKILL.md │ ├── dataforseo-serp/SKILL.md │ ├── directory-submissions/SKILL.md │ ├── domain-migration/SKILL.md │ ├── honest-link-outreach/SKILL.md │ ├── internal-linking/SKILL.md │ ├── linkdr/SKILL.md │ ├── proof-kb/SKILL.md │ ├── reddit-serp/SKILL.md │ ├── seo-autopilot/SKILL.md │ ├── seo-roast/SKILL.md │ ├── seo-title-optimization/SKILL.md │ └── vs-and-alternatives/SKILL.md ├── content/ │ ├── intro/SKILL.md │ ├── scribiz/SKILL.md │ ├── seo-blog-images/SKILL.md │ ├── unslop-seo/SKILL.md │ └── youtube-seo/SKILL.md ├── marketing/ │ ├── customer-journey/SKILL.md │ ├── diff-marketing/SKILL.md │ └── parasite-and-pr/SKILL.md └── copywriting/ ├── blitz-copy/SKILL.md └── understand-customers/SKILL.md</code></pre> <hr> <h2>Free 71-Point SEO Checklist & 850+ Startup Directories</h2> <p>Launching a new product or pushing a domain past DR 30? Pair these skills with two companion playbooks:</p> <ul><li><strong><a href="https://il.ly/growth" target="_blank" rel="noopener">71-Point SEO Launch Checklist & Growth Playbook (<code>il.ly/growth</code>)</a>:</strong> Free <strong>71 pass/fail checks</strong> (each with an exact test command), <code>seo-autopilot</code> repo setup, and the <strong>50-directory 5-wave launch tracker</strong> (<code>il.ly/growth/directories</code>).</li> <li><strong><a href="https://linkdr.com/resources/directories" target="_blank" rel="noopener">850+ Startup, AI Tool & MCP Directories (<code>linkdr.com/resources/directories</code>)</a>:</strong> Filter <strong>856+ verified launchpads, software review sites, MCP registries, and GitHub Awesome lists</strong> across 14 categories by Domain Rating (DR), monthly traffic, free vs. paid pricing, and <code>dofollow</code>/<code>nofollow</code> link type, with direct submit URLs and a copy-paste Claude Code / Cursor submission prompt.</li></ul> <hr> <h2>Sponsors & SEO Growth Stack</h2> <p><code>Illyism/seo-skills</code> is MIT-licensed and maintained by <strong><a href="https://il.ly" target="_blank" rel="noopener">Ilias Ism</a></strong>, supported by the SEO & creator products below:</p> <p>| Product | What it does | | --- | --- | | <img src="https://www.google.com/s2/favicons?domain=linkdr.com&sz=32" width="16" height="16" alt="LinkDR" /> <strong><a href="https://linkdr.com" target="_blank" rel="noopener">LinkDR</a></strong> | <strong>AI Link Building & Authority Backlinks:</strong> Order vetted DR 30–60+ contextual backlinks, link insertions, and SaaS listicle placements. Approve every publisher site before placement (<code>15% off</code> monthly plans). | | <img src="https://www.google.com/s2/favicons?domain=aiseotracker.com&sz=32" width="16" height="16" alt="AI SEO Tracker" /> <strong><a href="https://aiseotracker.com" target="_blank" rel="noopener">AI SEO Tracker</a></strong> | <strong>AI Search & GEO Visibility Tracking:</strong> Track whether ChatGPT, Perplexity, Gemini, Copilot, and Google AI Overviews cite your brand, which competitor pages win citations, and which prompts to target next. | | <img src="https://www.google.com/s2/favicons?domain=genppt.com&sz=32" width="16" height="16" alt="GenPPT" /> <strong><a href="https://genppt.com" target="_blank" rel="noopener">GenPPT</a></strong> | <strong>AI Presentation & Pitch Deck Maker:</strong> Turn messy notes, client SEO reports, and financial PDFs into clean, editable PowerPoint (<code>.pptx</code>) and Google Slides decks in minutes. | | <img src="https://www.google.com/s2/favicons?domain=scribiz.com&sz=32" width="16" height="16" alt="Scribiz" /> <strong><a href="https://scribiz.com" target="_blank" rel="noopener">Scribiz</a></strong> | <strong>Video & Audio Transcription + Screen OCR:</strong> Turn YouTube videos, calls, and demos into speaker-labeled transcripts, on-screen code/slide OCR, chapters, and SEO blog drafts (<code>Web</code>, <code>macOS</code>, <code>Android</code>, <code>CLI</code>). | | <img src="https://www.google.com/s2/favicons?domain=awesome.tools&sz=32" width="16" height="16" alt="Awesome Tools" /> <strong><a href="https://awesome.tools" target="_blank" rel="noopener">Awesome Tools</a></strong> | <strong>Curated SaaS & Developer Tools Directory:</strong> Discover hand-picked software tools or submit your own product to earn a verified <code>dofollow</code> backlink. | | <img src="https://www.google.com/s2/favicons?domain=seoroast.com&sz=32" width="16" height="16" alt="SEO Roast" /> <strong><a href="https://seoroast.com" target="_blank" rel="noopener">SEO Roast</a></strong> | <strong>20-Minute Video SEO Teardown:</strong> Get a blunt, recorded screen-share audit of your site's rankings, SERP title leaks, backlink gaps, and 90-day growth plan. | | <img src="https://www.google.com/s2/favicons?domain=xoutlier.com&sz=32" width="16" height="16" alt="XOutlier" /> <strong><a href="https://xoutlier.com" target="_blank" rel="noopener">XOutlier</a></strong> | <strong>Viral X Outlier Finder (Free Chrome Extension):</strong> Spot outlier posts and proven hooks across <code>390,000+</code> creators right inside X to distribute what you ship. |</p> <hr> <h2>FAQ</h2> <h3>What are SEO skills for AI agents?</h3> An <strong>SEO skill</strong> is a portable folder containing a <code>SKILL.md</code> file with structured instructions, quality gates, and output templates that teach coding and research agents (Claude Code, Cursor, OpenAI Codex, OpenCode, Windsurf) how to execute specialized search engine optimization workflows, covering technical audits, title tag rewrites, content refreshes, GEO citation tracking, and backlink planning. <h3>How do I use these SEO skills in Claude Code or Cursor?</h3> Run <code>npx skills add Illyism/seo-skills</code> in your project root (or globally). Claude Code and Cursor automatically index each skill's <code>name</code> and <code>description</code> and load the full <code>SKILL.md</code> whenever you ask for an SEO sprint, title audit, blog refresh, scraper block, or backlink plan. You can also invoke any skill explicitly by name (for example, <em>"Use <code>blog-refresher</code> on <code>content/blog/post.mdx</code>"</em>). <h3>Can I use these skills in ChatGPT, Claude.ai, or Perplexity without a terminal?</h3> Yes. Open <strong><a href="https://il.ly/skills" target="_blank" rel="noopener">il.ly/skills</a></strong>, click any skill, and hit <strong>Copy prompt</strong> (or open its raw <code>SKILL.md</code>) to paste directly into ChatGPT, Claude Desktop, Perplexity, or Grok. <h3>What is the difference between an SEO skill (<code>SKILL.md</code>) and an SEO MCP server?</h3> A <strong>skill (<code>SKILL.md</code>)</strong> teaches the agent <em>how to do the job</em> (the step-by-step methodology, SERP rules, formatting, and approval gates). An <strong>MCP server</strong> connects the agent to <em>live external data and actions</em> (Google Search Console metrics, live SERPs, AI citation scans, video transcripts, or backlink checkouts). Using both together gives your agent live search data plus senior-level SEO judgment. <h3>Which core SEO skills matter most for ranking in 2026?</h3> Modern search visibility across Google and AI answer engines comes down to five compounding disciplines covered in this repo: <ol><li><strong>SERP Clustering, Competitor Research & Title Engineering</strong> (<code>dataforseo-serp</code>, <code>ahrefs-research</code>, <code>seo-title-optimization</code>, <code>customer-journey</code>)</li> <li><strong>First-Hand Proof Content, Visuals & De-Slopping</strong> (<code>proof-kb</code>, <code>seo-blog-images</code>, <code>unslop-seo</code>, <code>blog-refresher</code>, <code>intro</code>, <code>scribiz</code>, <code>youtube-seo</code>)</li> <li><strong>Technical Crawlability, Internal Routing & Migrations</strong> (<code>seo-autopilot</code>, <code>seo-roast</code>, <code>internal-linking</code>, <code>domain-migration</code>, <code>block-ai-scrapers</code>)</li> <li><strong>Authority Backlinks, Outreach & Syndication</strong> (<code>directory-submissions</code>, <code>linkdr</code>, <code>honest-link-outreach</code>, <code>parasite-and-pr</code>, <code>awesome-tools</code>)</li> <li><strong>Generative Engine Optimization (GEO / AEO) & Comparison Pages</strong> (<code>aiseotracker</code>, <code>ai-seo-report</code>, <code>content-coverage</code>, <code>vs-and-alternatives</code>, <code>reddit-serp</code>)</li></ol> <hr> <h2>License</h2> <p>MIT © <a href="https://il.ly" target="_blank" rel="noopener">Ilias Ism</a></p> </article> <!-- Article Completion Section --> <div class="reader-footer mt-5 pt-5"> <div class="reader-completion-box rounded-3 p-4 text-center"> <div class="reader-completion-icon mb-3"> <i class="fas fa-check-circle"></i> </div> <p class="reader-completion-text fw-semibold mb-1" style="font-size: 1rem;">You finished the article!</p> <p class="reader-completion-subtext small mb-4">Want to go deeper or explore more stories?</p> <div class="d-flex justify-content-center gap-3 flex-wrap"> <a href="https://github.com/Illyism/seo-skills" target="_blank" rel="noopener noreferrer" class="btn btn-primary-custom btn-sm rounded-pill px-4"> <i class="fas fa-external-link-alt me-2"></i>Full Article on GitHub Trending </a> <a href="https://neshdevtech.com/news" class="reader-back-btn btn btn-sm rounded-pill px-4"> <i class="fas fa-newspaper me-2"></i>More Tech News </a> </div> </div> </div> <!-- Internal Linking CTA --> </div> </div> </div> <!-- Sidebar (desktop only) --> <div class="col-lg-4 col-xl-3 d-none d-lg-block"> <div class="sticky-top" style="top: 80px;"> <!-- Mini Controller Widget --> <div class="card border-0 shadow-sm mb-4 bg-surface"> <div class="card-body p-4"> <h6 class="fw-bold mb-3"><i class="fas fa-glasses me-2 text-primary-custom"></i>Reading Mode</h6> <p class="text-secondary-custom small mb-4">Adjust typography and theme to your preference.</p> <div class="mb-3"> <label class="text-muted-custom small d-block mb-2">Typography</label> <div class="d-flex gap-2"> <button class="btn btn-light btn-sm flex-grow-1 border-custom" id="sidebar-font-serif">Serif</button> <button class="btn btn-light btn-sm flex-grow-1 border-custom" id="sidebar-font-sans">Sans</button> </div> </div> <div class="mb-4"> <label class="text-muted-custom small d-block mb-2">Text Scale</label> <div class="d-flex gap-2"> <button class="btn btn-light btn-sm flex-grow-1 border-custom" id="sidebar-size-dec"><i class="fas fa-minus small"></i></button> <button class="btn btn-light btn-sm flex-grow-1 border-custom" id="sidebar-size-inc"><i class="fas fa-plus small"></i></button> </div> </div> <div class="border-top border-light-custom pt-3"> <a href="https://github.com/Illyism/seo-skills" target="_blank" rel="noopener noreferrer" class="btn btn-outline-primary btn-sm w-100 rounded-pill"> View Original <i class="fas fa-external-link-alt ms-1"></i> </a> </div> </div> </div> <!-- Sidebar Related News --> <div class="card border-0 shadow-sm bg-surface"> <div class="card-header bg-transparent border-0 pt-4 pb-0 px-4"> <h5 class="card-title fw-bold mb-0" style="font-size: 1.05rem;"> <i class="fas fa-newspaper me-2 text-primary-custom"></i>Related Stories </h5> </div> <div class="card-body p-0"> <div class="list-group list-group-flush rounded-0 bg-transparent"> <a href="https://neshdevtech.com/news/norway-to-extend-proposed-under-16-social-media-ban-to-games-and-messaging-apps-KWdRN" class="list-group-item list-group-item-action border-0 px-4 py-3 bg-transparent border-bottom border-light-custom hover-bg-light"> <h6 class="mb-1 fw-semibold text-truncate-2" style="font-size: 0.875rem; line-height: 1.4;"> Norway to extend proposed under-16 social media ban to games and messaging apps </h6> <div class="d-flex align-items-center justify-content-between text-muted-custom mt-1" style="font-size: 0.72rem;"> <span>Hacker News</span> <span>50 minutes ago</span> </div> </a> <a href="https://neshdevtech.com/news/monuments-of-india-part-4-100-new-monuments-from-harappan-dholavira-to-the-chenab-rail-bridge-AYNlB" class="list-group-item list-group-item-action border-0 px-4 py-3 bg-transparent border-bottom border-light-custom hover-bg-light"> <h6 class="mb-1 fw-semibold text-truncate-2" style="font-size: 0.875rem; line-height: 1.4;"> Monuments of India, Part 4: 100 New Monuments, from Harappan Dholavira to the Chenab Rail Bridge </h6> <div class="d-flex align-items-center justify-content-between text-muted-custom mt-1" style="font-size: 0.72rem;"> <span>Dev.to</span> <span>4 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/fastapi-vs-nodejs-vs-bun-one-postgresql-setting-was-worth-up-to-31-no-runtime-changed-unBkQ" class="list-group-item list-group-item-action border-0 px-4 py-3 bg-transparent border-bottom border-light-custom hover-bg-light"> <h6 class="mb-1 fw-semibold text-truncate-2" style="font-size: 0.875rem; line-height: 1.4;"> FastAPI vs Node.js vs Bun: One PostgreSQL Setting Was Worth Up to 31% (No Runtime Changed) </h6> <div class="d-flex align-items-center justify-content-between text-muted-custom mt-1" style="font-size: 0.72rem;"> <span>Dev.to</span> <span>14 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/programming-at-53-code-has-no-age-w1zHo" class="list-group-item list-group-item-action border-0 px-4 py-3 bg-transparent border-bottom border-light-custom hover-bg-light"> <h6 class="mb-1 fw-semibold text-truncate-2" style="font-size: 0.875rem; line-height: 1.4;"> Programming at 53: Code Has No Age </h6> <div class="d-flex align-items-center justify-content-between text-muted-custom mt-1" style="font-size: 0.72rem;"> <span>Dev.to</span> <span>23 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/monuments-of-india-part-3-sixteen-statues-sculpted-from-photographs-a-rebuilt-mysore-palace-and-more-8z0s8" class="list-group-item list-group-item-action border-0 px-4 py-3 bg-transparent border-bottom border-light-custom hover-bg-light"> <h6 class="mb-1 fw-semibold text-truncate-2" style="font-size: 0.875rem; line-height: 1.4;"> Monuments of India, Part 3: Sixteen Statues Sculpted from Photographs, a Rebuilt Mysore Palace and More </h6> <div class="d-flex align-items-center justify-content-between text-muted-custom mt-1" style="font-size: 0.72rem;"> <span>Dev.to</span> <span>1 day ago</span> </div> </a> </div> </div> </div> </div> </div> </div> <!-- Mobile: Related News horizontal scroll strip --> <div class="d-block d-lg-none mt-4"> <h6 class="fw-bold mb-3 px-1"> <i class="fas fa-newspaper me-2 text-primary-custom"></i>Related Stories </h6> <div class="related-scroll-strip"> <a href="https://neshdevtech.com/news/norway-to-extend-proposed-under-16-social-media-ban-to-games-and-messaging-apps-KWdRN" class="related-scroll-card"> <p class="related-scroll-title">Norway to extend proposed under-16 social media ban to games and messa...</p> <div class="related-scroll-meta"> <span>Hacker News</span> <span>50 minutes ago</span> </div> </a> <a href="https://neshdevtech.com/news/monuments-of-india-part-4-100-new-monuments-from-harappan-dholavira-to-the-chenab-rail-bridge-AYNlB" class="related-scroll-card"> <p class="related-scroll-title">Monuments of India, Part 4: 100 New Monuments, from Harappan Dholavira...</p> <div class="related-scroll-meta"> <span>Dev.to</span> <span>4 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/fastapi-vs-nodejs-vs-bun-one-postgresql-setting-was-worth-up-to-31-no-runtime-changed-unBkQ" class="related-scroll-card"> <p class="related-scroll-title">FastAPI vs Node.js vs Bun: One PostgreSQL Setting Was Worth Up to 31%...</p> <div class="related-scroll-meta"> <span>Dev.to</span> <span>14 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/programming-at-53-code-has-no-age-w1zHo" class="related-scroll-card"> <p class="related-scroll-title">Programming at 53: Code Has No Age</p> <div class="related-scroll-meta"> <span>Dev.to</span> <span>23 hours ago</span> </div> </a> <a href="https://neshdevtech.com/news/monuments-of-india-part-3-sixteen-statues-sculpted-from-photographs-a-rebuilt-mysore-palace-and-more-8z0s8" class="related-scroll-card"> <p class="related-scroll-title">Monuments of India, Part 3: Sixteen Statues Sculpted from Photographs,...</p> <div class="related-scroll-meta"> <span>Dev.to</span> <span>1 day ago</span> </div> </a> </div> </div> </div> </section> </main> <!-- Footer --> <!-- Footer --> <footer class="py-5 mt-5 position-relative overflow-hidden" style="background: var(--surface); border-top: 1px solid var(--border); box-shadow: var(--shadow-lg);"> <!-- Decorative subtle background gradients --> <div class="position-absolute" style="top: -200px; right: -200px; width: 400px; height: 400px; background: rgba(var(--primary-rgb), 0.03); filter: blur(100px); border-radius: 50%; pointer-events: none;"></div> <div class="position-absolute" style="bottom: -200px; left: -200px; width: 400px; height: 400px; background: rgba(var(--accent-rgb), 0.03); filter: blur(100px); border-radius: 50%; pointer-events: none;"></div> <div class="container position-relative z-3"> <div class="row g-4"> <!-- Column 1: Brand & About --> <div class="col-lg-4 col-md-6"> <div class="d-flex align-items-center mb-3"> <span class="brand-mark me-2" style="width: 42px; height: 42px;" aria-hidden="true"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg> </span> <span class="fs-4 fw-extrabold text-primary-custom" style="letter-spacing: -0.05em; font-family: 'JetBrains Mono', monospace;">NeshDevTech</span> </div> <p class="text-secondary-custom mb-4 pe-lg-4" style="font-size: 0.95rem; line-height: 1.6;">NeshDevTech is a professional technology firm passionate about creating innovative, high-performance web and mobile solutions.</p> <div class="d-flex gap-2"> </div> </div> <!-- Column 2: Navigation Links --> <div class="col-lg-2 col-md-6 col-6"> <h6 class="text-primary-custom fw-bold text-uppercase mb-3" style="font-size: 0.85rem; letter-spacing: 0.05em;">Quick Navigation</h6> <ul class="list-unstyled mb-0"> <li class="mb-2"><a href="https://neshdevtech.com" class="footer-link text-secondary-custom text-decoration-none d-inline-block">Home</a></li> <li class="mb-2"><a href="https://neshdevtech.com/projects" class="footer-link text-secondary-custom text-decoration-none d-inline-block">Projects</a></li> <li class="mb-2"><a href="https://neshdevtech.com/blog" class="footer-link text-secondary-custom text-decoration-none d-inline-block">Tech Blog</a></li> <li class="mb-2"><a href="https://neshdevtech.com/pricing" class="footer-link text-secondary-custom text-decoration-none d-inline-block">Get Quote</a></li> <li class="mb-2"><a href="https://neshdevtech.com/contact" class="footer-link text-secondary-custom text-decoration-none d-inline-block">Contact Me</a></li> </ul> </div> <!-- Column 3: Tech Stack & Services --> <div class="col-lg-3 col-md-6 col-6"> <h6 class="text-primary-custom fw-bold text-uppercase mb-3" style="font-size: 0.85rem; letter-spacing: 0.05em;">Core Services</h6> <ul class="list-unstyled mb-0"> <li class="text-secondary-custom mb-2 small"><i class="bi bi-rocket-takeoff text-primary-custom me-2"></i>Custom Laravel Apps</li> <li class="text-secondary-custom mb-2 small"><i class="bi bi-laptop text-primary-custom me-2"></i>SPA (React & Vue.js)</li> <li class="text-secondary-custom mb-2 small"><i class="bi bi-phone-vibrate text-primary-custom me-2"></i>Flutter Mobile Apps</li> <li class="text-secondary-custom mb-2 small"><i class="bi bi-search text-primary-custom me-2"></i>SEO & Performance Opt</li> </ul> </div> <!-- Column 4: Contact & Availability --> <div class="col-lg-3 col-md-6"> <h6 class="text-primary-custom fw-bold text-uppercase mb-3" style="font-size: 0.85rem; letter-spacing: 0.05em;">Get in Touch</h6> <ul class="list-unstyled mb-3"> <li class="text-secondary-custom mb-2 small d-flex align-items-center"> <i class="bi bi-geo-alt text-primary-custom me-2 fs-6"></i>Nairobi, Kenya </li> <li class="text-secondary-custom mb-2 small d-flex align-items-center"> <i class="bi bi-envelope-at text-primary-custom me-2 fs-6"></i> <a href="mailto:info@neshdevtech.com" class="text-secondary-custom text-decoration-none footer-link">info@neshdevtech.com</a> </li> </ul> <div class="bg-primary-custom-light border border-primary-custom border-opacity-10 p-3 rounded-3" style="border-radius: 12px !important;"> <small class="d-block fw-semibold text-primary-custom mb-1"><i class="bi bi-patch-check-fill me-1"></i>Available for Projects</small> <p class="mb-0 text-secondary-custom small" style="font-size: 0.8rem; line-height: 1.4;">Need a high-performing system? Let's discuss your project.</p> </div> </div> </div> <hr style="border-color: var(--border); opacity: 0.8; margin: 2.5rem 0 2rem;"> <div class="row align-items-center"> <div class="col-md-6 text-center text-md-start mb-2 mb-md-0"> <p class="mb-0 text-secondary-custom small">© 2026 NeshDevTech. All rights reserved.</p> </div> <div class="col-md-6 text-center text-md-end"> <p class="mb-0 text-secondary-custom small">Built with <i class="bi bi-heart-fill text-danger"></i></p> </div> </div> </div> </footer> <!-- Bootstrap JS --> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script> <!-- Custom JavaScript --> <script> // Theme Management System class ThemeManager { constructor() { this.themeToggle = document.getElementById('themeToggle'); this.themeIcon = document.getElementById('theme-icon'); this.mobileThemeToggle = document.getElementById('mobileThemeToggle'); this.mobileThemeIcon = document.getElementById('mobile-theme-icon'); this.init(); } init() { // Get current theme (already applied in head) const currentTheme = document.documentElement.getAttribute('data-theme') || 'light'; // Update icons to match current theme this.updateIcon(currentTheme); // Listen for desktop theme toggle clicks if (this.themeToggle) { this.themeToggle.addEventListener('click', (e) => { e.preventDefault(); this.toggleTheme(); }); } // Listen for mobile theme toggle clicks if (this.mobileThemeToggle) { this.mobileThemeToggle.addEventListener('click', (e) => { e.preventDefault(); this.toggleTheme(); }); } // Listen for system theme changes window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (e) => { if (!localStorage.getItem('theme')) { this.setTheme(e.matches ? 'dark' : 'light'); } }); } setTheme(theme) { document.documentElement.setAttribute('data-theme', theme); document.documentElement.setAttribute('data-bs-theme', theme); if (theme === 'dark') { document.documentElement.classList.add('dark'); } else { document.documentElement.classList.remove('dark'); } localStorage.setItem('theme', theme); this.updateThemeColor(theme); this.updateIcon(theme); } updateThemeColor(theme) { document.querySelectorAll('meta[name="theme-color"]').forEach((meta) => { meta.setAttribute('content', theme === 'dark' ? '#1c2028' : '#e4e8f0'); }); } toggleTheme() { const currentTheme = document.documentElement.getAttribute('data-theme'); const newTheme = currentTheme === 'dark' ? 'light' : 'dark'; this.setTheme(newTheme); // Close mobile menu if open const navbarCollapse = document.querySelector('.navbar-collapse'); if (navbarCollapse && navbarCollapse.classList.contains('show') && window.innerWidth < 992) { setTimeout(() => { const bsCollapse = new bootstrap.Collapse(navbarCollapse, { toggle: false }); bsCollapse.hide(); }, 150); } } updateIcon(theme) { const iconClass = theme === 'dark' ? 'bi bi-sun-fill' : 'bi bi-moon-fill'; // Update desktop icon if (this.themeIcon) { this.themeIcon.className = iconClass; } // Update mobile icon if (this.mobileThemeIcon) { this.mobileThemeIcon.className = iconClass; } } } // Initialize theme manager when DOM is loaded document.addEventListener('DOMContentLoaded', () => { new ThemeManager(); // Initialize navbar live clock (function initNavClock(){ const clockEls = Array.from(document.querySelectorAll('[data-clock]')); if (!clockEls.length) return; const locale = navigator.language || 'en-US'; // Detect 12/24h by locale: use resolvedOptions hourCycle when available const dtf = new Intl.DateTimeFormat(locale, { hour: 'numeric' }); const uses12h = (dtf.resolvedOptions().hour12 === true); const fmt = new Intl.DateTimeFormat(locale, { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: uses12h }); const update = () => { const now = new Date(); const text = fmt.format(now); clockEls.forEach(el => { el.textContent = text; }); }; update(); setInterval(update, 1000); })(); }); // Smooth scrolling for anchor links document.querySelectorAll('a[href^="#"]').forEach(anchor => { anchor.addEventListener('click', function (e) { e.preventDefault(); const target = document.querySelector(this.getAttribute('href')); if (target) { target.scrollIntoView({ behavior: 'smooth', block: 'start' }); } }); }); // Navbar background on scroll window.addEventListener('scroll', () => { const navbar = document.querySelector('.navbar'); if (window.scrollY > 50) { navbar.style.backdropFilter = 'blur(20px)'; navbar.style.backgroundColor = 'rgba(var(--background-rgb), 0.8)'; } else { navbar.style.backdropFilter = 'blur(10px)'; navbar.style.backgroundColor = 'var(--background)'; } }); // Add fade-in animation to elements when they come into view const observerOptions = { threshold: 0.1, rootMargin: '0px 0px -50px 0px' }; const observer = new IntersectionObserver((entries) => { entries.forEach(entry => { if (entry.isIntersecting) { entry.target.classList.add('animate-fade-in-up'); } }); }, observerOptions); // Observe elements with animation class document.addEventListener('DOMContentLoaded', () => { document.querySelectorAll('.animate-on-scroll').forEach(el => { observer.observe(el); }); }); // Enhanced mobile menu functionality document.addEventListener('DOMContentLoaded', function() { const navbarToggler = document.querySelector('.navbar-toggler'); const navbarCollapse = document.querySelector('.navbar-collapse'); const navLinks = document.querySelectorAll('.navbar-nav .nav-link'); const socialLinks = document.querySelectorAll('.navbar-nav .d-flex a'); let isToggling = false; // Prevent rapid clicking // Enhanced menu close function function closeMenu() { if (navbarCollapse && navbarCollapse.classList.contains('show')) { // Use Bootstrap's collapse API for smooth transition const bsCollapse = new bootstrap.Collapse(navbarCollapse, { toggle: false }); bsCollapse.hide(); } // Reset hamburger animation and aria-expanded if (navbarToggler) { navbarToggler.classList.remove('active'); navbarToggler.setAttribute('aria-expanded', 'false'); } } // Enhanced hamburger toggle functionality if (navbarToggler) { navbarToggler.addEventListener('click', function(e) { e.preventDefault(); // Prevent rapid clicking if (isToggling) return; isToggling = true; const isMenuOpen = navbarCollapse.classList.contains('show'); if (isMenuOpen) { closeMenu(); } else { // Open menu const bsCollapse = new bootstrap.Collapse(navbarCollapse, { toggle: false }); bsCollapse.show(); navbarToggler.setAttribute('aria-expanded', 'true'); } // Reset toggle flag after animation setTimeout(() => { isToggling = false; }, 350); }); } // Close menu when clicking outside document.addEventListener('click', function(event) { const isClickInsideNav = navbarCollapse.contains(event.target); const isToggler = navbarToggler.contains(event.target); const isMenuOpen = navbarCollapse.classList.contains('show'); if (!isClickInsideNav && !isToggler && isMenuOpen && window.innerWidth < 992) { closeMenu(); } }); // Close menu when clicking on navigation links (mobile) navLinks.forEach(function(link) { link.addEventListener('click', function(e) { const isMenuOpen = navbarCollapse.classList.contains('show'); if (isMenuOpen && window.innerWidth < 992 && !this.classList.contains('dropdown-toggle')) { // Add a small delay to let the link navigation start setTimeout(() => { closeMenu(); }, 100); } }); }); // Close menu when clicking on social links (mobile) socialLinks.forEach(function(link) { link.addEventListener('click', function() { if (window.innerWidth < 992) { setTimeout(() => { closeMenu(); }, 100); } }); }); // Escape key closes menu document.addEventListener('keydown', function(event) { if (event.key === 'Escape' && window.innerWidth < 992) { closeMenu(); } }); // Handle window resize to close menu when switching to desktop window.addEventListener('resize', function() { if (window.innerWidth >= 992) { closeMenu(); } }); // Theme toggle functionality is handled by ThemeManager class // No separate event listener needed here // Prevent menu items from being too small on touch devices if ('ontouchstart' in window) { navLinks.forEach(function(link) { link.style.minHeight = '44px'; link.style.display = 'flex'; link.style.alignItems = 'center'; }); } // Add smooth scrolling for anchor links within pages navLinks.forEach(function(link) { const href = link.getAttribute('href'); if (href && href.startsWith('#')) { link.addEventListener('click', function(e) { e.preventDefault(); const target = document.querySelector(href); if (target) { target.scrollIntoView({ behavior: 'smooth', block: 'start' }); } closeMenu(); }); } }); }); </script> <script> // Sticky navbar scroll enhancement (desktop only) (function () { const navbar = document.querySelector('.navbar'); if (!navbar) return; let ticking = false; const SCROLL_THRESHOLD = 20; // px function updateNavbar() { if (window.innerWidth >= 992) { if (window.scrollY > SCROLL_THRESHOLD) { navbar.classList.add('scrolled'); } else { navbar.classList.remove('scrolled'); } } else { // Always remove on mobile so it doesn't affect mobile look navbar.classList.remove('scrolled'); } ticking = false; } window.addEventListener('scroll', function () { if (!ticking) { requestAnimationFrame(updateNavbar); ticking = true; } }, { passive: true }); window.addEventListener('resize', updateNavbar, { passive: true }); // Run once on page load in case page is already scrolled (e.g. back-navigation) updateNavbar(); })(); </script> <script> // Lightweight toast badge notifications (function(){ function ensureContainer(){ let c = document.getElementById('toast-badge-container'); if(!c){ c = document.createElement('div'); c.id = 'toast-badge-container'; c.setAttribute('aria-live','polite'); c.setAttribute('aria-atomic','true'); document.body.appendChild(c); } return c; } function iconFor(type){ switch(type){ case 'success': return '<i class="bi bi-check-circle"></i>'; case 'warning': return '<i class="bi bi-exclamation-triangle"></i>'; case 'error': return '<i class="bi bi-x-circle"></i>'; default: return '<i class="bi bi-info-circle"></i>'; } } window.notifyBadge = function(message, opts={}){ const { type = 'success', timeout = 2500 } = opts; const container = ensureContainer(); const el = document.createElement('div'); el.className = 'toast-badge ' + type; el.setAttribute('role','status'); el.innerHTML = '<span class="icon">'+iconFor(type)+'</span><span>'+message+'</span>'; container.appendChild(el); requestAnimationFrame(()=>{ el.classList.add('show'); }); const remove = () => { el.classList.remove('show'); setTimeout(()=> el.remove(), 200); }; setTimeout(remove, timeout); return { remove }; }; // Global copy helper used by inline buttons window.copyToClipboard = function(url){ try { navigator.clipboard.writeText(url).then(()=>{ // Update the clicked button, if available let btn = document.activeElement && document.activeElement.tagName === 'BUTTON' ? document.activeElement : (window.event && window.event.target && window.event.target.closest ? window.event.target.closest('button') : null); if (btn){ const original = btn.innerHTML; btn.innerHTML = '<i class="fas fa-check me-1"></i> Copied!'; btn.classList.remove('btn-outline-secondary'); btn.classList.add('btn-success'); setTimeout(()=>{ btn.innerHTML = original; btn.classList.remove('btn-success'); btn.classList.add('btn-outline-secondary'); }, 2000); } notifyBadge('Link copied to clipboard', { type: 'success' }); }).catch((err)=>{ console.error('Clipboard error:', err); notifyBadge('Could not copy link', { type: 'error' }); }); } catch (e) { console.error(e); notifyBadge('Copy not supported', { type: 'error' }); } }; })(); </script> <a href="https://wa.me/254768033943?text=Hi%2C+I+visited+your+website+and+would+like+to+inquire+about+your+services." class="whatsapp-btn-float" target="_blank" rel="noopener noreferrer" aria-label="Chat on WhatsApp"> <i class="fab fa-whatsapp"></i> <span class="whatsapp-tooltip">Chat with me</span> </a> <style> .whatsapp-btn-float { position: fixed; bottom: 24px; right: 24px; z-index: 1050; display: flex; align-items: center; justify-content: center; background-color: #25d366; color: #fff !important; width: 60px; height: 60px; border-radius: 50%; box-shadow: 0 4px 16px rgba(37, 211, 102, 0.45); text-decoration: none; transition: all 0.3s cubic-bezier(0.175, 0.885, 0.32, 1.275); } .whatsapp-btn-float i { font-size: 32px; transition: transform 0.3s ease; } .whatsapp-btn-float:hover { background-color: #128c7e; transform: scale(1.1); box-shadow: 0 6px 20px rgba(18, 140, 126, 0.6); } .whatsapp-btn-float:hover i { transform: rotate(10deg); } /* Pulsing ring animation */ .whatsapp-btn-float::before { content: ''; position: absolute; width: 100%; height: 100%; border-radius: 50%; background-color: #25d366; opacity: 0.7; z-index: -1; animation: whatsapp-pulse 2s infinite; } @keyframes whatsapp-pulse { 0% { transform: scale(1); opacity: 0.7; } 100% { transform: scale(1.6); opacity: 0; } } /* Tooltip style utilizing site-wide theme colors */ .whatsapp-btn-float .whatsapp-tooltip { position: absolute; right: 76px; background-color: var(--surface); color: var(--text-primary); border: 1px solid var(--border); padding: 8px 14px; border-radius: 20px; font-size: 14px; font-weight: 600; white-space: nowrap; opacity: 0; visibility: hidden; transform: translateX(10px); transition: all 0.3s ease; box-shadow: var(--shadow); pointer-events: none; } .whatsapp-btn-float:hover .whatsapp-tooltip { opacity: 1; visibility: visible; transform: translateX(0); } /* Responsive Design */ @media (max-width: 768px) { .whatsapp-btn-float { bottom: 16px; right: 16px; width: 50px; height: 50px; } .whatsapp-btn-float i { font-size: 26px; } .whatsapp-btn-float .whatsapp-tooltip { display: none; /* Hide tooltip on small screens to prevent overlap issues */ } } </style> <!-- Mobile More Menu (Offcanvas Bottom Sheet) - Auth actions only --> <style> /* ══════════════════════════════════════════════════════════════ NEUMORPHISM REVAMP (front-end only) Soft-extruded UI: same-tone surfaces with dual light/dark shadows. This block sits at the end of the body so it layers over every page's own styles without touching page markup. ══════════════════════════════════════════════════════════════ */ /* ── Buttons: extruded, press-in on click ─────────────────────── */ .btn { box-shadow: var(--shadow) !important; transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1) !important; } .btn:hover { transform: translateY(-2px) !important; box-shadow: var(--shadow-md) !important; } .btn:active:not(.btn-link), .btn.show { transform: translateY(1px) scale(0.99) !important; box-shadow: var(--shadow-inset) !important; } .btn-primary-custom, .btn-primary, .btn-success { background: var(--primary-color) !important; border-color: var(--primary-color) !important; color: #fff !important; box-shadow: var(--shadow) !important; } .btn-primary-custom:hover, .btn-primary:hover, .btn-success:hover { background: var(--primary-dark) !important; border-color: var(--primary-dark) !important; color: #fff !important; box-shadow: var(--shadow-md) !important; } .btn-outline-primary-custom, .btn-outline-primary, .btn-outline-success, .btn-outline-secondary, .btn-outline-danger, .btn-outline-dark, .btn-light { background-color: var(--surface) !important; border-color: transparent !important; color: var(--text-primary) !important; box-shadow: var(--shadow) !important; } .btn-outline-primary-custom:hover, .btn-outline-primary:hover { background-color: var(--primary-color) !important; border-color: var(--primary-color) !important; color: #fff !important; box-shadow: var(--shadow-md) !important; } .btn-outline-success:hover { background-color: var(--primary-color) !important; border-color: var(--primary-color) !important; color: #fff !important; box-shadow: var(--shadow-md) !important; } .btn-outline-secondary:hover { background-color: var(--text-secondary) !important; border-color: var(--text-secondary) !important; color: #fff !important; box-shadow: var(--shadow-md) !important; } .btn-outline-danger:hover { background-color: #ef4444 !important; border-color: #ef4444 !important; color: #fff !important; box-shadow: var(--shadow-md) !important; } .btn-outline-dark:hover, .btn-light:hover { background-color: var(--text-secondary) !important; border-color: var(--text-secondary) !important; color: var(--background) !important; box-shadow: var(--shadow-md) !important; } .btn-dark { background-color: var(--text-primary) !important; border-color: var(--text-primary) !important; color: var(--background) !important; box-shadow: var(--shadow) !important; } /* ── Forms: pressed-in surfaces ────────────────────────────────── */ .form-control, .form-select { background-color: var(--surface) !important; border: 1px solid transparent !important; color: var(--text-primary) !important; border-radius: 14px !important; box-shadow: var(--shadow-inset) !important; transition: box-shadow 0.3s ease, background-color 0.25s ease !important; } .form-control:focus, .form-select:focus { background-color: var(--surface) !important; border-color: transparent !important; color: var(--text-primary) !important; box-shadow: var(--shadow-inset), 0 0 0 4px rgba(var(--primary-rgb), 0.15) !important; } .form-control::placeholder { color: var(--text-muted) !important; } .input-group-text { background-color: var(--surface-alt) !important; border: 1px solid transparent !important; color: var(--text-secondary) !important; box-shadow: var(--shadow-inset-sm) !important; } /* ── Navbar: floating neumorphic pill (tablet & desktop) ──────── */ .navbar { background-color: rgba(var(--background-rgb), 0.9) !important; border-bottom: 1px solid transparent !important; backdrop-filter: blur(16px) !important; -webkit-backdrop-filter: blur(16px) !important; box-shadow: var(--shadow-md) !important; } [data-theme="dark"] .navbar { box-shadow: var(--shadow-md) !important; } @media (min-width: 768px) { .navbar { top: 14px !important; left: 18px !important; right: 18px !important; width: auto !important; border-radius: 20px !important; padding: 0.6rem 0 !important; box-shadow: var(--shadow-lg) !important; } [data-theme="dark"] .navbar { box-shadow: var(--shadow-lg) !important; } .navbar.scrolled { background-color: rgba(var(--background-rgb), 0.95) !important; border-bottom-color: transparent !important; padding: 0.5rem 0 !important; box-shadow: var(--shadow-lg) !important; } [data-theme="dark"] .navbar.scrolled { background-color: rgba(28, 32, 40, 0.95) !important; box-shadow: var(--shadow-lg) !important; } body { padding-top: 96px !important; } .reading-progress-container { top: 88px !important; } } /* ── Tablet refinements (768px - 991.98px) ────────────────────── */ @media (min-width: 768px) and (max-width: 991.98px) { /* Hamburger dropdown panel blends with the floating pill */ .navbar-collapse { border-radius: 20px !important; border-color: transparent !important; } body { padding-bottom: 0 !important; } .whatsapp-btn-float { bottom: 24px !important; } /* Hero: tighten the inline 80px top padding that assumed a full-height bar, so tablets don't get excessive empty space */ .hero-section-bg { padding-top: 40px !important; } } /* ── Neumorphic brand icon mark ────────────────────────────────── */ .brand-mark { width: 40px; height: 40px; flex-shrink: 0; border-radius: 13px; background-color: var(--surface) !important; color: var(--primary-color) !important; display: inline-flex; align-items: center; justify-content: center; box-shadow: var(--shadow) !important; transition: box-shadow 0.3s cubic-bezier(0.16, 1, 0.3, 1), transform 0.3s cubic-bezier(0.16, 1, 0.3, 1); } .brand-mark svg { width: 21px; height: 21px; } a:hover .brand-mark { box-shadow: var(--shadow-inset-sm) !important; transform: translateY(1px); } .mobile-logo .brand-mark { width: 34px; height: 34px; border-radius: 11px; } .mobile-logo .brand-mark svg { width: 17px; height: 17px; } /* ── Uploaded brand logo image ─────────────────────────────────── */ .brand-img { height: 38px; width: auto; max-width: 160px; object-fit: contain; flex-shrink: 0; } .brand-img-sm { height: 28px; max-width: 120px; } .brand-img-footer { height: 44px; max-width: 180px; } /* ── Mobile bars: floating neumorphic pills (phones) ──────────── */ @media (max-width: 767.98px) { .mobile-top-bar { top: 8px !important; left: 12px !important; right: 12px !important; height: 52px !important; border-radius: 16px !important; border-bottom: none !important; background-color: rgba(var(--surface-rgb), 0.92) !important; box-shadow: var(--shadow-md) !important; } .mobile-bottom-bar { left: 12px !important; right: 12px !important; bottom: 12px !important; height: 58px !important; border-radius: 18px !important; border-top: none !important; background-color: rgba(var(--surface-rgb), 0.92) !important; box-shadow: var(--shadow-md) !important; } body { padding-top: 74px !important; padding-bottom: 86px !important; } .whatsapp-btn-float { bottom: 88px !important; } .reading-progress-container { top: 70px !important; } } /* ── Nav pill widgets: pressed-in ──────────────────────────────── */ .theme-toggle, .mobile-theme-toggle, .nav-clock { background-color: var(--surface) !important; border-color: transparent !important; box-shadow: var(--shadow-inset-sm) !important; } /* ── Icon chips, markers & circles: extruded ───────────────────── */ .icon-wrap, .icon-wrapper, .expertise-card-icon, .timeline-marker, .mobile-more-icon-wrapper, .social-circle, .value-icon, .skill-icon-box { box-shadow: var(--shadow) !important; border-color: transparent !important; } /* ── Panels: extruded ──────────────────────────────────────────── */ .accordion-item { border-color: transparent !important; box-shadow: var(--shadow) !important; } .timeline-content { background: var(--surface) !important; border-radius: 12px !important; padding: 1rem 1.25rem !important; box-shadow: var(--shadow) !important; } .feature-item { background: var(--surface) !important; border-color: transparent !important; box-shadow: var(--shadow) !important; } .feature-item:hover { transform: translateY(-2px) !important; box-shadow: var(--shadow-md) !important; } .progress { background-color: var(--surface-alt) !important; box-shadow: var(--shadow-inset-sm) !important; } /* Card hover: consistent soft neu shadow */ .card-hover:hover, .project-card:hover, .blog-card:hover, .post-card:hover, .news-card:hover, .testimonial-card:hover, .hover-lift:hover, .stats-item:hover { box-shadow: var(--shadow-lg) !important; } </style> <script> document.addEventListener('DOMContentLoaded', function() { const readerCard = document.getElementById('reader-card'); if (!readerCard) return; // Settings Key constants const THEME_KEY = 'reader_mode_theme'; const FONT_KEY = 'reader_mode_font'; const SIZE_KEY = 'reader_mode_size'; // Available Options const themes = ['light', 'sepia', 'dark', 'oled']; const fonts = ['serif', 'sans']; const sizes = ['xs', 'sm', 'md', 'lg', 'xl']; // Default Configs const siteTheme = document.documentElement.getAttribute('data-theme') || 'light'; const defaultTheme = siteTheme === 'dark' ? 'dark' : 'light'; let currentTheme = localStorage.getItem(THEME_KEY) || defaultTheme; let currentFont = localStorage.getItem(FONT_KEY) || 'serif'; let currentSize = localStorage.getItem(SIZE_KEY) || 'md'; // Apply initial config applySettings(); // Register Action Listeners (Toolbar) document.getElementById('btn-font-serif').addEventListener('click', () => setFont('serif')); document.getElementById('btn-font-sans').addEventListener('click', () => setFont('sans')); document.getElementById('btn-size-decrease').addEventListener('click', () => adjustSize(-1)); document.getElementById('btn-size-increase').addEventListener('click', () => adjustSize(1)); document.getElementById('theme-light').addEventListener('click', () => setTheme('light')); document.getElementById('theme-sepia').addEventListener('click', () => setTheme('sepia')); document.getElementById('theme-dark').addEventListener('click', () => setTheme('dark')); document.getElementById('theme-oled').addEventListener('click', () => setTheme('oled')); // Register Action Listeners (Sidebar widgets, if present) const sidebarSerif = document.getElementById('sidebar-font-serif'); const sidebarSans = document.getElementById('sidebar-font-sans'); const sidebarSizeDec = document.getElementById('sidebar-size-dec'); const sidebarSizeInc = document.getElementById('sidebar-size-inc'); if (sidebarSerif) sidebarSerif.addEventListener('click', () => setFont('serif')); if (sidebarSans) sidebarSans.addEventListener('click', () => setFont('sans')); if (sidebarSizeDec) sidebarSizeDec.addEventListener('click', () => adjustSize(-1)); if (sidebarSizeInc) sidebarSizeInc.addEventListener('click', () => adjustSize(1)); // Action Core Functions function setTheme(theme) { currentTheme = theme; localStorage.setItem(THEME_KEY, theme); applySettings(); } function setFont(font) { currentFont = font; localStorage.setItem(FONT_KEY, font); applySettings(); } function adjustSize(delta) { let index = sizes.indexOf(currentSize); index = Math.max(0, Math.min(sizes.length - 1, index + delta)); currentSize = sizes[index]; localStorage.setItem(SIZE_KEY, currentSize); applySettings(); } function applySettings() { // 1. Reset theme classes and apply selected themes.forEach(t => readerCard.classList.remove('reader-theme-' + t)); readerCard.classList.add('reader-theme-' + currentTheme); // Update Theme circles highlight themes.forEach(t => { const circle = document.getElementById('theme-' + t); if (circle) { if (t === currentTheme) { circle.classList.add('active'); } else { circle.classList.remove('active'); } } }); // 2. Reset Font classes and apply selected fonts.forEach(f => readerCard.classList.remove('reader-font-' + f)); readerCard.classList.add('reader-font-' + currentFont); // Highlight Font buttons const serifBtns = [document.getElementById('btn-font-serif'), document.getElementById('sidebar-font-serif')]; const sansBtns = [document.getElementById('btn-font-sans'), document.getElementById('sidebar-font-sans')]; serifBtns.forEach(btn => { if (btn) { if (currentFont === 'serif') { btn.classList.add('btn-primary-custom'); btn.classList.remove('btn-light'); } else { btn.classList.add('btn-light'); btn.classList.remove('btn-primary-custom'); } } }); sansBtns.forEach(btn => { if (btn) { if (currentFont === 'sans') { btn.classList.add('btn-primary-custom'); btn.classList.remove('btn-light'); } else { btn.classList.add('btn-light'); btn.classList.remove('btn-primary-custom'); } } }); // 3. Reset Sizing classes and apply selected sizes.forEach(s => readerCard.classList.remove('reader-size-' + s)); readerCard.classList.add('reader-size-' + currentSize); } // Reading Scroll progress calculation const progressBar = document.getElementById('reading-progress-bar'); window.addEventListener('scroll', () => { const documentHeight = document.documentElement.scrollHeight - window.innerHeight; if (documentHeight > 0) { const scrollProgress = (window.pageYOffset / documentHeight) * 100; progressBar.style.width = scrollProgress + '%'; } }); }); </script> <script> // ══════════════════════════════════════════════════════════════ // PWA: Service Worker registration + install prompt // ══════════════════════════════════════════════════════════════ (function () { const PWA_VERSION = '20260805-1'; // ---- Service worker ------------------------------------ if ('serviceWorker' in navigator) { window.addEventListener('load', () => { navigator.serviceWorker.register('/sw.js?v=' + PWA_VERSION).then((reg) => { // Apply updates (new deploy) on the next load without disruption reg.addEventListener('updatefound', () => { const newWorker = reg.installing; if (!newWorker) return; newWorker.addEventListener('statechange', () => { if (newWorker.state === 'installed' && navigator.serviceWorker.controller) { newWorker.postMessage({ type: 'SKIP_WAITING' }); } }); }); }).catch(() => {}); }); } // ---- Install prompt -------------------------------------- let deferredPrompt = null; const bannerId = 'pwa-install-banner'; const DISMISS_KEY = 'nesh-install-dismissed'; function showInstallBanner() { if (localStorage.getItem(DISMISS_KEY) || document.getElementById(bannerId)) return; const banner = document.createElement('div'); banner.id = bannerId; banner.setAttribute('role', 'dialog'); banner.setAttribute('aria-label', 'Install app'); banner.innerHTML = '<div class="pwa-install-content">' + '<span class="pwa-install-icon">' + '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>' + '</span>' + '<div class="pwa-install-text">' + '<strong>Install NeshDevTech</strong>' + '<span>Get the app on your device</span>' + '</div>' + '<button type="button" class="pwa-install-btn" id="pwa-install-btn">Install</button>' + '<button type="button" class="pwa-install-close" id="pwa-install-close" aria-label="Dismiss">×</button>' + '</div>'; document.body.appendChild(banner); document.getElementById('pwa-install-btn').addEventListener('click', () => { if (!deferredPrompt) return; deferredPrompt.prompt(); deferredPrompt.userChoice.finally(() => { deferredPrompt = null; hideInstallBanner(); }); }); document.getElementById('pwa-install-close').addEventListener('click', () => { localStorage.setItem(DISMISS_KEY, '1'); hideInstallBanner(); }); requestAnimationFrame(() => banner.classList.add('show')); } function hideInstallBanner() { const banner = document.getElementById(bannerId); if (banner) { banner.classList.remove('show'); setTimeout(() => banner.remove(), 250); } } window.addEventListener('beforeinstallprompt', (e) => { e.preventDefault(); deferredPrompt = e; showInstallBanner(); }); window.addEventListener('appinstalled', () => { deferredPrompt = null; hideInstallBanner(); localStorage.setItem(DISMISS_KEY, '1'); }); })(); </script> <style> .pwa-install-content { display: flex; align-items: center; gap: 12px; padding: 14px 18px; } #pwa-install-banner { position: fixed; left: 50%; transform: translate(-50%, 20px); bottom: 84px; z-index: 1070; background: var(--surface); color: var(--text-primary); border: 1px solid var(--border); border-radius: 18px; box-shadow: var(--shadow-lg); opacity: 0; transition: opacity .25s cubic-bezier(.16, 1, .3, 1), transform .25s cubic-bezier(.16, 1, .3, 1); width: min(420px, calc(100vw - 32px)); } #pwa-install-banner.show { opacity: 1; transform: translate(-50%, 0); } .pwa-install-icon { display: inline-flex; align-items: center; justify-content: center; width: 40px; height: 40px; flex: 0 0 40px; border-radius: 12px; background: rgba(var(--primary-rgb), 0.1); border: 1px solid rgba(var(--primary-rgb), 0.2); color: var(--primary-color); } .pwa-install-icon svg { width: 20px; height: 20px; } .pwa-install-text { display: flex; flex-direction: column; flex: 1; min-width: 0; } .pwa-install-text strong { font-size: 0.92rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } .pwa-install-text span { font-size: 0.78rem; color: var(--text-secondary); } .pwa-install-btn { background: var(--primary-color); border: none; color: #fff; font-weight: 600; font-size: 0.85rem; padding: 8px 18px; border-radius: 9999px; cursor: pointer; white-space: nowrap; box-shadow: 0 4px 12px rgba(var(--primary-rgb), 0.25); transition: all .2s ease; } .pwa-install-btn:hover { background: var(--primary-dark); transform: translateY(-1px); } .pwa-install-close { background: transparent; border: none; color: var(--text-muted); font-size: 1.4rem; line-height: 1; cursor: pointer; padding: 2px 6px; border-radius: 50%; transition: background-color .2s ease, color .2s ease; } .pwa-install-close:hover { background: var(--surface-alt); color: var(--text-primary); } @media (min-width: 992px) { #pwa-install-banner { bottom: 24px; } } </style> </div><!-- /.page-wrapper --> </body> </html>