{"id":50349894,"url":"https://github.com/osamahassouna/docs-hub","last_synced_at":"2026-05-29T21:00:34.951Z","repository":{"id":361248005,"uuid":"1246057728","full_name":"OsamaHassouna/docs-hub","owner":"OsamaHassouna","description":"Engineering hub for production-grade specs. First guide: HTML Email Playbook + MCP server / CLI that teaches AI clients (Claude Desktop, Cursor) to write email that actually renders in Outlook + Gmail.","archived":false,"fork":false,"pushed_at":"2026-05-29T19:24:40.000Z","size":865,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T20:19:39.998Z","etag":null,"topics":["ai-tools","claude","codex","cursor","email","gmail","html-email","mcp","outlook"],"latest_commit_sha":null,"homepage":"https://docs.osamahassouna.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OsamaHassouna.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-21T20:40:57.000Z","updated_at":"2026-05-29T19:09:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/OsamaHassouna/docs-hub","commit_stats":null,"previous_names":["osamahassouna/docs-hub"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/OsamaHassouna/docs-hub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OsamaHassouna%2Fdocs-hub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OsamaHassouna%2Fdocs-hub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OsamaHassouna%2Fdocs-hub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OsamaHassouna%2Fdocs-hub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OsamaHassouna","download_url":"https://codeload.github.com/OsamaHassouna/docs-hub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OsamaHassouna%2Fdocs-hub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33670211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","claude","codex","cursor","email","gmail","html-email","mcp","outlook"],"created_at":"2026-05-29T21:00:20.261Z","updated_at":"2026-05-29T21:00:34.915Z","avatar_url":"https://github.com/OsamaHassouna.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Osama Hassouna · Docs\n\n[![npm](https://img.shields.io/npm/v/email-playbook-mcp.svg?label=email-playbook-mcp\u0026color=cb3837)](https://www.npmjs.com/package/email-playbook-mcp)\n[![license](https://img.shields.io/npm/l/email-playbook-mcp.svg)](#license)\n[![MCP](https://img.shields.io/badge/MCP-2024--11--05-blue.svg)](https://modelcontextprotocol.io/)\n[![docs](https://img.shields.io/badge/docs-osamahassouna.com-14110F.svg)](https://docs.osamahassouna.com)\n\nSource for [`docs.osamahassouna.com`](https://docs.osamahassouna.com) — an engineering reference hub I keep open while building. Currently one guide is live, with more landing as I write them.\n\n## Live now\n\n### HTML Email Playbook\n\nA working reference for hand-building HTML email templates that render reliably across Outlook (Windows desktop, 2007 through 365), Gmail web + mobile, Apple Mail, Yahoo Mail, and the long tail of clients that haven't moved past 2007.\n\nCovers:\n\n- **Structure** — doctype, head boilerplate, body container, header / body / footer organization\n- **Components** — bulletproof CTA buttons (with Outlook VML fallback), spacing patterns, images, inline icons, background images, text\n- **Compatibility** — Outlook MSO conditional comments, RTL languages, hybrid responsive layouts\n- **Production** — Gmail 102KB clipping, dark mode, preheader text\n- **AI Generation** — rules and patterns for AI tools that generate playbook-compliant email HTML\n\nRead it: [`docs.osamahassouna.com/email-playbook/`](https://docs.osamahassouna.com/email-playbook/)\n\nThere's also a **Playground** at [`/email-playbook/playground/`](https://docs.osamahassouna.com/email-playbook/playground/) with a live editor, instant preview, and a \"From Image\" tab that converts a design screenshot into playbook-compliant HTML.\n\n## Use the playbook in your AI workflow\n\nThe playbook is published as an MCP server + terminal CLI so AI clients (Claude Desktop, Cursor, Cline, etc.) can pull rules and component patterns directly into their reasoning. The model calls structured tools to fetch the exact patterns from the playbook instead of guessing from training data.\n\n```bash\nnpm install -g email-playbook-mcp\n```\n\nSetup, tool reference, and Claude Desktop / Cursor config snippets:\n[`docs.osamahassouna.com/email-playbook/cli/`](https://docs.osamahassouna.com/email-playbook/cli/)\n\nThere's also a hosted JSON-RPC endpoint at [`docs.osamahassouna.com/api/mcp`](https://docs.osamahassouna.com/api/mcp) if you'd rather not install anything.\n\n## License\n\nMIT. Playbook content © Osama Hassouna · [`osamahassouna.com`](https://osamahassouna.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosamahassouna%2Fdocs-hub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosamahassouna%2Fdocs-hub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosamahassouna%2Fdocs-hub/lists"}