@lownoise-studio/rendershield 0.1.4

package/DEPLOY.md

@@ -0,0 +1,185 @@
+Deploying RenderShield
+
+This document describes how to deploy prerendered output generated by RenderShield so that crawlers receive complete static HTML while users continue to receive your application.
+
+RenderShield does not run your app.
+It only produces files and optional routing logic.
+
+If RenderShield builds successfully, the output is safe to deploy.
+
+1. Build
+
+From the RenderShield project root:
+
+npm install
+npm run build
+
+This generates prerendered output in:
+
+dist-prerender/
+
+Typical contents:
+
+dist-prerender/
+├─ content/
+│ └─ example/
+│ └─ index.html
+├─ sitemap.xml
+├─ robots.txt
+└─ worker.js
+
+The exact structure depends on your configured routes.
+
+2. Hosting the prerendered output
+
+You must host the contents of dist-prerender/ on a static origin that can serve files directly.
+
+The static origin must be able to serve:
+
+/content/example/index.html
+/sitemap.xml
+/robots.txt
+
+Common options include:
+
+a static hosting bucket
+
+a CDN-backed static site
+
+the same host as your SPA, under a different path or subdomain
+
+RenderShield does not require a specific host.
+
+3. Routing crawlers to prerendered HTML (optional but recommended)
+
+To ensure crawlers receive prerendered HTML while humans receive your app, you must route requests based on user-agent.
+
+RenderShield provides an optional Cloudflare Worker (worker.js) for this purpose.
+
+The worker:
+
+detects crawler user agents
+
+rewrites matching routes to prerendered index.html
+
+forwards human traffic unchanged
+
+Humans keep the SPA.
+Crawlers get static HTML.
+
+4. Deploying the Cloudflare Worker
+
+Create a Cloudflare account (free plan is sufficient).
+
+Deploy worker.js as a Worker.
+
+Attach the Worker to your domain with a route:
+
+yourdomain.com/*
+www.yourdomain.com/
+*
+
+Without a route, the Worker will never run.
+
+Ensure the DNS record for your domain is proxied (orange cloud ON).
+
+5. SSL configuration
+
+In Cloudflare:
+
+Set SSL/TLS mode to:
+
+Full
+or
+Full (Strict)
+
+Do not use “Flexible”.
+
+Incorrect SSL mode can cause redirect loops that prevent crawlers from reaching prerendered content.
+
+6. Sitemap and robots
+
+Upload these files from dist-prerender/ to your static origin:
+
+sitemap.xml
+robots.txt
+
+Then submit your sitemap URL to your search engine consoles as needed.
+
+Example robots.txt:
+
+User-agent: *
+Allow: /
+Sitemap: https://yourdomain.com/sitemap.xml
+
+7. Verification
+
+RenderShield includes a verification command that prints smoke tests.
+
+Run:
+
+node dist/cli.js verify
+
+This prints three checks:
+
+Human request (should return your app shell)
+
+Crawler request (should return prerendered HTML)
+
+Debug headers (confirms worker routing)
+
+If verification passes, deployment is correct.
+
+8. What RenderShield guarantees
+
+RenderShield guarantees only this:
+
+If a page builds successfully, the generated HTML:
+
+contains real content
+
+includes required metadata
+
+is readable by crawlers
+
+RenderShield does not guarantee:
+
+rankings
+
+traffic
+
+indexing speed
+
+AI citations
+
+It guarantees correctness of output.
+
+9. Common failure modes
+
+If crawlers do not see prerendered content:
+
+Worker route is missing or incorrect
+
+DNS proxy is OFF
+
+Static origin is unreachable
+
+SSL mode is misconfigured
+
+Prerendered files are not deployed
+
+RenderShield verification output will point to these issues.
+
+Summary
+
+RenderShield separates responsibilities cleanly:
+
+Your app serves users
+
+RenderShield serves crawlers
+
+The edge decides who gets what
+
+If it builds, it ships.
+
+That is the contract.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lownoise Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,138 @@
+# RenderShield
+
+RenderShield ensures crawlers receive complete, static HTML instead of an empty
+JavaScript shell — without changing how humans experience your app.
+
+It prerenders content ahead of time and can route crawler requests to that output
+at the edge, while normal users continue to receive the SPA.
+
+No frameworks required.  
+No vendor lock-in.  
+No guessing what bots see.
+
+If a page builds, the HTML is complete. If it isn’t, the build fails.
+
+---
+
+## What problem this solves
+
+Many modern apps technically work but are invisible to:
+
+- search engines
+- social preview scrapers
+- AI crawlers
+
+The content exists only after JavaScript executes.
+Crawlers do not wait.
+
+RenderShield fixes this by generating static, bot-readable HTML and refusing
+to ship incomplete output.
+
+---
+
+## What RenderShield does
+
+- Converts structured content into full static HTML pages
+- Injects:
+  - title
+  - meta description
+  - canonical link
+  - Open Graph tags
+  - Twitter tags
+  - JSON-LD (Article)
+- Generates:
+  - index.html per route
+  - sitemap.xml
+  - robots.txt
+  - optional Cloudflare Worker
+- Validates output
+  - missing title, metadata, or content causes the build to fail
+
+If it builds, crawlers will see real content.
+
+---
+
+## What it does not do
+
+- It does not run your application
+- It does not execute JavaScript for bots
+- It does not guess content
+- It does not promise rankings, traffic, or citations
+- It does not replace your SPA
+
+It guarantees one thing only:
+that crawlers receive complete HTML.
+
+---
+
+## Quickstart
+
+1) Install dependencies
+
+Run:
+
+npm install
+
+2) Initialize RenderShield
+
+Run:
+
+npm run build
+
+This creates:
+- rendershield.config.json
+- sample content
+- a prerender output directory
+
+3) Add content
+
+Place structured content under:
+
+content/
+
+4) Build prerendered output
+
+Run:
+
+node dist/cli.js build
+
+Output is written to:
+
+dist-prerender/
+
+5) Verify output
+
+Run:
+
+node dist/cli.js verify
+
+This prints curl commands you can use to confirm crawler behavior.
+
+---
+
+## Deployment
+
+RenderShield is designed to run behind Cloudflare.
+
+A Worker routes crawler requests to prerendered HTML while passing all other
+traffic through unchanged.
+
+See:
+docs/deploy-cloudflare.md
+
+---
+
+## Philosophy
+
+RenderShield is intentionally boring.
+
+It does not attempt to outsmart crawlers or simulate browsers.
+It produces correct HTML and refuses to ship broken output.
+
+If crawlers cannot read it, the build fails.
+
+---
+
+## License
+
+MIT License

package/dist/cli.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { cmdInit } from "./commands/init.js";
+import { cmdBuild } from "./commands/build.js";
+import { cmdVerify } from "./commands/verify.js";
+function printHelp() {
+    console.log(`
+RenderShield (v0) — boring bot-aware prerendering.
+
+Usage:
+  rendershield init
+  rendershield build
+  rendershield verify
+
+Notes:
+  - Config file: rendershield.config.json
+  - Content: content/blog/*.md (frontmatter required)
+  - Output: dist-prerender/
+`);
+}
+async function main() {
+    const cmd = process.argv[2]?.trim();
+    if (!cmd || cmd === "-h" || cmd === "--help") {
+        printHelp();
+        process.exit(0);
+    }
+    try {
+        if (cmd === "init") {
+            await cmdInit();
+            return;
+        }
+        if (cmd === "build") {
+            await cmdBuild();
+            return;
+        }
+        if (cmd === "verify") {
+            await cmdVerify();
+            return;
+        }
+        console.error(`Unknown command: ${cmd}\n`);
+        printHelp();
+        process.exit(1);
+    }
+    catch (err) {
+        const msg = err?.message ? String(err.message) : String(err);
+        console.error(`\nRenderShield error: ${msg}\n`);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAEpC,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC7C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,MAAM,SAAS,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;QAC3C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/commands/build.js

@@ -0,0 +1,58 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { loadConfig } from "../core/loadConfig.js";
+import { loadAllMarkdownDocs } from "../core/loadMarkdown.js";
+import { renderPageHtml } from "../core/renderHtml.js";
+import { generateSitemapXml } from "../core/generateSitemap.js";
+import { generateRobotsTxt } from "../core/generateRobots.js";
+import { generateWorkerJs } from "../core/generateWorker.js";
+import { validatePrerenderHtml } from "../core/validateOutput.js";
+function routeToOutDir(outDirAbs, routePath) {
+    // /blog/slug -> outDir/blog/slug/index.html
+    const clean = routePath.replace(/^\//, "");
+    return path.join(outDirAbs, clean);
+}
+export async function cmdBuild(cwd = process.cwd()) {
+    const cfg = await loadConfig(cwd);
+    const outDirAbs = path.join(cwd, cfg.output.outDir);
+    // Clean output (boring + deterministic)
+    await fs.remove(outDirAbs);
+    await fs.ensureDir(outDirAbs);
+    const docs = await loadAllMarkdownDocs(cfg, cwd);
+    if (docs.length === 0) {
+        throw new Error("No markdown documents found. Check content paths/patterns.");
+    }
+    // Generate pages (validate BEFORE writing)
+    for (const doc of docs) {
+        const pageDir = routeToOutDir(outDirAbs, doc.routePath);
+        await fs.ensureDir(pageDir);
+        const outFile = path.join(pageDir, "index.html");
+        const html = renderPageHtml(cfg, doc);
+        validatePrerenderHtml({
+            html,
+            outFile,
+            routePath: doc.routePath,
+        });
+        await fs.writeFile(outFile, html, "utf8");
+    }
+    // sitemap.xml
+    if (cfg.sitemap.enabled) {
+        const sitemapXml = generateSitemapXml(cfg, docs);
+        const sitemapPath = path.join(outDirAbs, cfg.sitemap.path.replace(/^\//, ""));
+        await fs.writeFile(sitemapPath, sitemapXml, "utf8");
+    }
+    // robots.txt
+    if (cfg.robots.enabled) {
+        const robotsTxt = generateRobotsTxt(cfg);
+        const robotsPath = path.join(outDirAbs, cfg.robots.path.replace(/^\//, ""));
+        await fs.writeFile(robotsPath, robotsTxt, "utf8");
+    }
+    // worker.js
+    if (cfg.worker.enabled) {
+        const workerJs = generateWorkerJs(cfg);
+        await fs.writeFile(path.join(outDirAbs, "worker.js"), workerJs, "utf8");
+    }
+    console.log(`Built ${docs.length} pages into ${cfg.output.outDir}/`);
+    console.log(`Output includes: ${cfg.sitemap.enabled ? "sitemap.xml " : ""}${cfg.robots.enabled ? "robots.txt " : ""}${cfg.worker.enabled ? "worker.js" : ""}`);
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.js

@@ -0,0 +1,102 @@
+import fs from "fs-extra";
+import path from "node:path";
+const CONFIG_NAME = "rendershield.config.json";
+const DEFAULT_CONFIG = {
+    version: 1,
+    site: {
+        canonicalBase: "https://example.com",
+        siteName: "Example Site",
+        defaultOgImage: "https://example.com/og/default.jpg",
+        authorName: "Your Name"
+    },
+    content: {
+        markdown: {
+            baseDir: "content",
+            collections: [
+                {
+                    name: "pages",
+                    pattern: "pages/**/*.md",
+                    routeBase: "/pages",
+                    schemaType: "Article"
+                }
+            ]
+        }
+    },
+    output: {
+        outDir: "dist-prerender",
+        prettyHtml: true
+    },
+    sitemap: {
+        enabled: true,
+        path: "/sitemap.xml"
+    },
+    robots: {
+        enabled: true,
+        path: "/robots.txt"
+    },
+    worker: {
+        enabled: true,
+        lovableOrigin: "https://YOUR_SITE.lovable.app",
+        rewriteRouteBases: ["/pages/"],
+        botUserAgentPatterns: [
+            "googlebot",
+            "bingbot",
+            "gptbot",
+            "claudebot",
+            "perplexitybot",
+            "twitterbot",
+            "facebookexternalhit",
+            "linkedinbot",
+            "slackbot",
+            "discordbot",
+            "whatsapp",
+            "telegram"
+        ],
+        debugHeaders: true
+    }
+};
+const today = new Date().toISOString().slice(0, 10);
+const SAMPLE_POST = `---
+title: Hello World
+excerpt: This is a sample page generated by RenderShield.
+datePublished: ${today}
+coverImage: /images/hello.jpg
+slug: hello-world
+---
+
+This is **RenderShield**.
+
+- Crawlers should see real HTML.
+- Humans keep the SPA.
+
+That's the whole trick.
+`;
+export async function cmdInit(cwd = process.cwd()) {
+    const configPath = path.join(cwd, CONFIG_NAME);
+    const contentDir = path.join(cwd, "content", "pages");
+    const samplePath = path.join(contentDir, "hello-world.md");
+    const configExists = await fs.pathExists(configPath);
+    if (!configExists) {
+        await fs.writeFile(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n", "utf8");
+        console.log(`Created ${CONFIG_NAME}`);
+    }
+    else {
+        console.log(`${CONFIG_NAME} already exists (leaving it alone)`);
+    }
+    await fs.ensureDir(contentDir);
+    const sampleExists = await fs.pathExists(samplePath);
+    if (!sampleExists) {
+        await fs.writeFile(samplePath, SAMPLE_POST, "utf8");
+        console.log(`Created sample content: content/pages/hello-world.md`);
+    }
+    else {
+        console.log(`Sample content already exists (leaving it alone)`);
+    }
+    console.log(`
+Next:
+  1) Edit rendershield.config.json
+  2) Add content under content/pages/
+  3) Run: rendershield build
+`);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/verify.js

@@ -0,0 +1,100 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { loadConfig } from "../core/loadConfig.js";
+function joinUrl(base, routePath) {
+    const b = base.endsWith("/") ? base.slice(0, -1) : base;
+    const p = routePath.startsWith("/") ? routePath : `/${routePath}`;
+    return b + p;
+}
+async function findFirstIndexHtml(outDirAbs) {
+    const stack = [outDirAbs];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = await fs.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            const full = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(full);
+                continue;
+            }
+            if (entry.isFile() && entry.name.toLowerCase() === "index.html") {
+                // Ignore index.html at the output root; prefer a routed page like
+                // <section>/<slug>/index.html (or deeper).
+                const rel = path.relative(outDirAbs, full);
+                const parts = rel.split(path.sep).filter(Boolean);
+                if (parts.length >= 2)
+                    return full;
+            }
+        }
+    }
+    return null;
+}
+function indexHtmlPathToRoute(outDirAbs, indexPathAbs) {
+    const rel = path.relative(outDirAbs, indexPathAbs);
+    // rel: <section>/<slug>/index.html
+    const noFile = rel.replace(/index\.html$/i, "");
+    const normalized = noFile.split(path.sep).join("/").replace(/\/+$/, "");
+    return "/" + normalized.replace(/^\/+/, "");
+}
+export async function cmdVerify(cwd = process.cwd()) {
+    const cfg = await loadConfig(cwd);
+    const outDirAbs = path.join(cwd, cfg.output.outDir);
+    const exists = await fs.pathExists(outDirAbs);
+    if (!exists) {
+        console.log(`
+RenderShield verify
+
+No prerender output directory found: ${cfg.output.outDir}/
+
+Run:
+  node dist/cli.js build
+`);
+        return;
+    }
+    const firstIndex = await findFirstIndexHtml(outDirAbs);
+    if (!firstIndex) {
+        console.log(`
+RenderShield verify
+
+No prerendered pages found inside: ${cfg.output.outDir}/
+
+Run:
+  node dist/cli.js build
+`);
+        return;
+    }
+    const routePath = indexHtmlPathToRoute(outDirAbs, firstIndex);
+    const url = joinUrl(cfg.site.canonicalBase, routePath);
+    console.log(`
+RenderShield verify
+
+Using:
+  canonicalBase: ${cfg.site.canonicalBase}
+  routePath:     ${routePath}
+  output file:   ${path.relative(cwd, firstIndex)}
+
+Smoke tests:
+
+1) Human (usually SPA shell):
+  curl -s ${url} | grep -i "<title>"
+
+2) Bot (should see prerendered, route-specific title):
+  curl -s -H "User-Agent: Googlebot" ${url} | grep -i "<title>"
+
+3) Debug headers (Worker must be routed + proxy ON):
+  curl -I -H "User-Agent: GPTBot" ${url}
+
+Expected headers (if debugHeaders enabled):
+  X-Bot-Detected: true
+  X-Prerender: true
+  X-Final-Path: ${routePath.replace(/\/?$/, "/index.html")}
+`);
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"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"}

package/dist/core/generateRobots.js

@@ -0,0 +1,14 @@
+export function generateRobotsTxt(cfg) {
+    const sitemapUrl = cfg.sitemap.enabled
+        ? `${cfg.site.canonicalBase.replace(/\/$/, "")}${cfg.sitemap.path}`
+        : "";
+    const lines = [
+        "User-agent: *",
+        "Allow: /",
+    ];
+    if (sitemapUrl) {
+        lines.push(`Sitemap: ${sitemapUrl}`);
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=generateRobots.js.map