Trust SSOT for releases, marketing fixes, and OG previews.

Show installer SHA from GitHub digest; XAMPP hero; Laragon comparison; SmartScreen FAQ link; star button; restore per-page og images.

Author: ProgrammerNomad

LAUNCH-MEDIA.md

@@ -1,12 +1,24 @@
-# Reviewed launch media - 18 October 2026
+# Reviewed launch media
 
-Fresh, unaltered captures from the installed internal v0.1.15 build:
+## Required retake (v0.1.12 public build)
 
-- `public/screenshots/app/services-preview.jpg`: Apache running, MySQL 8.4.11 stopped, PHP 8.3.31 ready.
-- `public/screenshots/app/projects-preview.jpg`: filtered a.test project, PHP 8.5, trusted HTTPS; personal folders excluded by filtering.
-- `public/screenshots/app/project-details-preview.jpg`: actual HTTP 200, trusted HTTPS and document-root settings.
-- `public/screenshots/app/project-php-preview.jpg`: installed PHP selection in project details.
+Replace these four homepage assets on **installed public v0.1.12** (sidebar About must show v0.1.12, not internal build numbers):
 
-The features shown are included in public v0.1.12, released on 18 October 2026. Screenshots retain the original internal v0.1.15 build label; this is capture provenance, not an unreleased-feature notice. No version labels, health results, or status badges were edited into captures.
+| File | Scene |
+|------|--------|
+| `public/screenshots/app/services-preview.jpg` | Services dashboard |
+| `public/screenshots/app/projects-preview.jpg` | Projects list with **my-shop.test** |
+| `public/screenshots/app/project-details-preview.jpg` | Project details: HTTP/HTTPS health, document root |
+| `public/screenshots/app/project-php-preview.jpg` | Per-site PHP dropdown |
 
-Old GIFs remain held outside public because of private paths, outdated versions, or obscuring overlays. Automatic GIF discovery remains disabled. No video or founder photo is fabricated. The older approved PHP-download capture remains available in the screenshot gallery.
+**Sample project:** folder `D:\work\my-shop`, hostname `my-shop.test` (outside `www`; do not use `www/a` or `a.test`).
+
+Do not edit version labels, health badges, or status into captures. Exclude private paths from frame.
+
+## Open Graph (social preview)
+
+Static images live under `public/og/` and are wired per page via `ogImage` in `buildPageMetadata`.
+
+## Gallery
+
+Additional PNGs under `public/screenshots/app/` are listed by `listGalleryImages()` for the homepage gallery.

app/download/page.tsx

