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

package/dist/template/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "__RM_INDUSTRIES_FORGE_TEMPLATE_V1_PACKAGE_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro",
+    "astro:check": "astro check",
+    "audit": "npm audit --audit-level=high",
+    "format": "oxfmt --check",
+    "format:fix": "oxfmt",
+    "lint": "npm run lint:code && npm run lint:css && npm run lint:markdown && npm run spellcheck",
+    "lint:code": "oxlint",
+    "lint:code:fix": "oxlint --fix",
+    "lint:css": "stylelint \"**/*.css\" --ignore-path .gitignore",
+    "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",
+    "spellcheck": "cspell \"**\"",
+    "typecheck": "astro sync && tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "quality": "npm run format && npm run lint && npm run typecheck && npm run astro:check && npm test && npm run build"
+  },
+  "dependencies": {
+    "@astrojs/rss": "^4.0.19",
+    "@astrojs/sitemap": "^3.7.3",
+    "@fontsource/fira-code": "^5.3.0",
+    "@fontsource/fira-sans": "^5.3.0",
+    "@rm-industries/content-model": "0.1.0-alpha.0",
+    "@sveltia/cms": "0.193.2",
+    "astro": "^7.2.3"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.10",
+    "@axe-core/playwright": "^4.13.0",
+    "@catppuccin/daisyui": "^2.1.1",
+    "@catppuccin/palette": "^1.8.0",
+    "@playwright/test": "^1.62.1",
+    "@tailwindcss/typography": "^0.5.20",
+    "@tailwindcss/vite": "^4.3.3",
+    "cspell": "^10.0.1",
+    "daisyui": "^5.7.18",
+    "markdownlint-cli": "^0.49.0",
+    "oxfmt": "^0.63.0",
+    "oxlint": "^1.72.0",
+    "stylelint": "^17.14.1",
+    "stylelint-config-standard": "^40.0.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": "^22.22.2 || ^24.0.0 || ^26.0.0",
+    "npm": "^10.9.0 || ^11.0.0"
+  },
+  "packageManager": "npm@11.18.0"
+}

package/dist/template/playwright.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 2 : 0,
+  reporter: process.env.CI ? 'github' : 'list',
+  use: {
+    baseURL: 'http://127.0.0.1:4321',
+    trace: 'on-first-retry',
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+  webServer: {
+    command: 'npm run dev -- --host 127.0.0.1',
+    url: 'http://127.0.0.1:4321',
+    reuseExistingServer: !process.env.CI,
+  },
+});

package/dist/template/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect width="64" height="64" rx="14" fill="#1e1e2e" />
+  <path d="M17 14h32v9H27v9h18v9H27v17H17z" fill="#cba6f7" />
+</svg>

package/dist/template/public/social-card.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630">
+  <title>Forge</title>
+  <desc>A generic social sharing card for a Forge website</desc>
+  <rect width="1200" height="630" fill="#1e1e2e" />
+  <rect x="72" y="72" width="1056" height="486" rx="40" fill="#313244" />
+  <text x="600" y="290" fill="#cdd6f4" font-family="system-ui, sans-serif" font-size="112" font-weight="700" text-anchor="middle">Forge</text>
+  <text x="600" y="380" fill="#bac2de" font-family="system-ui, sans-serif" font-size="38" text-anchor="middle">A thoughtful starting point for your content</text>
+</svg>

package/dist/template/src/components/navigation/Footer.astro

@@ -0,0 +1,33 @@
+---
+import { site } from '../../config/site';
+import { isExternalHref } from '../../lib/navigation';
+import Container from '../ui/Container.astro';
+---
+
+<footer class="bg-base-200">
+  <Container class="footer footer-horizontal py-10">
+    <aside>
+      <h2>{site.name}</h2>
+      <p>{site.description}</p>
+      <p>© {new Date().getFullYear()} {site.name}</p>
+    </aside>
+
+    {
+      site.socialLinks.length > 0 && (
+        <nav aria-label="Social links">
+          <h2>Elsewhere</h2>
+          {site.socialLinks.map((item) => (
+            <a
+              href={item.href}
+              class="link link-hover"
+              target={isExternalHref(item.href) ? '_blank' : undefined}
+              rel={isExternalHref(item.href) ? 'noopener noreferrer' : undefined}
+            >
+              {item.label}
+            </a>
+          ))}
+        </nav>
+      )
+    }
+  </Container>
+</footer>

