Merge pull request #11 from intellica-tech/feat/gamification-phase1

Feat i18n and gamifications

Author: cevheri

.github/workflows/docker.yml

@@ -14,6 +14,7 @@ jobs:
   build-and-push:
     name: Build & Push Docker Image
     runs-on: ubuntu-latest
+    timeout-minutes: 15
 
     # Required permissions for GHCR
     permissions:
@@ -24,15 +25,15 @@ jobs:
     steps:
       # ── 1. Checkout ────────────────────────────────────────────────────────
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       # ── 2. Set up Docker Buildx (multi-platform + cache support) ──────────
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4
 
       # ── 3. Log in to GHCR ──────────────────────────────────────────────────
       - name: Log in to GitHub Container Registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -41,7 +42,7 @@ jobs:
       # ── 4. Extract metadata (tags & labels) ───────────────────────────────
       - name: Extract Docker metadata
         id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
         with:
           images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
           tags: |
@@ -55,7 +56,7 @@ jobs:
       # ── 5. Build and push ─────────────────────────────────────────────────
       - name: Build and push Docker image
         id: push
-        uses: docker/build-push-action@v6
+        uses: docker/build-push-action@v7
         with:
           context: .
           push: true

.github/workflows/pages.yml

@@ -25,23 +25,24 @@ jobs:
   build:
     name: Build Astro Site
     runs-on: ubuntu-latest
+    timeout-minutes: 10
 
     steps:
       # ── 1. Checkout ──────────────────────────────────────────────────────────
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       # ── 2. Setup Node.js ─────────────────────────────────────────────────────
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: '24'
           cache: 'npm'
 
       # ── 3. Setup GitHub Pages (writes correct base path etc.) ────────────────
       - name: Setup GitHub Pages
         id: pages
-        uses: actions/configure-pages@v5
+        uses: actions/configure-pages@v6
 
       # ── 4. Install dependencies ───────────────────────────────────────────────
       - name: Install dependencies
@@ -56,7 +57,7 @@ jobs:
 
       # ── 6. Upload artifact for Pages ─────────────────────────────────────────
       - name: Upload Pages artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           path: ./dist
 
@@ -65,6 +66,7 @@ jobs:
     name: Deploy to GitHub Pages
     needs: build
     runs-on: ubuntu-latest
+    timeout-minutes: 5
 
     environment:
       name: github-pages
@@ -73,7 +75,7 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5
 
       # ── Summary ────────────────────────────────────────────────────────────
       - name: Write job summary

.gitignore

@@ -33,3 +33,5 @@ pnpm-debug.log*
 .claude/settings.local.json
 .claude/todos/
 
+.superpowers/brainstorm/
+.playwright-mcp/

astro.config.mjs

@@ -1,10 +1,44 @@
-// @ts-check
 import { defineConfig } from 'astro/config';
 import sitemap from '@astrojs/sitemap';
 
-// https://astro.build/config
 export default defineConfig({
     site: 'https://intellica.net',
     output: 'static',
-    integrations: [sitemap()],
+    i18n: {
+        locales: ['en', 'tr'],
+        defaultLocale: 'en',
+        routing: {
+            prefixDefaultLocale: false,
+        },
+    },
+    integrations: [
+        sitemap({
+            i18n: {
+                defaultLocale: 'en',
+                locales: {
+                    en: 'en-US',
+                    tr: 'tr-TR',
+                },
+            },
+        }),
+    ],
+    redirects: {
+        '/about-us': '/about',
+        '/our-products': '/products',
+        '/our-services': '/solutions',
+        '/career': '/careers',
+        '/privacy-policy': '/privacy',
+        '/cookie-policy': '/cookies',
+        '/terms-and-conditions': '/terms',
+        '/blog': '/insights',
+        '/business-benefits': '/solutions',
+        '/demo': '/contact',
+        '/tr/about-us': '/tr/about',
+        '/tr/our-products': '/tr/products',
+        '/tr/our-services': '/tr/solutions',
+        '/tr/career': '/tr/careers',
+        '/tr/business-benefits': '/tr/solutions',
+        '/tr/privacy-policy': '/tr/privacy',
+        '/tr/cookie-policy': '/tr/cookies',
+    },
 });

docs/i18n-research-2026.md

