@rm-industries/create-forge 0.4.0-beta.5 → 1.0.0-rc.1

package/README.md

@@ -54,8 +54,14 @@ To exercise the packed CLI across the complete generator fixture matrix:
 npm run test:generator:e2e
 ```
 
-This generates default, fully specified, scoped-package-name, no-install, and
-conflict fixtures in an OS temporary directory. The default fixture installs,
-type-checks, and builds outside the Forge workspace. The conflict fixture also
-proves that a failed invocation leaves existing files unchanged. Every fixture
-is removed after the run.
+This generates default, fully specified, scoped-package-name, current-directory,
+no-install, and conflict fixtures in an OS temporary directory. The default
+fixture installs and runs the complete generated-project quality pipeline
+outside the Forge workspace. The conflict fixture also proves that a failed
+invocation leaves existing files unchanged. Every fixture is removed after the
+run.
+
+The release compatibility matrix runs the same packed fixtures with the
+generated project's core quality gate on every supported Node line on Ubuntu
+and on macOS. The complete end-to-end job adds the multi-browser and Lighthouse
+checks once on the primary Node runtime.

package/dist/template/.github/dependabot.yml

@@ -12,6 +12,9 @@ updates:
     open-pull-requests-limit: 5
     commit-message:
       prefix: chore
+    labels:
+      - dependencies
+      - github-actions
     groups:
       github-actions:
         patterns:
@@ -30,6 +33,9 @@ updates:
     open-pull-requests-limit: 5
     commit-message:
       prefix: chore
+    labels:
+      - dependencies
+      - npm
     groups:
       production-dependencies:
         dependency-type: production

package/dist/template/.github/workflows/project.yml

@@ -173,8 +173,8 @@ jobs:
         with:
           node-version: '26.x'
 
-      - name: Install Chromium
-        run: npx playwright install --with-deps chromium
+      - name: Install supported browsers
+        run: npx playwright install --with-deps chromium firefox webkit
 
       - name: Run browser and accessibility tests
         run: npm run test:e2e

package/dist/template/.gitignore.template

@@ -259,3 +259,8 @@ $RECYCLE.BIN/
 *.lnk
 
 # End of https://www.toptal.com/developers/gitignore/api/vim,node,astro,linux,macos,windows,visualstudiocode
+
+### Forge test output ###
+.lighthouseci/
+playwright-report/
+test-results/

package/dist/template/.lighthouserc.json

@@ -1,12 +1,9 @@
 {
   "ci": {
     "collect": {
-      "staticDistDir": "./dist",
-      "url": [
-        "http://localhost/",
-        "http://localhost/articles/",
-        "http://localhost/articles/designing-a-calm-starting-point/"
-      ],
+      "startServerCommand": "npm run preview -- --host 127.0.0.1",
+      "startServerReadyPattern": "Local",
+      "startServerReadyTimeout": 30000,
       "numberOfRuns": 3
     },
     "assert": {

package/dist/template/README.md

@@ -69,7 +69,8 @@ the complete Playwright and axe suite, and Lighthouse budgets in that order.
 Each stage is joined with `&&`, so the command stops immediately and returns a
 non-zero status when any stage fails. Browser tests and Lighthouse start from
 their own production build so they remain independently runnable and cannot
-accidentally inspect stale output.
+accidentally inspect stale output. Both use Astro's preview server and derive
+any deployment base path from the configured canonical site URL.
 
 The complete command is intentionally high cost. Use `npm run quality:static`
 for the quickest source-only feedback or `npm run quality:core` for every check
@@ -124,6 +125,21 @@ tested content-model release first. No version is ignored, security updates
 remain enabled, and every update must pass the complete project and security
 workflows before merging.
 
+Dependabot pull requests use `dependencies` plus the readable ecosystem label
+`npm` or `github-actions`. GitHub ignores configured custom labels that do not
+exist, so initialize them once after creating the repository:
+
+```sh
+gh label create dependencies --color 0366d6 --description "Pull requests that update a dependency file" --force
+gh label create npm --color cb3837 --description "Pull requests that update npm dependencies" --force
+gh label create github-actions --color 2088ff --description "Pull requests that update GitHub Actions dependencies" --force
+```
+
+Run these commands from the generated repository while authenticated with the
+GitHub CLI. They are idempotent because `--force` updates an existing label. If
+they are not run, Dependabot still opens update pull requests but omits any
+configured label that is missing.
+
 GitHub chooses the Dependabot run times, distributing update checks across its
 available schedule. Forge derives distinct weekly CodeQL and workflow-validation
 minutes from the generated package name. This keeps generation reproducible
@@ -147,10 +163,12 @@ alternative-text quality.
 
 Lighthouse CI runs three times each against the production home, article
 listing, and article detail pages, then enforces median category scores and
-transfer budgets. The measured baseline, headroom, exclusions, and update rules
-are documented in `docs/performance-budget.md`. Reports are written to the
-generated `.lighthouseci/` directory; CI retains them for seven days even when
-an assertion fails.
+transfer budgets. Its typed runner prefixes those routes with a configured
+project path, so local checks exercise GitHub Pages project sites with the same
+asset URLs used in production. The measured baseline, headroom, exclusions, and
+update rules are documented in `docs/performance-budget.md`. Reports are written
+to the generated `.lighthouseci/` directory; CI retains them for seven days even
+when an assertion fails.
 
 The configured exclusions cover only generated output, dependency directories,
 and tool artifacts. Stylelint's exceptions recognize Tailwind and DaisyUI
@@ -286,6 +304,13 @@ reference in `robots.txt`. Replace `public/favicon.svg` and
 `public/social-card.svg` when establishing a project identity, and update
 `socialImage` in `src/config/site.ts` if the sharing image path changes.
 
+Every HTML page, including `/admin/`, also includes the nonvisual, standard
+`generator` metadata value `Forge by RM Industries`. It makes Forge-generated
+sites identifiable in page source without adding telemetry, network requests,
+client-side JavaScript, accessibility-tree content, or visible branding. This
+generated project is owned source: remove or change the element in
+`src/components/seo/SeoHead.astro` if you do not want to retain the attribution.
+
 ## Content manager
 
 Run the development server and open `/admin/` to use Sveltia CMS. Sveltia

package/dist/template/docs/performance-budget.md

@@ -3,7 +3,10 @@
 Lighthouse CI protects the generated site's public-page baseline. Run
 `npm run lighthouse:ci` after changes that can affect rendering, assets,
 metadata, or client behavior. The command builds the production site, collects
-three reports per route, and evaluates the median result.
+three reports per route from Astro's preview server, and evaluates the median
+result. The typed runner derives Astro's optional deployment base from
+`src/config/site.ts`, ensuring project-path assets and routes are measured at
+their production-relative locations.
 
 ## Enforced routes
 

package/dist/template/package-lock.json

@@ -12,7 +12,7 @@
         "@astrojs/sitemap": "^3.7.3",
         "@fontsource/fira-code": "^5.3.0",
         "@fontsource/fira-sans": "^5.3.0",
-        "@rm-industries/content-model": "0.2.0-alpha.0",
+        "@rm-industries/content-model": "1.0.0-rc.1",
         "@sveltia/cms": "0.203.2",
         "astro": "^7.2.9"
       },
@@ -5389,9 +5389,9 @@
       }
     },
     "node_modules/@rm-industries/content-model": {
-      "version": "0.2.0-alpha.0",
-      "resolved": "https://registry.npmjs.org/@rm-industries/content-model/-/content-model-0.2.0-alpha.0.tgz",
-      "integrity": "sha512-DC5MkcUQ4iYIO40mFwNzlawkDEy2eleba8Ui48Xg9g5B6YWzEao6Mqu8FvEa923iVw127t1ZskhZEEh1+47njA==",
+      "version": "1.0.0-rc.1",
+      "resolved": "https://registry.npmjs.org/@rm-industries/content-model/-/content-model-1.0.0-rc.1.tgz",
+      "integrity": "sha512-AqsJ8X0WLjR2VXEpl45Thbfl54w4PzVAUqf2WXexpppOVEELl0VvgCVgkyIUbHpmlxb2ZbClNifY8qJoMbw4kw==",
       "license": "MIT",
       "engines": {
         "node": "^22.22.2 || ^24.0.0 || ^26.0.0",
@@ -9235,9 +9235,9 @@
       }
     },
     "node_modules/fast-uri": {
-      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
-      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
+      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
       "dev": true,
       "funding": [
         {

package/dist/template/package.json

@@ -21,7 +21,8 @@
     "lint:css:fix": "stylelint --fix \"**/*.css\" --ignore-path .gitignore",
     "lint:markdown": "markdownlint \"**/*.md\" --ignore-path .gitignore",
     "lint:markdown:fix": "markdownlint --fix \"**/*.md\" --ignore-path .gitignore",
-    "lighthouse:ci": "npm run build && lhci autorun",
+    "lighthouse:autorun": "lhci autorun",
+    "lighthouse:ci": "npm run build && node scripts/run-lighthouse.ts",
     "spellcheck": "cspell \"**\"",
     "typecheck": "astro sync && tsc --noEmit",
     "test": "npm run test:unit",
@@ -39,7 +40,7 @@
     "@astrojs/sitemap": "^3.7.3",
     "@fontsource/fira-code": "^5.3.0",
     "@fontsource/fira-sans": "^5.3.0",
-    "@rm-industries/content-model": "0.2.0-alpha.0",
+    "@rm-industries/content-model": "1.0.0-rc.1",
     "@sveltia/cms": "0.203.2",
     "astro": "^7.2.9"
   },

package/dist/template/playwright.config.ts

@@ -19,6 +19,14 @@ export default defineConfig({
       name: 'chromium',
       use: { ...devices['Desktop Chrome'] },
     },
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
   ],
   webServer: {
     command: 'npm run build && npm run preview -- --host 127.0.0.1',

package/dist/template/scripts/run-lighthouse.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+
+import { getLighthouseUrls } from './run-lighthouse';
+
+describe('getLighthouseUrls', () => {
+  it('audits root deployments from the preview origin', () => {
+    expect(getLighthouseUrls('https://example.com')).toEqual([
+      'http://127.0.0.1:4321/',
+      'http://127.0.0.1:4321/articles/',
+      'http://127.0.0.1:4321/articles/designing-a-calm-starting-point/',
+    ]);
+  });
+
+  it('audits project deployments below their configured base path', () => {
+    expect(getLighthouseUrls('https://example.github.io/example-project')).toEqual([
+      'http://127.0.0.1:4321/example-project/',
+      'http://127.0.0.1:4321/example-project/articles/',
+      'http://127.0.0.1:4321/example-project/articles/designing-a-calm-starting-point/',
+    ]);
+  });
+});

package/dist/template/scripts/run-lighthouse.ts

@@ -0,0 +1,30 @@
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+import { getDeploymentConfig } from '../src/config/deployment.ts';
+import { site } from '../src/config/site.ts';
+import { resolveSiteHref } from '../src/lib/paths.ts';
+
+const previewOrigin = 'http://127.0.0.1:4321';
+const auditedPaths = ['/', '/articles/', '/articles/designing-a-calm-starting-point/'] as const;
+
+export const getLighthouseUrls = (siteUrl: string, origin = previewOrigin): string[] => {
+  const deployment = getDeploymentConfig(siteUrl);
+
+  return auditedPaths.map((path) => new URL(resolveSiteHref(path, deployment.base ?? '/'), origin).href);
+};
+
+export const runLighthouse = (): void => {
+  const lighthouseCli = createRequire(import.meta.url).resolve('@lhci/cli/src/cli.js');
+  const urlArguments = getLighthouseUrls(site.url).map((url) => `--collect.url=${url}`);
+  const result = spawnSync(process.execPath, [lighthouseCli, 'autorun', ...urlArguments], {
+    env: { ...process.env, ASTRO_PREVIEW_BACKGROUND: '0' },
+    stdio: 'inherit',
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0) process.exitCode = result.status ?? 1;
+};
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) runLighthouse();

package/dist/template/src/components/seo/SeoHead.astro

@@ -28,6 +28,7 @@ const socialImageUrl = new URL(resolveSiteHref(site.socialImage), new URL(site.u
 ---
 
 <title>{pageTitle}</title>
+<meta name="generator" content="Forge by RM Industries" />
 <meta name="description" content={description} />
 <link rel="canonical" href={canonicalUrl} />
 <link rel="sitemap" href={resolveSiteHref('/sitemap-index.xml')} />

package/dist/template/tests/accessibility.spec.ts

@@ -49,9 +49,9 @@ test('identifies the current primary navigation item', async ({ page }) => {
   await expect(page.getByRole('link', { name: 'Home' })).toHaveAttribute('aria-current', 'page');
 });
 
-test('moves keyboard users directly to the main content', async ({ page }) => {
+test('moves keyboard users directly to the main content', async ({ browserName, page }) => {
   await page.goto(resolvePreviewPath('/'));
-  await page.keyboard.press('Tab');
+  await page.keyboard.press(browserName === 'webkit' && process.platform === 'darwin' ? 'Alt+Tab' : 'Tab');
 
   const skipLink = page.getByRole('link', { name: 'Skip to content' });
   await expect(skipLink).toBeFocused();

package/dist/template/tests/routes.spec.ts

@@ -11,6 +11,7 @@ test('serves every baseline page with configured canonical and social metadata',
 
     const canonicalUrl = new URL(resolvePreviewPath(route), site.url).href;
 
+    await expect(page.locator('meta[name="generator"]')).toHaveAttribute('content', 'Forge by RM Industries');
     await expect(page.locator('link[rel="canonical"]')).toHaveAttribute('href', canonicalUrl);
     await expect(page.locator('meta[property="og:site_name"]')).toHaveAttribute('content', site.name);
     await expect(page.locator('meta[property="og:url"]')).toHaveAttribute('content', canonicalUrl);

package/dist/template/tests/theme.spec.ts

@@ -33,14 +33,14 @@ test('makes every Catppuccin flavor available explicitly', async ({ page }) => {
   }
 });
 
-test('serves fonts locally and presents a visible keyboard focus indicator', async ({ page }) => {
+test('serves fonts locally and presents a visible keyboard focus indicator', async ({ browserName, page }) => {
   const fontRequests: string[] = [];
   page.on('request', (request) => {
     if (request.resourceType() === 'font') fontRequests.push(request.url());
   });
 
   await page.goto(resolvePreviewPath('/'));
-  await page.keyboard.press('Tab');
+  await page.keyboard.press(browserName === 'webkit' && process.platform === 'darwin' ? 'Alt+Tab' : 'Tab');
 
   await expect(page.locator('a').first()).toBeFocused();
   await expect(page.locator('a').first()).not.toHaveCSS('outline-style', 'none');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rm-industries/create-forge",
-  "version": "0.4.0-beta.5",
+  "version": "1.0.0-rc.1",
   "description": "Create a content-driven Forge website",
   "keywords": [
     "astro",
@@ -33,6 +33,7 @@
     "build": "tsdown && node scripts/copy-template.ts",
     "prepack": "npm run typecheck && npm test && npm run build",
     "test": "vitest run",
+    "test:compatibility": "npm run build && node scripts/test-generator-e2e.ts --compatibility",
     "test:e2e": "npm run build && node scripts/test-generator-e2e.ts",
     "typecheck": "tsc --project tsconfig.json --noEmit",
     "verify:package": "npm run build && node scripts/verify-package.ts"