Skip to content

Commit 3dc7df7

Browse files
authored
growth(home): guide visitors to searchable app catalog and focused guides (#6)
* growth(home): promote real app discovery and guides from featured app section * ops(site): deploy homepage discovery links along with target catalog and guides * ops(site): verify live homepage includes new app-discovery links * test(growth): assert homepage exposes both indexed discovery journeys * ci(site): enforce homepage discovery link coverage * docs(growth): stage and verify homepage search-guide discovery as fifth file
1 parent 56678b5 commit 3dc7df7

6 files changed

Lines changed: 28 additions & 3 deletions

File tree

‎.github/workflows/app-discovery-qa.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ on:
44
branches: [main]
55
paths:
66
- apps.html
7+
- index.html
78
- apps_data.json
89
- guides/**
910
- sitemap.xml
@@ -17,6 +18,7 @@ on:
1718
branches: [main]
1819
paths:
1920
- apps.html
21+
- index.html
2022
- apps_data.json
2123
- guides/**
2224
- sitemap.xml

‎docs/APP_DISCOVERY_GROWTH_RELEASE_2026-10-27.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ bash scripts/publish_app_discovery.sh --apply
1818
bash scripts/check_app_discovery_live.sh
1919
```
2020

21-
Only these files transfer: `apps.html`, `sitemap.xml`, `guides/quick-games/index.html`, `guides/daily-habits/index.html`. Every other VPS file, including privacy, support, policy, payment and ads assets, stays untouched. To override environment use `APP_SITE_DEPLOY_HOST` and `APP_SITE_DEPLOY_ROOT` with a known-safe absolute path. The script refuses unknown flags/invalid targets.
21+
Only these files transfer: `index.html`, `apps.html`, `sitemap.xml`, `guides/quick-games/index.html`, `guides/daily-habits/index.html`. The homepage links are tracked with `discovery_nav_click` and let visitors reach the search or guides without scrolling 92 cards. Every other VPS file, including privacy, support, policy, payment and ads assets, stays untouched. To override environment use `APP_SITE_DEPLOY_HOST` and `APP_SITE_DEPLOY_ROOT` with a known-safe absolute path. The script refuses unknown flags/invalid targets.
2222

23-
**Publish gate:** a dry-run is not publication. Only mark live once `check_app_discovery_live.sh` reports HTTP 200 and matches `id="find-app"`, both guide canonical URLs, guide click event and sitemap entries. After manual publication consider Google Search Console URL inspection and sitemap submission if the `appdevelopsk.com` property is available.
23+
**Publish gate:** a dry-run is not publication. Only mark live once `check_app_discovery_live.sh` reports HTTP 200 and matches the homepage `discovery-links`, `id="find-app"`, both guide canonical URLs, guide click event and sitemap entries. After manual publication consider Google Search Console URL inspection and sitemap submission if the `appdevelopsk.com` property is available.
2424

2525
## Growth experiment — acquisition, not vanity pageviews
2626

‎index.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,8 @@
6060
location: a.closest('footer') ? 'footer' : (a.closest('.hero') ? 'hero' : 'other'),
6161
link_url: href
6262
});
63+
} else if (a.classList.contains('discovery-link')) {
64+
gtag('event', 'discovery_nav_click', { guide: a.getAttribute('data-guide') || 'catalog', origin: 'homepage' });
6365
} else if (a.classList.contains('app-card')) {
6466
gtag('event', 'app_view', { app: href.replace(/^support\//, '').replace(/\/$/, '') });
6567
} else if (/pickly\.blog|toolify365\.com|fxea365\.com/.test(href)) {
@@ -298,6 +300,11 @@
298300
.stats { grid-template-columns: repeat(2, 1fr); }
299301
.hero { padding-top: 100px; }
300302
}
303+
304+
.discovery-links{display:flex;flex-wrap:wrap;justify-content:center;gap:12px;max-width:1100px;margin:10px auto 30px;padding:0 24px}
305+
.discovery-links a{display:inline-flex;align-items:center;gap:6px;border:1px solid rgba(155,169,255,.5);border-radius:999px;padding:10px 16px;color:var(--text-primary);background:rgba(108,123,255,.13);text-decoration:none;font-weight:650;font-size:.91rem}
306+
.discovery-links a:hover,.discovery-links a:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
307+
301308
</style>
302309

303310
<!-- impact.com トラッキングタグ(所有権確認+アフィリ計測: リンク自動変換/インプレッション) -->
@@ -425,6 +432,11 @@ <h3 data-i18n="cat_travel">Travel &amp; Maps</h3>
425432
<h2 data-i18n="featured_title">Featured Apps</h2>
426433
<p data-i18n="featured_desc">A selection of our most popular apps across categories</p>
427434
</div>
435+
<nav class="discovery-links" aria-label="Discover SK Apps by purpose">
436+
<a class="discovery-link" data-guide="catalog" href="/apps">🔎 Find an app</a>
437+
<a class="discovery-link" data-guide="quick-games" href="/guides/quick-games/">🎮 Quick games</a>
438+
<a class="discovery-link" data-guide="daily-habits" href="/guides/daily-habits/">📅 Daily habits</a>
439+
</nav>
428440
<div class="apps-grid">
429441
<a class="app-card" href="support/snaplingo/">
430442
<img class="app-icon" src="icons/snaplingo.png" alt="SnapLingo" loading="lazy">

‎scripts/check_app_discovery_live.sh‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ fetch() {
1313
-o "$tmp/$filename" -w '%{http_code}' "$base$route")
1414
[[ "$code" == 200 ]] || { echo "FAIL HTTP $code $base$route" >&2; exit 1; }
1515
}
16+
fetch '/' 'index.html'
17+
grep -Fq 'class="discovery-links"' "$tmp/index.html" || { echo 'FAIL homepage discovery links are stale' >&2; exit 1; }
18+
grep -Fq 'discovery_nav_click' "$tmp/index.html" || { echo 'FAIL homepage discovery tracking is stale' >&2; exit 1; }
1619
fetch '/apps' 'apps.html'
1720
grep -Fq 'id="find-app"' "$tmp/apps.html" || { echo 'FAIL catalog search is stale' >&2; exit 1; }
1821
grep -Fq 'catalog_store_click' "$tmp/apps.html" || { echo 'FAIL store-click attribution is stale' >&2; exit 1; }

‎scripts/publish_app_discovery.sh‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ root="${APP_SITE_DEPLOY_ROOT:-/var/www/html}"
1515
if [[ ! "$host" =~ ^[a-zA-Z0-9_.@-]+$ || ! "$root" =~ ^/var/www/[a-zA-Z0-9_./-]+$ ]]; then
1616
echo 'Invalid APP_SITE_DEPLOY_HOST or APP_SITE_DEPLOY_ROOT' >&2; exit 2
1717
fi
18-
files=(apps.html sitemap.xml guides/quick-games/index.html guides/daily-habits/index.html)
18+
files=(index.html apps.html sitemap.xml guides/quick-games/index.html guides/daily-habits/index.html)
1919
for file in "${files[@]}"; do
2020
[[ -s "$file" ]] || { echo "Missing source file: $file" >&2; exit 2; }
2121
done

‎tests/catalog-growth.test.mjs‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,3 +69,11 @@ test('guide landing pages link only to listed published applications and are dis
6969
assert.doesNotMatch(page,/aggregateRating|ratingValue|100% free|guaranteed/i);
7070
}
7171
});
72+
73+
test('homepage sends visitors to catalog and both indexable guides without a search gate',()=>{
74+
const home=read('index.html');
75+
assert.match(home,/class="discovery-links"/);
76+
assert.match(home,/href="\/apps"/);
77+
for (const slug of guides) assert.match(home,new RegExp('href="/guides/'+slug+'/"'));
78+
assert.match(home,/discovery_nav_click/);
79+
});

0 commit comments

Comments
 (0)