package/dist/template/src/components/navigation/Header.astro

@@ -0,0 +1,11 @@
+---
+import { site } from '../../config/site';
+import Container from '../ui/Container.astro';
+import Navbar from './Navbar.astro';
+---
+
+<header>
+  <Container class="py-4">
+    <Navbar brand={site.name} links={site.navigation} currentPath={Astro.url.pathname} />
+  </Container>
+</header>

package/dist/template/src/components/navigation/Navbar.astro

@@ -0,0 +1,60 @@
+---
+import type { SiteLink } from '../../config/site';
+import { isCurrentPath } from '../../lib/navigation';
+
+interface Props {
+  brand: string;
+  brandHref?: string;
+  links: readonly SiteLink[];
+  currentPath: string;
+}
+
+const { brand, brandHref = '/', links, currentPath } = Astro.props;
+---
+
+<div class="navbar rounded-box bg-base-200 shadow-sm">
+  <div class="navbar-start">
+    <a href={brandHref} class="btn btn-ghost text-xl">{brand}</a>
+  </div>
+
+  <nav class="navbar-end hidden sm:flex" aria-label="Primary navigation">
+    <ul class="menu menu-horizontal" role="list">
+      {
+        links.map((item) => {
+          const isCurrent = isCurrentPath(currentPath, item.href);
+
+          return (
+            <li>
+              <a href={item.href} aria-current={isCurrent ? 'page' : undefined} class:list={[isCurrent && 'menu-active']}>
+                {item.label}
+              </a>
+            </li>
+          );
+        })
+      }
+    </ul>
+  </nav>
+
+  <div class="navbar-end sm:hidden">
+    <details class="dropdown dropdown-end">
+      <summary class="btn btn-ghost">Menu</summary>
+      <nav class="dropdown-content z-10 mt-3 w-52 rounded-box bg-base-200 p-2 shadow" aria-label="Mobile navigation">
+        <ul class="menu" role="list">
+          {
+            links.map((item) => {
+              const isCurrent = isCurrentPath(currentPath, item.href);
+
+              return (
+                <li>
+                  <a href={item.href} aria-current={isCurrent ? 'page' : undefined} class:list={[isCurrent && 'menu-active']}>
+                    {item.label}
+                  </a>
+                </li>
+              );
+            })
+          }
+        </ul>
+      </nav>
+    </details>
+  </div>
+</div>

package/dist/template/src/components/navigation/Pagination.astro

@@ -0,0 +1,37 @@
+---
+interface PaginationLink {
+  href: string;
+  label: string;
+}
+
+interface Props {
+  previous?: PaginationLink;
+  next?: PaginationLink;
+  label?: string;
+}
+
+const { previous, next, label = 'Pagination' } = Astro.props;
+---
+
+<nav aria-label={label} class="join grid grid-cols-2">
+  {
+    previous ? (
+      <a href={previous.href} rel="prev" class="btn btn-outline join-item">
+        <span aria-hidden="true">←</span>
+        <span>{previous.label}</span>
+      </a>
+    ) : (
+      <span class="btn btn-disabled btn-outline join-item" aria-disabled="true">No previous page</span>
+    )
+  }
+  {
+    next ? (
+      <a href={next.href} rel="next" class="btn btn-outline join-item">
+        <span>{next.label}</span>
+        <span aria-hidden="true">→</span>
+      </a>
+    ) : (
+      <span class="btn btn-disabled btn-outline join-item" aria-disabled="true">No next page</span>
+    )
+  }
+</nav>

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