@@ -20,6 +20,7 @@ export const metadata: Metadata = buildPageMetadata({
   title: "Download",
   description:
     "Download DevStackBox for Windows - free XAMPP alternative with PHP 8.3, MySQL 8.4 LTS, and PHP 8.5 on demand.",
+  ogImage: "/og/download.png",
 });
 
 export default async function DownloadPage() {
@@ -32,7 +33,11 @@ export default async function DownloadPage() {
       <section className="grid gap-10 rounded-3xl border border-border bg-gradient-to-br from-primary/10 via-card to-card p-6 sm:p-10 lg:grid-cols-[1.1fr_0.9fr] lg:items-center">
         <div>
           <p className="text-sm font-semibold uppercase tracking-[0.14em] text-primary">DevStackBox for Windows</p>
-          <p className="mt-3 text-sm text-muted-foreground">v0.1.12 adds project workspaces, per-site PHP, and trusted local HTTPS. The button below installs the latest release from GitHub.</p>
+          <p className="mt-3 text-sm text-muted-foreground">
+            {release
+              ? `${release.tag_name} is the latest stable release from GitHub.`
+              : "The button below installs the latest release from GitHub."}
+          </p>
           <h1 className="mt-3 text-4xl font-bold tracking-tight sm:text-5xl">Download the local PHP stack.</h1>
           <p className="mt-4 max-w-xl text-lg leading-relaxed text-muted-foreground">
             Install Apache, PHP, MySQL, and phpMyAdmin in one desktop application. Your projects and settings stay on your PC.
@@ -89,7 +94,11 @@ export default async function DownloadPage() {
           <StackIncludedPanel />
         </div>
         <p className="mt-6 text-sm text-muted-foreground">
-          The installer is not Windows Authenticode-signed, so SmartScreen may show an unknown publisher. Verify the file and its source before running it. See our{" "}
+          The installer is not Windows Authenticode-signed, so SmartScreen may show an unknown publisher. Verify the file and its source before running it. See{" "}
+          <Link href="/docs/faq#why-does-windows-smartscreen-warn-about-the-installer" className="link-primary">
+            SmartScreen FAQ
+          </Link>{" "}
+          and our{" "}
           <Link href="/security" className="link-primary">
             security page
           </Link>

app/layout.tsx

@@ -6,6 +6,7 @@ import { SiteFooter } from "@/components/site-footer";
 import { SiteHeader } from "@/components/site-header";
 import { siteConfig } from "@/content/homepage";
 import { buildPageMetadata } from "@/lib/page-metadata";
+import { getLatestRelease } from "@/lib/github";
 import { websiteSchemas } from "@/lib/structured-data";
 import "./globals.css";
 import { Geist } from "next/font/google";
@@ -26,15 +27,17 @@ export const metadata: Metadata = {
   metadataBase: new URL(siteConfig.url),
 };
 
-export default function RootLayout({
+export default async function RootLayout({
   children,
 }: Readonly<{
   children: React.ReactNode;
 }>) {
+  const release = await getLatestRelease();
+  const softwareVersion = release?.tag_name?.replace(/^v/i, "");
   return (
     <html lang="en" suppressHydrationWarning className={cn("font-sans", geist.variable)}>
       <body className="flex min-h-screen flex-col bg-background font-sans text-foreground antialiased">
-        <JsonLd data={websiteSchemas()} />
+        <JsonLd data={websiteSchemas({ softwareVersion })} />
         <Analytics />
         <RootProvider>
           <a href="#main-content" className="skip-link">Skip to content</a>

app/migrate-from-xampp/page.tsx

@@ -1,6 +1,6 @@
 import Link from "next/link";
 import { buildPageMetadata } from "@/lib/page-metadata";
-export const metadata = buildPageMetadata({path:"/migrate-from-xampp",title:"Migrate from XAMPP",description:"Move projects from XAMPP to DevStackBox on Windows. Copy htdocs with the in-app importer, then export and import databases separately."});
+export const metadata = buildPageMetadata({path:"/migrate-from-xampp",title:"Migrate from XAMPP",description:"Move projects from XAMPP to DevStackBox on Windows. Copy htdocs with the in-app importer, then export and import databases separately.",ogImage:"/og/migrate-from-xampp.png"});
 const steps = [
 ["Back up your current projects", "Copy your XAMPP htdocs folder to a separate backup. Export each database as SQL from XAMPP phpMyAdmin while its database service is running. Keep the originals until you have tested everything."],
 ["Install DevStackBox", "Install the Windows app. Stop XAMPP Apache and its database service before starting the equivalent DevStackBox services, so ports 80 and 3306 are available."],

app/opengraph-image.tsx

@@ -5,7 +5,7 @@ export const contentType = "image/png";
 export default function Image() {
   return new ImageResponse(<div style={{display:"flex",flexDirection:"column",justifyContent:"space-between",width:"100%",height:"100%",background:"#111b26",color:"#ffffff",padding:"64px"}}>
     <div style={{display:"flex",fontSize:32,color:"#8cafff"}}>DevStackBox / Free & open source</div>
-    <div style={{display:"flex",flexDirection:"column",fontSize:76,fontWeight:700,letterSpacing:-3,lineHeight:1.1}}><span>Your PHP stack.</span><span style={{color:"#8cafff"}}>At home on Windows.</span></div>
+    <div style={{display:"flex",flexDirection:"column",fontSize:58,fontWeight:700,letterSpacing:-2,lineHeight:1.12}}><span>The free XAMPP alternative</span><span style={{color:"#8cafff"}}>for Windows.</span></div>
     <div style={{display:"flex",fontSize:26,color:"#c6d2e3"}}>Apache · PHP · MySQL · phpMyAdmin</div>
   </div>, size);
 }

app/page.tsx

@@ -6,10 +6,11 @@ import { DocsPreview } from "@/components/home/docs-preview";
 import { FeatureShowcase } from "@/components/home/feature-showcase";
 import { HeroSection } from "@/components/home/hero-section";
 import { ComparisonTable } from "@/components/home/comparison-table";
+import { LatestReleaseBand } from "@/components/home/latest-release-band";
 import { StackVersionsSection } from "@/components/home/stack-versions-section";
 import { getLatestRelease, getRepoStats } from "@/lib/github";
 export const revalidate = 300;
 export default async function HomePage() {
   const [release, stats] = await Promise.all([getLatestRelease(), getRepoStats()]);
-  return <><HeroSection release={release} /><StackVersionsSection /><section className="mx-auto max-w-6xl px-5 py-12 sm:px-6"><div className="rounded-3xl border border-border bg-muted/30 p-6 sm:p-10"><p className="text-sm font-semibold text-primary">New in v0.1.12</p><h2 className="mt-3 text-3xl font-bold tracking-tight">Each project, with its own PHP and HTTPS.</h2><p className="mt-4 max-w-3xl leading-7 text-muted-foreground">Connect an existing folder, give it a .test hostname, and manage its document root, installed PHP runtime, and trusted local certificate from one details page.</p><div className="mt-7 grid gap-6 md:grid-cols-3"><div><h3 className="font-semibold">Keep existing projects</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">Use folders outside www. Connecting a site keeps your files in place.</p></div><div><h3 className="font-semibold">Choose installed PHP</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">Download in PHP Versions, then pin a version per website or inherit the default.</p></div><div><h3 className="font-semibold">Check HTTPS and site health</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">Local certificates use mkcert. Windows trust approval is required; website errors are checked separately.</p></div></div><Link href="/docs/getting-started/projects" className="mt-7 inline-flex min-h-11 items-center font-semibold text-primary underline underline-offset-4">Explore the project workflow</Link></div></section><FeatureShowcase /><ScreenshotGallery /><DocsPreview /><ComparisonTable /><CommunityCta stats={stats} /><BottomDownloadCta /></>;
+  return <><HeroSection release={release} stats={stats} /><StackVersionsSection /><LatestReleaseBand release={release} /><FeatureShowcase /><ScreenshotGallery /><DocsPreview /><ComparisonTable /><CommunityCta stats={stats} /><BottomDownloadCta /></>;
 }

app/releases/page.tsx

@@ -1,6 +1,7 @@
 import type { Metadata } from "next";
 import Link from "next/link";
 import { ReleaseBody } from "@/components/release-body";
+import { ReleaseChecksum } from "@/components/release-checksum";
 import {
   findWindowsInstaller,
   formatReleaseDate,
@@ -45,7 +46,22 @@ export default async function ReleasesPage() {
                 </time>
               </div>
               <p className="mt-1 text-sm text-muted-foreground">{r.tag_name} · {r.prerelease ? "Pre-release" : "Stable"}</p>
-              {r.body ? <details className="mt-5"><summary className="py-2 text-sm font-medium text-primary">Read release notes</summary><ReleaseBody body={r.body} className="mt-3" /></details> : null}
+              {installer ? (
+                <ReleaseChecksum
+                  release={r}
+                  className="mt-5 rounded-xl border border-border bg-muted/20 p-4"
+                />
+              ) : null}
+              {r.body ? (
+                <details className="mt-5">
+                  <summary className="py-2 text-sm font-medium text-primary">Read release notes</summary>
+                  <ReleaseBody
+                    body={r.body}
+                    className="mt-3"
+                    omitInstallerSha={Boolean(installer)}
+                  />
+                </details>
+              ) : null}
               <div className="mt-5 flex flex-wrap gap-4 text-sm">
                 <a
                   href={r.html_url}

app/vs/herd/page.tsx

@@ -1,6 +1,6 @@
 import { ComparisonPage } from "@/components/marketing/comparison-page";
 import { buildPageMetadata } from "@/lib/page-metadata";
-export const metadata = buildPageMetadata({path:"/vs/herd",title:"DevStackBox vs Herd",description:"Compare DevStackBox's Apache and MySQL Windows stack with Herd's free PHP environment and optional Pro features."});
+export const metadata = buildPageMetadata({path:"/vs/herd",title:"DevStackBox vs Herd",description:"Compare DevStackBox's Apache and MySQL Windows stack with Herd's free PHP environment and optional Pro features.",ogImage:"/og/vs-herd.png"});
 export default function Page() { return <ComparisonPage title="DevStackBox vs Herd" competitor="Herd" intro="Herd has a free PHP development environment and optional paid Pro capabilities. DevStackBox bundles an Apache and MySQL stack in a free, MIT-licensed Windows app." rows={[
 ["Price","Free (MIT)","Free basic edition; optional paid Pro"], ["Platform","Windows 10/11 x64","Windows and macOS"], ["Web server","Apache","nginx"], ["Database workflow","MySQL 8.4 LTS and phpMyAdmin included","Managed database services in Pro"], ["Focus","Local PHP projects, Apache configuration, and XAMPP migration","Laravel and PHP development with integrated tooling"],
 ]} tradeoff="DevStackBox is a natural fit if you want Apache, bundled MySQL, and familiar phpMyAdmin workflows on Windows. Herd is worth considering for its Laravel-focused environment, nginx, and integrated developer tooling. Its basic edition is free; compare the particular Pro features you need." source="https://herd.laravel.com/windows" sourceLabel="Official Herd for Windows" />; }

app/vs/laragon/page.tsx

@@ -1,7 +1,7 @@
 import { ComparisonPage } from "@/components/marketing/comparison-page";
 import { buildPageMetadata } from "@/lib/page-metadata";
 import { laragonPrice } from "@/content/comparisons";
-export const metadata = buildPageMetadata({path:"/vs/laragon",title:"DevStackBox vs Laragon",description:"Compare two Windows development environments: DevStackBox's MIT-licensed PHP stack and Laragon's non-commercial and commercial licensing."});
+export const metadata = buildPageMetadata({path:"/vs/laragon",title:"DevStackBox vs Laragon",description:"Compare two Windows development environments: DevStackBox's MIT-licensed PHP stack and Laragon's non-commercial and commercial licensing.",ogImage:"/og/vs-laragon.png"});
 export default function Page() { return <ComparisonPage title="DevStackBox vs Laragon" competitor="Laragon" intro="Two ways to build locally on Windows. DevStackBox focuses on an open-source PHP stack; Laragon offers a broader environment for multiple languages and services." rows={[
 ["Price", "Free (MIT)", laragonPrice], ["Local sites","Unlimited","Unlimited"], ["Platform","Windows 10/11 x64","Windows"], ["Stack","Apache, PHP, MySQL 8.4 LTS, phpMyAdmin","Configurable services and multiple runtimes"], ["PHP versions","PHP 8.3 bundled; additional branches in the app","Multiple versions supported"],
 ]} tradeoff="Choose DevStackBox for an MIT-licensed Apache and MySQL workflow with no commercial license purchase. Consider Laragon if its broader runtime support, portability, and established workflows suit your projects. Check the licensing terms for your use." source="https://laragon.org/pricing" sourceLabel="Official Laragon pricing" />; }

app/whats-new/page.tsx

@@ -1,4 +1,5 @@
 import { ReleaseBody } from "@/components/release-body";
+import { ReleaseChecksum } from "@/components/release-checksum";
 import type { Metadata } from "next";
 import Link from "next/link";
 import { Download, ExternalLink } from "lucide-react";
@@ -53,7 +54,20 @@ export default async function WhatsNewPage() {
         </div>
       </header>
 
-      <section className="mt-10"><h2 className="mb-5 text-2xl font-semibold">Release highlights</h2>{release.body ? <ReleaseBody body={release.body} /> : <p className="text-muted-foreground">Read the full release on GitHub for details.</p>}</section>
+      <section className="mt-10">
+        <h2 className="mb-5 text-2xl font-semibold">Release highlights</h2>
+        {installer ? (
+          <ReleaseChecksum
+            release={release}
+            className="mb-6 rounded-xl border border-border bg-muted/30 p-4"
+          />
+        ) : null}
+        {release.body ? (
+          <ReleaseBody body={release.body} omitInstallerSha={Boolean(installer)} />
+        ) : (
+          <p className="text-muted-foreground">Read the full release on GitHub for details.</p>
+        )}
+      </section>
 
       <nav aria-label="Release links" className="mt-12 flex flex-wrap gap-4 border-t border-border pt-8 text-sm">
         <Link href="/changelog" className="text-primary hover:underline">