@rm-industries/create-forge 0.3.0-alpha.0

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

@@ -0,0 +1,47 @@
+import AxeBuilder from '@axe-core/playwright';
+import { expect, test } from '@playwright/test';
+
+test('has no serious or critical accessibility violations', async ({ page }) => {
+  await page.goto('/');
+
+  const results = await new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']).analyze();
+  const violations = results.violations.filter(({ impact }) => impact === 'serious' || impact === 'critical');
+
+  expect(violations).toEqual([]);
+});
+
+test('exposes landmarks and identifies the current navigation item', async ({ page }) => {
+  await page.goto('/');
+
+  await expect(page.getByRole('banner')).toBeVisible();
+  await expect(page.getByRole('navigation', { name: 'Primary navigation' })).toBeVisible();
+  await expect(page.getByRole('link', { name: 'Home' })).toHaveAttribute('aria-current', 'page');
+  await expect(page.getByRole('main')).toBeVisible();
+  await expect(page.getByRole('contentinfo')).toBeVisible();
+});
+
+test('moves keyboard users directly to the main content', async ({ page }) => {
+  await page.goto('/');
+  await page.keyboard.press('Tab');
+
+  const skipLink = page.getByRole('link', { name: 'Skip to content' });
+  await expect(skipLink).toBeFocused();
+  await expect(skipLink).toBeVisible();
+
+  await page.keyboard.press('Enter');
+  await expect(page).toHaveURL(/#main-content$/u);
+  await expect(page.getByRole('main')).toBeFocused();
+});
+
+test('keeps navigation available without horizontal overflow on small screens', async ({ page }) => {
+  await page.setViewportSize({ width: 320, height: 640 });
+  await page.goto('/');
+
+  await page.locator('summary').click();
+  await expect(page.getByRole('navigation', { name: 'Mobile navigation' })).toBeVisible();
+  const hasHorizontalOverflow = await page.evaluate(
+    () => document.documentElement.scrollWidth > document.documentElement.clientWidth,
+  );
+
+  expect(hasHorizontalOverflow).toBe(false);
+});

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

@@ -0,0 +1,87 @@
+import { expect, test } from '@playwright/test';
+
+const routes = ['/', '/about/', '/articles/', '/articles/designing-a-calm-starting-point/', '/admin/', '/404/'];
+
+test('serves every baseline page with configured canonical and social metadata', async ({ page }) => {
+  for (const route of routes) {
+    await page.goto(route);
+
+    await expect(page.locator('link[rel="canonical"]')).toHaveAttribute(
+      'href',
+      new URL(route, 'https://example.com').href,
+    );
+    await expect(page.locator('meta[property="og:site_name"]')).toHaveAttribute('content', 'Forge');
+    await expect(page.locator('meta[property="og:url"]')).toHaveAttribute(
+      'content',
+      new URL(route, 'https://example.com').href,
+    );
+    await expect(page.locator('meta[name="twitter:card"]')).toHaveAttribute('content', 'summary_large_image');
+  }
+});
+
+test('serves the content manager without allowing search indexing', async ({ page }) => {
+  await page.goto('/admin/');
+
+  await expect(page.locator('meta[name="robots"][content="noindex, nofollow"]')).toHaveCount(1);
+  await expect(page).toHaveTitle(/Content Manager/u);
+});
+
+test('renders generic article tags on listings and detail pages', async ({ page }) => {
+  await page.goto('/articles/');
+  await expect(
+    page.locator('a[href="/articles/designing-a-calm-starting-point/"]').getByLabel('Article tags'),
+  ).toContainText('Design');
+
+  await page.goto('/articles/designing-a-calm-starting-point/');
+  await expect(page.getByLabel('Article tags')).toContainText('Defaults');
+});
+
+test('resolves every internal page link', async ({ page, request }) => {
+  await page.goto('/');
+
+  const pending = ['/'];
+  const visited = new Set<string>();
+
+  while (pending.length > 0) {
+    const path = pending.shift();
+    if (!path || visited.has(path)) continue;
+
+    visited.add(path);
+    await page.goto(path);
+
+    const links = await page
+      .locator('a[href]')
+      .evaluateAll((elements) => elements.map((element) => (element as HTMLAnchorElement).href));
+
+    for (const href of links) {
+      const url = new URL(href);
+      if (url.origin !== 'http://127.0.0.1:4321') continue;
+
+      const linkedPath = url.pathname;
+      const response = await request.get(linkedPath);
+      expect(response.status(), `${path} links to ${linkedPath}`).toBeLessThan(400);
+
+      if (!visited.has(linkedPath)) pending.push(linkedPath);
+    }
+  }
+});
+
+test('serves feed, crawler, manifest, and not-found metadata', async ({ request }) => {
+  const feed = await request.get('/rss.xml');
+  expect(feed.ok()).toBe(true);
+  expect(await feed.text()).toContain('https://example.com/articles/designing-a-calm-starting-point/');
+  expect(await feed.text()).not.toContain('future-draft');
+
+  const robots = await request.get('/robots.txt');
+  expect(robots.ok()).toBe(true);
+  expect(await robots.text()).toContain('Sitemap: https://example.com/sitemap-index.xml');
+
+  const manifest = await request.get('/site.webmanifest');
+  expect(manifest.ok()).toBe(true);
+  expect(manifest.headers()['content-type']).toMatch(/application\/manifest\+json/u);
+  expect(await manifest.json()).toMatchObject({ name: 'Forge', start_url: '/' });
+
+  const missing = await request.get('/does-not-exist/');
+  expect(missing.status()).toBe(404);
+  expect(await missing.text()).toContain('That page is not here.');
+});

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

@@ -0,0 +1,47 @@
+import { flavors } from '@catppuccin/palette';
+import { expect, test } from '@playwright/test';
+import type { Page } from '@playwright/test';
+
+const toRgb = (hex: string) => {
+  const value = Number.parseInt(hex.slice(1), 16);
+
+  return `rgb(${value >> 16}, ${(value >> 8) & 255}, ${value & 255})`;
+};
+
+const pageBackground = async (page: Page) =>
+  page.locator('html').evaluate((element) => getComputedStyle(element).backgroundColor);
+
+test('uses Latte for light mode and Mocha for dark mode', async ({ page }) => {
+  await page.emulateMedia({ colorScheme: 'light' });
+  await page.goto('/');
+  await expect(page.locator('html')).toHaveCSS('background-color', toRgb(flavors.latte.colors.base.hex));
+  await expect(page.locator('main h1')).toHaveCSS('color', toRgb(flavors.latte.colors.text.hex));
+
+  await page.emulateMedia({ colorScheme: 'dark' });
+  await expect(page.locator('html')).toHaveCSS('background-color', toRgb(flavors.mocha.colors.base.hex));
+  await expect(page.locator('main h1')).toHaveCSS('color', toRgb(flavors.mocha.colors.text.hex));
+});
+
+test('makes every Catppuccin flavor available explicitly', async ({ page }) => {
+  await page.goto('/');
+
+  for (const flavor of ['latte', 'frappe', 'macchiato', 'mocha'] as const) {
+    await page.locator('html').evaluate((element, theme) => element.setAttribute('data-theme', theme), flavor);
+    expect(await pageBackground(page)).toBe(toRgb(flavors[flavor].colors.base.hex));
+  }
+});
+
+test('serves fonts locally and presents a visible keyboard focus indicator', async ({ page }) => {
+  const fontRequests: string[] = [];
+  page.on('request', (request) => {
+    if (request.resourceType() === 'font') fontRequests.push(request.url());
+  });
+
+  await page.goto('/');
+  await page.keyboard.press('Tab');
+
+  await expect(page.locator('a').first()).toBeFocused();
+  await expect(page.locator('a').first()).not.toHaveCSS('outline-style', 'none');
+  expect(fontRequests.length).toBeGreaterThan(0);
+  expect(fontRequests.every((url) => new URL(url).origin === 'http://127.0.0.1:4321')).toBe(true);
+});

package/dist/template/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist", "coverage", "playwright-report", "test-results"]
+}

package/dist/template/vitest.config.ts

@@ -0,0 +1,8 @@
+/// <reference types="vitest/config" />
+import { getViteConfig } from 'astro/config';
+
+export default getViteConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+  },
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@rm-industries/create-forge",
+  "version": "0.3.0-alpha.0",
+  "description": "Create a content-driven Forge website",
+  "keywords": [
+    "astro",
+    "create-forge",
+    "generator",
+    "sveltia"
+  ],
+  "homepage": "https://github.com/rm-industries/forge/tree/main/packages/create-forge#readme",
+  "bugs": {
+    "url": "https://github.com/rm-industries/forge/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rm-industries/forge.git",
+    "directory": "packages/create-forge"
+  },
+  "bin": {
+    "create-forge": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "scripts": {
+    "build": "tsdown && node scripts/copy-template.ts",
+    "prepack": "npm run typecheck && npm test && npm run build",
+    "test": "vitest run",
+    "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"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "commander": "^14.0.3",
+    "validate-npm-package-name": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/validate-npm-package-name": "^4.0.2"
+  },
+  "engines": {
+    "node": "^22.22.2 || ^24.0.0 || ^26.0.0",
+    "npm": "^10.9.0 || ^11.0.0"
+  }
+}