@@ -0,0 +1,48 @@
+---
+import { site } from '../../config/site';
+
+interface Props {
+  title?: string;
+  description?: string;
+  canonicalPath?: string;
+  type?: 'article' | 'website';
+  publishedTime?: string;
+}
+
+const {
+  title,
+  description = site.description,
+  canonicalPath = Astro.url.pathname,
+  type = 'website',
+  publishedTime,
+} = Astro.props;
+
+const normalizedPath = (() => {
+  const path = `/${canonicalPath}`.replace(/\/{2,}/g, '/');
+  return path === '/' ? path : `${path.replace(/\/$/, '')}/`;
+})();
+const canonicalUrl = new URL(normalizedPath, site.url);
+const pageTitle = title ? `${title} | ${site.name}` : site.name;
+const socialImageUrl = new URL(site.socialImage, site.url);
+---
+
+<title>{pageTitle}</title>
+<meta name="description" content={description} />
+<link rel="canonical" href={canonicalUrl} />
+<link rel="sitemap" href="/sitemap-index.xml" />
+<link rel="alternate" type="application/rss+xml" title={`${site.name} RSS feed`} href="/rss.xml" />
+<link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+<link rel="manifest" href="/site.webmanifest" />
+
+<meta property="og:site_name" content={site.name} />
+<meta property="og:title" content={pageTitle} />
+<meta property="og:description" content={description} />
+<meta property="og:url" content={canonicalUrl} />
+<meta property="og:type" content={type} />
+<meta property="og:image" content={socialImageUrl} />
+{publishedTime && <meta property="article:published_time" content={publishedTime} />}
+
+<meta name="twitter:card" content="summary_large_image" />
+<meta name="twitter:title" content={pageTitle} />
+<meta name="twitter:description" content={description} />
+<meta name="twitter:image" content={socialImageUrl} />

package/dist/template/src/components/theme/ThemeHead.astro

@@ -0,0 +1,6 @@
+---
+import { darkThemeColor, lightThemeColor } from '../../themes/site-theme';
+---
+
+<meta name="theme-color" content={lightThemeColor} media="(prefers-color-scheme: light)" />
+<meta name="theme-color" content={darkThemeColor} media="(prefers-color-scheme: dark)" />

package/dist/template/src/components/ui/Card.astro

@@ -0,0 +1,26 @@
+---
+interface Props {
+  class?: string;
+  href?: string;
+  size?: 'sm' | 'md' | 'lg';
+}
+
+const { class: className, href, size = 'md' } = Astro.props;
+const classes = ['card bg-base-200', `card-${size}`, className];
+---
+
+{
+  href ? (
+    <a href={href} class:list={classes}>
+      <div class="card-body">
+        <slot />
+      </div>
+    </a>
+  ) : (
+    <div class:list={classes}>
+      <div class="card-body">
+        <slot />
+      </div>
+    </div>
+  )
+}

package/dist/template/src/components/ui/Container.astro

@@ -0,0 +1,17 @@
+---
+interface Props {
+  class?: string;
+  size?: 'sm' | 'md' | 'lg';
+}
+
+const { class: className, size = 'lg' } = Astro.props;
+const widths = {
+  sm: 'max-w-2xl',
+  md: 'max-w-4xl',
+  lg: 'max-w-5xl',
+};
+---
+
+<div class:list={['container mx-auto px-4', widths[size], className]}>
+  <slot />
+</div>

package/dist/template/src/config/content-models/articles.ts

@@ -0,0 +1,39 @@
+import { defineModel } from '@rm-industries/content-model';
+
+export const articleContentModel = defineModel({
+  name: 'articles',
+  label: 'Articles',
+  labelSingular: 'Article',
+  folder: 'src/content/articles',
+  extensions: ['md', 'mdx'],
+  slug: '{{slug}}',
+  sort: {
+    fields: ['publishedAt', 'title'],
+    default: { field: 'publishedAt', direction: 'descending' },
+  },
+  fields: {
+    title: { kind: 'string', required: true, label: 'Title' },
+    description: {
+      kind: 'string',
+      required: true,
+      multiline: true,
+      label: 'Description',
+      help: 'A short summary used on listing pages and in social metadata.',
+    },
+    publishedAt: { kind: 'date', mode: 'date', required: true, label: 'Published at' },
+    tags: {
+      kind: 'list',
+      default: [],
+      items: { kind: 'string', required: true, label: 'Tag' },
+      label: 'Tags',
+      help: 'Use a few concise topics that help readers understand the article.',
+    },
+    draft: {
+      kind: 'boolean',
+      default: false,
+      label: 'Draft',
+      help: 'Draft articles appear locally but are excluded from production builds and feeds.',
+    },
+  },
+  body: { name: 'body', label: 'Body', required: true },
+});

package/dist/template/src/config/content-models/registry.ts

@@ -0,0 +1,5 @@
+import { defineModels } from '@rm-industries/content-model';
+
+import { articleContentModel } from './articles.ts';
+
+export const contentModels = defineModels([articleContentModel]);

package/dist/template/src/config/site.test.ts

