docs: brand and category seo - one brand string, npm anchors, source-code schema, honest roadmap windows copy

Author: ipfizz

package.json

@@ -1,28 +1,28 @@
 {
   "name": "bunmaska",
   "version": "0.1.0-alpha.7",
-  "description": "Electron minus Chromium, powered by Bun and WebKit. Same APIs, 23MB downloads, zero native builds - native modules are just .ts files.",
+  "description": "Electron minus Chromium, powered by Bun and WebKit: a drop-in Electron replacement and lightweight Electron alternative. Same APIs, no bundled Chromium, 23MB downloads, native modules that are just .ts files.",
   "keywords": [
     "electron",
     "electron-alternative",
     "electron-replacement",
+    "tauri-alternative",
     "bun",
+    "bun-desktop",
     "desktop",
     "desktop-app",
+    "desktop-framework",
     "webkit",
-    "no-chromium",
+    "webview",
     "system-webview",
-    "cross-platform",
-    "gui",
-    "bun-ffi",
-    "ffi",
-    "native-modules",
     "wkwebview",
     "webkitgtk",
-    "electrobun",
-    "tauri-alternative",
-    "browserwindow",
-    "ipc"
+    "no-chromium",
+    "native-modules",
+    "typescript",
+    "macos",
+    "linux",
+    "windows"
   ],
   "license": "MIT",
   "author": "Indrajeet O.",

website/src/components/Footer.astro

@@ -32,7 +32,7 @@ const cols = [
     title: "Project",
     links: [
       { href: GITHUB, label: "Star on GitHub", external: true },
-      { href: NPM, label: "npm", external: true },
+      { href: NPM, label: "bunmaska on npm", external: true },
       { href: "/roadmap", label: "Roadmap" },
       { href: "/docs/changelog", label: "Changelog" },
       { href: "/about", label: "About" },

website/src/components/roadmap/CTA.astro

@@ -1,8 +1,11 @@
 ---
 import { DISPLAY } from "../../styles/constants";
+import { Icon } from "astro-icon/components";
+import { GITHUB, STARS, starsLabel } from "../../site";
+const stars = starsLabel(STARS);
 ---
 
-<section class="section-border reveal py-20 text-center sm:py-24">
+<section class="section-border reveal py-12 text-center sm:py-20 lg:py-24">
   <div class="wrap">
     <h2 class={`mx-auto max-w-[18ch] ${DISPLAY}`} style="letter-spacing:-0.01em;">
       Want to watch it happen?
@@ -11,8 +14,10 @@ import { DISPLAY } from "../../styles/constants";
       It's all in the open. Star it, read the docs, or come argue about the parity matrix.
     </p>
     <div class="mt-8 flex flex-wrap items-center justify-center gap-3">
-      <a href="/docs/introduction" class="btn btn-accent">Read the docs ></a>
-      <a href="https://github.com/ipfizz/bunmaska" target="_blank" rel="noopener noreferrer" class="btn btn-ghost">GitHub</a>
+      <a href="/docs/introduction" class="btn btn-accent w-full sm:w-auto">Read the docs<Icon name="lucide:arrow-right" class="ml-1.5 h-4 w-4" /></a>
+      <a href={GITHUB} target="_blank" rel="noopener noreferrer" class="btn btn-ghost w-full sm:w-auto"
+        ><Icon name="lucide:star" class="mr-1.5 h-4 w-4" />Star on GitHub{stars && <span class="ml-1.5 font-mono text-xs text-text-faint">{stars}</span>}</a
+      >
     </div>
   </div>
 </section>

website/src/components/roadmap/WindowsDetail.astro

@@ -16,7 +16,7 @@ const cards = [
   },
   {
     t: "Still the expensive platform",
-    d: "Windows has no system WebKit, so we ship and maintain the WinCairo engine ourselves - CVE treadmill and all. That's why hosting the WinCairo builds is on the alpha.7 stop: a Windows app has to be able to fetch its engine.",
+    d: "Windows has no system WebKit, so we ship and maintain the WinCairo engine ourselves - CVE treadmill and all. That's why the engine feed exists: a Windows app fetches its signed engine from engines.bunmaska.org, and tracking WPE's stable train there is the alpha.8 stop.",
   },
 ];
 ---
@@ -47,10 +47,11 @@ const cards = [
       }
     </div>
     <p class="mx-auto mt-6 max-w-[64ch] text-center text-sm text-text-faint">
-      Honest status: the backend is built and runs on a Windows CI runner, but a
-      Windows app still needs a WinCairo engine in the store - and we don't host
-      those builds yet. Windows is real in the code; shipping it end-to-end
-      waits on the hosted engine, the same step Linux is waiting on.
+      Honest status: the backend is built and runs on a Windows CI runner, and
+      the hosted WinCairo engine installs from the real feed end-to-end. What is
+      still open is the stable-train build of that engine and ARM64 - both on
+      the roadmap above. Linux is one step behind: its relocatable engine loads
+      from the store but is not hosted yet.
     </p>
   </div>
 </section>

website/src/content/docs/installation.md

@@ -14,6 +14,8 @@ order: 3
 
 ## Install
 
+Published as [bunmaska on npm](https://www.npmjs.com/package/bunmaska); the CLI ships in the same package.
+
 ```sh
 bun add bunmaska
 # or, if you must:

website/src/layouts/Base.astro

@@ -62,18 +62,34 @@ const organization = {
 const softwareApp = {
   "@context": "https://schema.org",
   "@type": "SoftwareApplication",
+  "@id": `${Astro.site?.href}#software`,
   name: "Bunmaska",
+  alternateName: "bunmaska",
   applicationCategory: "DeveloperApplication",
   operatingSystem: "macOS, Linux, Windows",
   description: DEFAULT_DESCRIPTION,
   url: Astro.site?.href,
   softwareVersion: VERSION,
   license: "https://opensource.org/licenses/MIT",
   offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
+  installUrl: NPM,
+  downloadUrl: NPM,
+  softwareHelp: { "@type": "CreativeWork", url: new URL("/docs/introduction", Astro.site).href },
   sameAs: [GITHUB, NPM],
 };
+const sourceCode = {
+  "@context": "https://schema.org",
+  "@type": "SoftwareSourceCode",
+  name: "bunmaska",
+  codeRepository: GITHUB,
+  programmingLanguage: "TypeScript",
+  runtimePlatform: "Bun",
+  license: "https://opensource.org/licenses/MIT",
+  url: NPM,
+  targetProduct: { "@id": `${Astro.site?.href}#software` },
+};
 const extra = jsonLd === undefined ? [] : Array.isArray(jsonLd) ? jsonLd : [jsonLd];
-const graphs = [website, ...(isHome ? [organization, softwareApp] : []), ...extra];
+const graphs = [website, ...(isHome ? [organization, softwareApp, sourceCode] : []), ...extra];
 ---
 
 <!doctype html>
@@ -91,7 +107,7 @@ const graphs = [website, ...(isHome ? [organization, softwareApp] : []), ...extr
     <meta name="description" content={description} />
     <meta name="robots" content={noindex ? "noindex, nofollow" : "index, follow"} />
     <meta name="generator" content={Astro.generator} />
-    <meta property="og:site_name" content="bunmaska" />
+    <meta property="og:site_name" content="Bunmaska" />
     <meta property="og:title" content={fullTitle} />
     <meta property="og:description" content={description} />
     <meta property="og:type" content={ogType} />

website/src/pages/404.astro

@@ -1,4 +1,5 @@
 ---
+import { Icon } from "astro-icon/components";
 import Base from "../layouts/Base.astro";
 import Nav from "../components/Nav.astro";
 import Footer from "../components/Footer.astro";
@@ -17,7 +18,7 @@ import { DISPLAY } from "../styles/constants";
       one won't take the whole app down.
     </p>
     <div class="flex flex-wrap items-center justify-center gap-3">
-      <a href="/" class="btn btn-accent">Back home ></a>
+      <a href="/" class="btn btn-accent"><Icon name="lucide:arrow-left" class="mr-1.5 h-4 w-4" />Back home</a>
       <a href="/docs/introduction" class="btn btn-ghost">Read the docs</a>
     </div>
   </main>

website/src/pages/about.astro

@@ -6,7 +6,7 @@ import { GITHUB, NPM, VERSION } from "../site";
 
 const title = "About Bunmaska";
 const description =
-  "Bunmaska (one word, capital B) is a desktop app framework - a drop-in Electron replacement built on Bun and the system WebKit. What the name means, who makes it, and what it is not.";
+  "Bunmaska (one word, capital B) is a desktop app framework - a drop-in Electron replacement built on Bun and WebKit. What the name means, who makes it, and what it is not.";
 ---
 
 <Base title={title} description={description}>
@@ -66,7 +66,7 @@ const description =
       <p>
         If you quote one sentence about this project, make it this one:
         <em>Bunmaska is a drop-in Electron replacement built on Bun and the
-        system WebKit - no bundled Chromium, and native modules that are just
+        WebKit - no bundled Chromium, and native modules that are just
         TypeScript files.</em>
       </p>
 

website/src/pages/alternatives.astro

@@ -1,10 +1,11 @@
 ---
+import { Icon } from "astro-icon/components";
 import Base from "../layouts/Base.astro";
 import Nav from "../components/Nav.astro";
 import Footer from "../components/Footer.astro";
 import { faq, faqPageJsonLd } from "../faq";
 
-const title = "A lightweight Electron alternative without Chromium";
+const title = "Electron alternatives in 2026: lightweight, without Chromium";
 const description =
   "bunmaska is an Electron alternative built on Bun and system WebKit - no bundled Chromium, no CVE re-ship treadmill, a drop-in API. Honest alpha status inside.";
 ---
@@ -99,7 +100,7 @@ const description =
       }
 
       <p class="mt-10">
-        <a class="btn btn-accent" href="/docs/quickstart">Get started →</a>
+        <a class="btn btn-accent" href="/docs/quickstart">Get started<Icon name="lucide:arrow-right" class="ml-1.5 h-4 w-4" /></a>
       </p>
     </article>
   </main>

website/src/pages/compare/electrobun.astro

@@ -1,4 +1,5 @@
 ---
+import { Icon } from "astro-icon/components";
 import Base from "../../layouts/Base.astro";
 import Nav from "../../components/Nav.astro";
 import Footer from "../../components/Footer.astro";
@@ -53,7 +54,7 @@ const description =
       </p>
 
       <p class="mt-8">
-        <a class="btn btn-accent" href="/docs/introduction">Read the docs →</a>
+        <a class="btn btn-accent" href="/docs/introduction">Read the docs<Icon name="lucide:arrow-right" class="ml-1.5 h-4 w-4" /></a>
         <a class="btn btn-ghost" href="/alternatives">All Electron alternatives</a>
       </p>
     </article>