feat: add GitHub integration, OG image, and Tuist marketing

pepicrft · pepicrft · commit 93b8169956a3 · 2025-12-31T09:22:32.000+01:00
- Add GitHub button to navigation bar with icon
- Update "Found an issue?" to link to GitHub issues/PRs instead of email
- Move "In the tradition of..." text to footer
- Add OG image (f() icon) for social sharing
- Add Tuist attribution in author credit and Tools section
- Update README with current topics and languages
diff --git a/README.md b/README.md
@@ -15,14 +15,17 @@ In the tradition of [fuckingblocksyntax.com](https://fuckingblocksyntax.com/) an
 
 ## Topics Covered
 
-- **Isolation** - The core mental model for Swift concurrency
 - **Async/Await** - Suspension vs blocking, and why it matters
-- **Actors** - When to use them (and when not to)
-- **MainActor** - Your best friend for UI code
-- **Sendable** - The thread-safety certificate
-- **Common Patterns** - Network requests, parallel work, preventing double-taps
+- **Tasks** - Managing async work with Task and TaskGroup
+- **Isolation** - The core mental model for Swift concurrency (MainActor, actors, nonisolated)
+- **Sendable** - What can safely cross isolation boundaries
+- **Isolation Inheritance** - How isolation flows through your code
 - **Common Mistakes** - And how to avoid them
 
+## Languages
+
+Available in 10 languages: English, Spanish, Portuguese (BR & PT), Arabic, Korean, Japanese, Chinese (Simplified & Traditional), and Russian.
+
 ## Development
 
 This site is built with [Eleventy](https://www.11ty.dev/).
diff --git a/src/_layouts/base.njk b/src/_layouts/base.njk
@@ -31,12 +31,17 @@
   <meta property="og:description" content="{{ description }}">
   <meta property="og:site_name" content="Fucking Approachable Swift Concurrency">
   <meta property="og:locale" content="{{ lang | default('en') }}">
+  <meta property="og:image" content="https://fuckingapproachableswiftconcurrency.com/images/og-image.png">
+  <meta property="og:image:width" content="1200">
+  <meta property="og:image:height" content="1200">
+  <meta property="og:image:alt" content="Fucking Approachable Swift Concurrency">
 
   <!-- Twitter -->
   <meta name="twitter:card" content="summary">
   <meta name="twitter:url" content="https://fuckingapproachableswiftconcurrency.com{{ page.url }}">
   <meta name="twitter:title" content="{{ title }}">
   <meta name="twitter:description" content="{{ description }}">
+  <meta name="twitter:image" content="https://fuckingapproachableswiftconcurrency.com/images/og-image.png">
 
   <!-- Favicon -->
   <link rel="icon" type="image/svg+xml" href="/images/favicon.svg">
@@ -87,6 +92,9 @@
         <a href="#{{ key }}">{{ label }}</a>
         {% endfor %}
       </nav>
+      <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency" class="github-link" aria-label="View on GitHub" target="_blank" rel="noopener">
+        <svg width="24" height="24" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z"/></svg>
+      </a>
       <div class="language-selector">
         <button class="language-toggle" aria-label="Select language" aria-expanded="false">
           <span class="current-lang">{{ languages[lang].native | default('English') }}</span>
@@ -110,6 +118,7 @@
   <footer class="site-footer">
     <div class="container">
       <p>{{ footer.madeWith | default('Made with frustration and love. Because Swift concurrency doesn\'t have to be confusing.') }}</p>
+      <p class="tribute">{{ footer.tradition | default('In the tradition of') }} <a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> {{ footer.traditionAnd | default('and') }} <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a></p>
       <p><a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency">{{ footer.viewOnGitHub | default('View on GitHub') }}</a></p>
     </div>
   </footer>
diff --git a/src/ar/index.md b/src/ar/index.md
@@ -13,15 +13,16 @@ nav:
   mistakes: الأخطاء الشائعة
 footer:
   madeWith: صُنع بالإحباط والحب. لأن تزامن Swift لا يجب أن يكون مربكاً.
+  tradition: في تقليد
+  traditionAnd: و
   viewOnGitHub: عرض على GitHub
 ---
 
 <section class="hero">
   <div class="container">
     <h1>دليل سهل جداً<br><span class="accent">لتزامن Swift</span></h1>
     <p class="subtitle">افهم أخيراً async/await والمهام ولماذا المترجم يصرخ عليك.</p>
-    <p class="credit">شكر كبير لـ <a href="https://www.massicotte.org/">Matt Massicotte</a> لجعل تزامن Swift مفهوماً. من إعداد <a href="https://pepicrft.me">Pedro Piñera</a>. وجدت مشكلة؟ <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute">في تقليد <a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> و <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a></p>
+    <p class="credit">شكر كبير لـ <a href="https://www.massicotte.org/">Matt Massicotte</a> لجعل تزامن Swift مفهوماً. من إعداد <a href="https://pepicrft.me">Pedro Piñera</a>، مؤسس مشارك لـ <a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a>. وجدت مشكلة؟ <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">افتح issue</a> أو <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">أرسل PR</a>.</p>
   </div>
 </section>
 
@@ -666,6 +667,12 @@ func fetchAll() async {
 - [توثيق تزامن Swift](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: تعرف على async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: احمِ الحالة القابلة للتغيير مع actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>أدوات</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - طوّر أسرع مع فرق ومشاريع أكبر
 </div>
 
   </div>
diff --git a/src/css/style.css b/src/css/style.css
@@ -922,6 +922,19 @@ blockquote {
   background: rgba(156, 163, 175, 0.15);
 }
 
+/* GitHub Link */
+.github-link {
+  display: flex;
+  align-items: center;
+  color: var(--color-text);
+  opacity: 0.7;
+  transition: opacity 0.2s;
+}
+
+.github-link:hover {
+  opacity: 1;
+}
+
 /* Language Selector */
 .language-selector {
   position: relative;
diff --git a/src/en/index.md b/src/en/index.md
@@ -20,8 +20,7 @@ footer:
   <div class="container">
     <h1>Fucking Approachable<br><span class="accent">Swift Concurrency</span></h1>
     <p class="subtitle">Finally understand async/await, Tasks, and why the compiler keeps yelling at you.</p>
-    <p class="credit">Huge thanks to <a href="https://www.massicotte.org/">Matt Massicotte</a> for making Swift concurrency understandable. Put together by <a href="https://pepicrft.me">Pedro Piñera</a>. Found an issue? <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute">In the tradition of <a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> and <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a></p>
+    <p class="credit">Huge thanks to <a href="https://www.massicotte.org/">Matt Massicotte</a> for making Swift concurrency understandable. Put together by <a href="https://pepicrft.me">Pedro Piñera</a>, co-founder of <a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a>. Found an issue? <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">Open an issue</a> or <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">submit a PR</a>.</p>
   </div>
 </section>
 
@@ -666,6 +665,12 @@ If you're already in an async context, prefer structured concurrency (`async let
 - [Swift Concurrency Documentation](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: Meet async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: Protect mutable state with actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>Tools</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - Ship faster with larger teams and codebases
 </div>
 
   </div>
diff --git a/src/es/index.md b/src/es/index.md
@@ -13,15 +13,16 @@ nav:
   mistakes: Trampas
 footer:
   madeWith: Hecho con frustración y amor. Porque la concurrencia en Swift no tiene que ser confusa.
+  tradition: En la tradición de
+  traditionAnd: y
   viewOnGitHub: Ver en GitHub
 ---
 
 <section class="hero">
   <div class="container">
     <h1>Jodidamente Accesible<br><span class="accent">Swift Concurrency</span></h1>
     <p class="subtitle">Por fin entiende async/await, Tasks, y por qué el compilador no para de gritarte.</p>
-    <p class="credit">Enorme agradecimiento a <a href="https://www.massicotte.org/">Matt Massicotte</a> por hacer comprensible la concurrencia en Swift. Recopilado por <a href="https://pepicrft.me">Pedro Piñera</a>. ¿Encontraste un error? <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute">En la tradición de <a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> y <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a></p>
+    <p class="credit">Enorme agradecimiento a <a href="https://www.massicotte.org/">Matt Massicotte</a> por hacer comprensible la concurrencia en Swift. Recopilado por <a href="https://pepicrft.me">Pedro Piñera</a>, co-fundador de <a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a>. ¿Encontraste un error? <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">Abre un issue</a> o <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">envía un PR</a>.</p>
   </div>
 </section>
 
@@ -666,6 +667,12 @@ Si ya estás en un contexto async, prefiere la concurrencia estructurada (`async
 - [Swift Concurrency Documentation](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: Meet async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: Protect mutable state with actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>Herramientas</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - Desarrolla más rápido con equipos y proyectos grandes
 </div>
 
   </div>
diff --git a/src/images/og-image.png b/src/images/og-image.png
diff --git a/src/images/og-image.svg b/src/images/og-image.svg
@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 1200">
+  <defs>
+    <linearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#F05138;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#FF6B4A;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  
+  <!-- Background -->
+  <rect width="1200" height="1200" fill="url(#grad)"/>
+  
+  <!-- Icon text with monospace font -->
+  <text x="50%" y="50%" font-size="500" text-anchor="middle" dominant-baseline="middle" fill="white" font-family="Courier New, monospace" font-weight="bold">f()</text>
+</svg>
diff --git a/src/ja/index.md b/src/ja/index.md
@@ -13,15 +13,16 @@ nav:
   mistakes: 落とし穴
 footer:
   madeWith: フラストレーションと愛を込めて作りました。Swift の並行処理が難しい必要はないから。
+  tradition: 次の伝統を受け継いで
+  traditionAnd: と
   viewOnGitHub: GitHub で見る
 ---
 
 <section class="hero">
   <div class="container">
     <h1>クソ分かりやすい<br><span class="accent">Swift 並行処理</span></h1>
     <p class="subtitle">async/await、Tasks、そしてコンパイラがなぜあなたに怒鳴り続けるのかを、ついに理解しよう。</p>
-    <p class="credit"><a href="https://www.massicotte.org/">Matt Massicotte</a> 氏に多大な感謝を。Swift 並行処理を理解可能にしてくれました。<a href="https://pepicrft.me">Pedro Piñera</a> がまとめました。問題を見つけた？ <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute"><a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> と <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a> の伝統を受け継いで</p>
+    <p class="credit"><a href="https://www.massicotte.org/">Matt Massicotte</a> 氏に多大な感謝を。Swift 並行処理を理解可能にしてくれました。<a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a> 共同創設者の <a href="https://pepicrft.me">Pedro Piñera</a> がまとめました。問題を見つけた？ <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">Issue を開く</a>か <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">PR を送る</a>。</p>
   </div>
 </section>
 
@@ -666,6 +667,12 @@ func fetchAll() async {
 - [Swift 並行処理ドキュメント](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: Meet async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: Protect mutable state with actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>ツール</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - 大規模なチームとコードベースでより速く開発
 </div>
 
   </div>
diff --git a/src/ko/index.md b/src/ko/index.md
@@ -13,15 +13,16 @@ nav:
   mistakes: 함정
 footer:
   madeWith: 좌절과 사랑으로 만들었습니다. Swift 동시성이 혼란스러울 필요는 없으니까요.
+  tradition: 다음의 전통을 따릅니다
+  traditionAnd: 과
   viewOnGitHub: GitHub에서 보기
 ---
 
 <section class="hero">
   <div class="container">
     <h1>빌어먹게 쉬운<br><span class="accent">Swift 동시성</span></h1>
     <p class="subtitle">드디어 async/await, Tasks, 그리고 왜 컴파일러가 계속 소리 지르는지 이해하세요.</p>
-    <p class="credit"><a href="https://www.massicotte.org/">Matt Massicotte</a>에게 큰 감사를 드립니다. Swift 동시성을 이해할 수 있게 만들어주셨습니다. <a href="https://pepicrft.me">Pedro Piñera</a>가 정리했습니다. 오류를 발견하셨나요? <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute"><a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a>과 <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a>의 전통을 따릅니다</p>
+    <p class="credit"><a href="https://www.massicotte.org/">Matt Massicotte</a>에게 큰 감사를 드립니다. Swift 동시성을 이해할 수 있게 만들어주셨습니다. <a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a>의 공동 창립자 <a href="https://pepicrft.me">Pedro Piñera</a>가 정리했습니다. 오류를 발견하셨나요? <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">이슈 열기</a> 또는 <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">PR 제출</a>.</p>
   </div>
 </section>
 
@@ -666,6 +667,12 @@ func fetchAll() async {
 - [Swift Concurrency Documentation](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: Meet async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: Protect mutable state with actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>도구</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - 더 큰 팀과 코드베이스로 더 빠르게 개발하세요
 </div>
 
   </div>
diff --git a/src/pt-BR/index.md b/src/pt-BR/index.md
@@ -13,15 +13,16 @@ nav:
   mistakes: Armadilhas
 footer:
   madeWith: Feito com frustração e amor. Porque concorrência em Swift não precisa ser confusa.
+  tradition: Na tradição de
+  traditionAnd: e
   viewOnGitHub: Ver no GitHub
 ---
 
 <section class="hero">
   <div class="container">
     <h1>Pra Caralho Acessível<br><span class="accent">Swift Concurrency</span></h1>
     <p class="subtitle">Finalmente entenda async/await, Tasks, e por que o compilador não para de reclamar com você.</p>
-    <p class="credit">Enorme agradecimento a <a href="https://www.massicotte.org/">Matt Massicotte</a> por tornar a concorrência em Swift compreensível. Compilado por <a href="https://pepicrft.me">Pedro Piñera</a>. Encontrou um problema? <a href="mailto:pedro@tuist.dev">pedro@tuist.dev</a></p>
-    <p class="tribute">Na tradição de <a href="https://fuckingblocksyntax.com/">fuckingblocksyntax.com</a> e <a href="https://fuckingifcaseletsyntax.com/">fuckingifcaseletsyntax.com</a></p>
+    <p class="credit">Enorme agradecimento a <a href="https://www.massicotte.org/">Matt Massicotte</a> por tornar a concorrência em Swift compreensível. Compilado por <a href="https://pepicrft.me">Pedro Piñera</a>, co-fundador do <a href="https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=author">Tuist</a>. Encontrou um problema? <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/issues/new">Abra uma issue</a> ou <a href="https://github.com/pepicrft/fuckingapproachableswiftconcurrency/pulls">envie um PR</a>.</p>
   </div>
 </section>
 
@@ -666,6 +667,12 @@ Se você já está em um contexto async, prefira concorrência estruturada (`asy
 - [Swift Concurrency Documentation](https://docs.swift.org/swift-book/documentation/the-swift-programming-language/concurrency/)
 - [WWDC21: Meet async/await](https://developer.apple.com/videos/play/wwdc2021/10132/)
 - [WWDC21: Protect mutable state with actors](https://developer.apple.com/videos/play/wwdc2021/10133/)
+</div>
+
+<div class="resources">
+<h4>Ferramentas</h4>
+
+- [Tuist](https://tuist.dev?utm_source=fuckingapproachableswiftconcurrency&utm_medium=website&utm_campaign=tools) - Desenvolva mais rápido com equipes e projetos maiores
 </div>
 
   </div>
diff --git a/src/pt-PT/index.md b/src/pt-PT/index.md
diff --git a/src/ru/index.md b/src/ru/index.md
diff --git a/src/zh-CN/index.md b/src/zh-CN/index.md
diff --git a/src/zh-TW/index.md b/src/zh-TW/index.md