@@ -0,0 +1,37 @@
+import { expect, test } from 'vitest';
+
+import { cmsBranding, defineSiteConfig, site, type SiteConfig } from './site.ts';
+
+const validConfig = {
+  name: 'Example site',
+  description: 'An example site description.',
+  author: 'Example Author',
+  url: 'https://example.test',
+  repository: 'example/site',
+  language: 'en',
+  socialImage: '/social-card.svg',
+  navigation: [{ label: 'Home', href: '/' }],
+  socialLinks: [],
+} satisfies SiteConfig;
+
+test('normalizes and freezes valid configuration', () => {
+  const config = defineSiteConfig(validConfig);
+
+  expect(config.url).toBe('https://example.test/');
+  expect(Object.isFrozen(config)).toBe(true);
+  expect(Object.isFrozen(config.navigation)).toBe(true);
+});
+
+test('rejects an empty site name', () => {
+  expect(() => defineSiteConfig({ ...validConfig, name: '  ' })).toThrow(/name must not be empty/);
+});
+
+test('rejects a non-HTTP canonical URL', () => {
+  expect(() => defineSiteConfig({ ...validConfig, url: 'file:///example' })).toThrow(
+    /url must use the HTTP or HTTPS protocol/,
+  );
+});
+
+test('derives CMS branding from the site name', () => {
+  expect(cmsBranding.appTitle).toBe(`${site.name} Content Manager`);
+});

package/dist/template/src/config/site.ts

@@ -0,0 +1,95 @@
+export interface SiteLink {
+  label: string;
+  href: string;
+}
+
+export interface SiteConfig {
+  name: string;
+  description: string;
+  author: string;
+  url: string;
+  repository: string;
+  language: string;
+  socialImage: string;
+  navigation: readonly SiteLink[];
+  socialLinks: readonly SiteLink[];
+}
+
+const requireText = (value: string, field: string): string => {
+  const normalizedValue = value.trim();
+
+  if (!normalizedValue) {
+    throw new TypeError(`${field} must not be empty.`);
+  }
+
+  return normalizedValue;
+};
+
+const validateOptionalText = (value: string, field: string): string => {
+  const normalizedValue = value.trim();
+  if (/\p{Cc}/u.test(normalizedValue)) throw new TypeError(`${field} must not contain control characters.`);
+  return normalizedValue;
+};
+
+const requireSiteUrl = (value: string): string => {
+  let url: URL;
+
+  try {
+    url = new URL(value);
+  } catch {
+    throw new TypeError('url must be an absolute URL.');
+  }
+
+  if (!['http:', 'https:'].includes(url.protocol)) {
+    throw new TypeError('url must use the HTTP or HTTPS protocol.');
+  }
+
+  if (url.username || url.password || url.search || url.hash) {
+    throw new TypeError('url must not include credentials, a query, or a fragment.');
+  }
+
+  url.pathname = `${url.pathname.replace(/\/+$/, '')}/`;
+
+  return url.href;
+};
+
+const requireLinks = (links: readonly SiteLink[], field: string): readonly SiteLink[] =>
+  Object.freeze(
+    links.map((link, index) => ({
+      label: requireText(link.label, `${field}[${index}].label`),
+      href: requireText(link.href, `${field}[${index}].href`),
+    })),
+  );
+
+export const defineSiteConfig = (config: SiteConfig): Readonly<SiteConfig> =>
+  Object.freeze({
+    name: requireText(config.name, 'name'),
+    description: requireText(config.description, 'description'),
+    author: validateOptionalText(config.author, 'author'),
+    url: requireSiteUrl(config.url),
+    repository: validateOptionalText(config.repository, 'repository'),
+    language: requireText(config.language, 'language'),
+    socialImage: requireText(config.socialImage, 'socialImage'),
+    navigation: requireLinks(config.navigation, 'navigation'),
+    socialLinks: requireLinks(config.socialLinks, 'socialLinks'),
+  });
+
+export const site = defineSiteConfig({
+  name: '__RM_INDUSTRIES_FORGE_TEMPLATE_V1_SITE_NAME__',
+  description: '__RM_INDUSTRIES_FORGE_TEMPLATE_V1_DESCRIPTION__',
+  author: '__RM_INDUSTRIES_FORGE_TEMPLATE_V1_AUTHOR__',
+  url: '__RM_INDUSTRIES_FORGE_TEMPLATE_V1_URL__',
+  repository: '__RM_INDUSTRIES_FORGE_TEMPLATE_V1_REPOSITORY__',
+  language: 'en',
+  socialImage: '/social-card.svg',
+  navigation: [
+    { label: 'Home', href: '/' },
+    { label: 'Articles', href: '/articles/' },
+    { label: 'About', href: '/about/' },
+  ],
+  socialLinks: [],
+});
+
+export const cmsBranding = Object.freeze({
+  appTitle: `${site.name} Content Manager`,
+});