@@ -0,0 +1,161 @@
+# Multi-Language Research — Astro 6 + SEO Best Practices 2026
+
+> Date: 2026-04-08
+> Astro Version: 6.1.5 (upgraded from 5.17.1)
+
+## Industry Consensus: Subdirectory Approach
+
+All major sources agree — subdirectory (`/tr/`, `/de/`) is the standard for 85%+ of websites.
+
+| Source | Recommendation |
+|---|---|
+| Google Search Central | Subdirectory for unified authority |
+| Next.js App Router | `[locale]/` dynamic segment |
+| Astro 6 | `src/pages/{locale}/` folder structure |
+| Vercel | Subdirectory for SEO-optimized sites |
+| SEO Industry (2026) | Subdirectory dominates |
+
+### Why Subdirectory Wins
+- Domain authority consolidation (backlinks benefit all languages)
+- Single Google Search Console property
+- Low maintenance (one hosting, one SSL, one deploy)
+- Easy hreflang management
+
+### Google Critical Warnings
+1. **"Avoid automatically redirecting users from one language version to another"** — harmful for both users and crawlers
+2. **"Don't use IP analysis to adapt your content"** — unreliable
+3. Google uses **visible page content** to determine language, not `lang` attribute or URL
+4. Recommend **hyperlinks to other language versions** for user choice
+
+## Astro 6 Native i18n System
+
+### Configuration (`astro.config.mjs`)
+
+```javascript
+export default defineConfig({
+  site: 'https://intellica.net',
+  output: 'static',
+  i18n: {
+    locales: ['en', 'tr'],
+    defaultLocale: 'en',
+    routing: {
+      prefixDefaultLocale: false,  // EN at /, TR at /tr/
+    },
+    fallback: {
+      tr: 'en'  // Missing TR pages fall back to EN
+    }
+  },
+  integrations: [
+    sitemap({
+      i18n: {
+        defaultLocale: 'en',
+        locales: { en: 'en-US', tr: 'tr-TR' },
+      },
+    }),
+  ],
+});
+```
+
+### File Structure
+
+```
+src/pages/
+  index.astro           → intellica.net/
+  about.astro           → intellica.net/about/
+  products.astro        → intellica.net/products/
+  tr/
+    index.astro         → intellica.net/tr/
+    about.astro         → intellica.net/tr/about/
+    products.astro      → intellica.net/tr/products/
+```
+
+### Helper Functions (`astro:i18n`)
+
+```javascript
+import {
+  getRelativeLocaleUrl,    // getRelativeLocaleUrl('tr', 'about') → '/tr/about'
+  getAbsoluteLocaleUrl,    // Full URL with domain
+  getRelativeLocaleUrlList, // All locale variants for a path
+  getLocaleByPath,         // Extract locale from URL path
+} from 'astro:i18n';
+```
+
+### Page-level Locale Access
+
+- `Astro.currentLocale` — Works in static. Returns locale from URL or defaultLocale.
+- `Astro.preferredLocale` — SSR only. NOT available in static builds.
+- `Astro.preferredLocaleList` — SSR only.
+
+### Translation System (Official Recipe)
+
+```typescript
+// src/i18n/ui.ts
+export const ui = {
+  en: { 'nav.home': 'Home', 'nav.about': 'About' },
+  tr: { 'nav.home': 'Ana Sayfa', 'nav.about': 'Hakkımızda' },
+} as const;
+
+// src/i18n/utils.ts
+export function getLangFromUrl(url: URL) { ... }
+export function useTranslations(lang) { ... }
+export function useTranslatedPath(lang) { ... }
+```
+
+### SEO: hreflang Tags
+
+```html
+<link rel="alternate" hreflang="en" href="https://intellica.net/about" />
+<link rel="alternate" hreflang="tr" href="https://intellica.net/tr/about" />
+<link rel="alternate" hreflang="x-default" href="https://intellica.net/about" />
+```
+
+### Sitemap: Automatic hreflang XML
+
+`@astrojs/sitemap` with i18n config auto-generates:
+```xml
+<url>
+  <loc>https://intellica.net/about/</loc>
+  <xhtml:link rel="alternate" hreflang="en-US" href="https://intellica.net/about/"/>
+  <xhtml:link rel="alternate" hreflang="tr-TR" href="https://intellica.net/tr/about/"/>
+</url>
+```
+
+### Astro 6 Breaking Change
+- `redirectToDefaultLocale` default changed from `true` (v5) to `false` (v6)
+- Requires `prefixDefaultLocale: true` to function
+- Not relevant if using `prefixDefaultLocale: false`
+
+## Browser Language Detection — Static Site Limitations
+
+`Astro.preferredLocale` is SSR-only. For static sites, options:
+
+1. **Client-side JS** — Read `navigator.language`, show banner (NOT redirect)
+2. **Language switcher in header** — Always visible toggle
+3. **Combination** — Toggle always present + soft banner for detected language mismatch
+
+Google recommends option 2+3: **always provide a language switcher, optionally suggest based on browser language, never force redirect.**
+
+## Third-Party Libraries — Not Recommended
+
+| Library | Status (2026) |
+|---|---|
+| astro-i18next | Abandoned, Astro 5 incompatible |
+| astro-i18n-aut | Inactive 1+ year |
+| Paraglide JS | SSR only, not for static |
+| **Astro built-in** | **Stable, recommended** |
+
+## Current Site State
+
+- All content hardcoded in .astro files (no content collections)
+- No existing i18n infrastructure
+- Organization schema already declares `availableLanguage: ["English", "Turkish"]`
+- Navigation links hardcoded as arrays in Header/Footer/BottomNav components
+- 34 pages, static output, GitHub Pages deploy
+
+## Key Decisions Needed
+
+1. Default language: EN (preserves current Google index) vs TR (company is Turkish)
+2. Content extraction: How to organize translation strings
+3. Browser detection: Banner vs redirect vs toggle-only
+4. Page duplication: Full duplicate pages vs shared templates with translated content
+5. Redirect strategy: Old `/tr/*` URLs → new `/tr/*` URLs