package/dist/template/src/content/articles/accessible-by-default.md

@@ -0,0 +1,22 @@
+---
+title: Accessible by default
+description: Why landmarks, focus behavior, and readable metadata belong in the foundation rather than a final pass.
+publishedAt: 2026-01-30
+tags:
+  - Accessibility
+  - Foundations
+draft: false
+---
+
+Accessibility is most dependable when it is part of the page structure.
+Semantic landmarks and visible focus states then benefit every route
+automatically.
+
+Automated checks do not replace thoughtful review, but they protect the
+baseline while the site grows and changes hands.
+
+## A dependable baseline
+
+- Use semantic landmarks before adding ARIA.
+- Keep keyboard focus visible.
+- Test content at narrow and wide viewport sizes.

package/dist/template/src/content/articles/content-that-travels-well.md

@@ -0,0 +1,17 @@
+---
+title: Content that travels well
+description: A practical case for keeping example content portable, structured, and easy to replace.
+publishedAt: 2026-02-21
+tags:
+  - Content
+  - Portability
+draft: false
+---
+
+Portable content starts with a small contract: a stable slug, a useful summary,
+a publication date, and the text readers came to find.
+
+Keeping the example data separate from route rendering makes the eventual move
+to a content system explicit instead of accidental.
+
+> Portable content should remain useful when the presentation layer changes.

package/dist/template/src/content/articles/designing-a-calm-starting-point.md

@@ -0,0 +1,22 @@
+---
+title: Designing a calm starting point
+description: How a small set of deliberate defaults can leave room for a site to develop its own identity.
+publishedAt: 2026-03-14
+tags:
+  - Design
+  - Defaults
+draft: false
+---
+
+A useful starter should make the first page feel considered without deciding
+what every future page must become.
+
+Begin with a clear hierarchy, dependable spacing, and components that can be
+replaced one at a time. The result is easier to understand and safer to
+customize.
+
+## Start with the essentials
+
+1. Establish a readable hierarchy.
+2. Keep the first set of components small.
+3. Replace examples as the site's purpose becomes clearer.

package/dist/template/src/content/articles/future-draft.md

@@ -0,0 +1,11 @@
+---
+title: A future draft
+description: An unpublished entry used to prove production filtering.
+publishedAt: 2027-01-01
+tags:
+  - Drafts
+draft: true
+---
+
+This draft is available to local development but must never be emitted by a
+production build or feed.

package/dist/template/src/content.config.ts

@@ -0,0 +1,5 @@
+import { createAstroCollections } from '@rm-industries/content-model/astro';
+
+import { contentModels } from './config/content-models/registry.ts';
+
+export const collections = createAstroCollections(contentModels);

package/dist/template/src/integrations/sveltia/config.test.ts

@@ -0,0 +1,35 @@
+import { expect, test } from 'vitest';
+
+import { articleContentModel } from '../../config/content-models/articles.ts';
+import { sveltiaConfig } from './config.ts';
+
+test('derives the article collection from the shared model', () => {
+  expect(sveltiaConfig.collections.map(({ name }) => name)).toEqual([articleContentModel.name]);
+  expect(sveltiaConfig.collections[0]?.fields.map(({ name }) => name)).toEqual([
+    ...Object.keys(articleContentModel.fields),
+    'body',
+  ]);
+});
+
+test('keeps authentication credentials outside the configuration', () => {
+  expect(sveltiaConfig.backend.name).toBe('github');
+  expect('token' in sveltiaConfig.backend).toBe(false);
+  expect(JSON.stringify(sveltiaConfig)).not.toContain('your-token');
+});
+
+test('exposes tags as a default-empty list derived from the article model', () => {
+  const tags = sveltiaConfig.collections[0]?.fields.find(({ name }) => name === 'tags');
+
+  expect(tags).toEqual({
+    name: 'tags',
+    label: 'Tags',
+    after_input: 'Use a few concise topics that help readers understand the article.',
+    required: false,
+    widget: 'list',
+    default: [],
+  });
+});
+
+test('serializes the generated configuration', () => {
+  expect(() => JSON.stringify(sveltiaConfig)).not.toThrow();
+});