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

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

@@ -0,0 +1,28 @@
+import { createSveltiaCollection } from '@rm-industries/content-model/sveltia';
+import type { CmsConfig } from '@sveltia/cms';
+
+import { contentModels } from '../../config/content-models/registry.ts';
+import { cmsBranding } from '../../config/site.ts';
+
+export const sveltiaConfig = {
+  load_config_file: false,
+  app_title: cmsBranding.appTitle,
+  logo: { src: '/favicon.svg' },
+  backend: {
+    name: 'github',
+    repo: 'your-github-user/your-repository',
+    branch: 'main',
+    auth_methods: ['token'],
+    commit_messages: {
+      create: 'content({{collection}}): create {{slug}}',
+      update: 'content({{collection}}): update {{slug}}',
+      delete: 'content({{collection}}): delete {{slug}}',
+      uploadMedia: 'content(assets): upload {{path}}',
+      deleteMedia: 'content(assets): delete {{path}}',
+    },
+  },
+  media_folder: 'public/assets',
+  public_folder: '/assets',
+  output: { omit_empty_optional_fields: true },
+  collections: contentModels.map(createSveltiaCollection),
+} satisfies CmsConfig;

package/dist/template/src/integrations/sveltia/preview-collections.test.ts

@@ -0,0 +1,8 @@
+import { expect, test } from 'vitest';
+
+import { articleContentModel } from '../../config/content-models/articles.ts';
+import { previewCollectionNames } from './preview-collections.ts';
+
+test('registers a preview for every collection that renders rich content', () => {
+  expect(previewCollectionNames).toEqual([articleContentModel.name]);
+});

package/dist/template/src/integrations/sveltia/preview-collections.ts

@@ -0,0 +1,3 @@
+import { articleContentModel } from '../../config/content-models/articles.ts';
+
+export const previewCollectionNames = [articleContentModel.name] as const;

package/dist/template/src/integrations/sveltia/previews.ts

@@ -0,0 +1,13 @@
+import { registerPreviewTemplate, type CustomPreviewTemplateProps } from '@sveltia/cms';
+
+import { previewCollectionNames } from './preview-collections';
+
+const renderArticlePreview = ({ document, widgetFor }: CustomPreviewTemplateProps) => {
+  document.body.classList.add('prose', 'mx-auto');
+
+  return widgetFor('body');
+};
+
+export const registerSveltiaPreviews = (register = registerPreviewTemplate) => {
+  for (const name of previewCollectionNames) register(name, renderArticlePreview);
+};

package/dist/template/src/layouts/BaseLayout.astro

@@ -0,0 +1,41 @@
+---
+import Footer from '../components/navigation/Footer.astro';
+import Header from '../components/navigation/Header.astro';
+import SeoHead from '../components/seo/SeoHead.astro';
+import ThemeHead from '../components/theme/ThemeHead.astro';
+import { site } from '../config/site';
+import '../styles/global.css';
+
+interface Props {
+  title?: string;
+  description?: string;
+  canonicalPath?: string;
+  type?: 'article' | 'website';
+  publishedTime?: string;
+}
+
+const { title, description, canonicalPath, type, publishedTime } = Astro.props;
+---
+
+<!doctype html>
+<html lang={site.language}>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width" />
+    <SeoHead {title} {description} {canonicalPath} {type} {publishedTime} />
+    <ThemeHead />
+  </head>
+  <body>
+    <a
+      href="#main-content"
+      class="btn btn-primary btn-sm sr-only opacity-0 focus:not-sr-only focus:fixed focus:top-2 focus:left-2 focus:z-50 focus:opacity-100"
+    >
+      Skip to content
+    </a>
+    <Header />
+    <main id="main-content" tabindex="-1">
+      <slot />
+    </main>
+    <Footer />
+  </body>
+</html>

package/dist/template/src/lib/articles.ts

@@ -0,0 +1,20 @@
+import { getCollection, type CollectionEntry } from 'astro:content';
+
+export type Article = CollectionEntry<'articles'>;
+
+export const sortArticles = (entries: readonly Article[]): Article[] =>
+  [...entries].sort((left, right) => right.data.publishedAt.getTime() - left.data.publishedAt.getTime());
+
+export const getArticles = async ({ includeDrafts = false }: { includeDrafts?: boolean } = {}): Promise<Article[]> =>
+  sortArticles(await getCollection('articles', ({ data }) => includeDrafts || !data.draft));
+
+export const getArticleNeighbors = (id: string, entries: readonly Article[]) => {
+  const index = entries.findIndex((entry) => entry.id === id);
+
+  if (index < 0) return {};
+
+  return {
+    previous: entries[index + 1],
+    next: entries[index - 1],
+  };
+};

package/dist/template/src/lib/navigation.test.ts

@@ -0,0 +1,20 @@
+import { expect, test } from 'vitest';
+
+import { isCurrentPath, isExternalHref } from './navigation.ts';
+
+test('matches exact and nested navigation paths at segment boundaries', () => {
+  expect(isCurrentPath('/articles/', '/articles')).toBe(true);
+  expect(isCurrentPath('/articles/example/', '/articles/')).toBe(true);
+  expect(isCurrentPath('/articles-summary/', '/articles')).toBe(false);
+});
+
+test('matches the home route only at the site root', () => {
+  expect(isCurrentPath('/', '/')).toBe(true);
+  expect(isCurrentPath('/articles/', '/')).toBe(false);
+});
+
+test('does not treat external URLs as current paths', () => {
+  expect(isCurrentPath('/', 'https://example.com')).toBe(false);
+  expect(isExternalHref('https://example.com')).toBe(true);
+  expect(isExternalHref('/about/')).toBe(false);
+});

package/dist/template/src/lib/navigation.ts

@@ -0,0 +1,22 @@
+/** Canonicalize local paths so active navigation is stable across URL variants. */
+const normalizePath = (path: string) => {
+  const pathname = path.split(/[?#]/, 1)[0] || '/';
+  const withLeadingSlash = pathname.startsWith('/') ? pathname : `/${pathname}`;
+
+  if (withLeadingSlash === '/') return withLeadingSlash;
+
+  return withLeadingSlash.replace(/\/+$/, '');
+};
+
+export const isExternalHref = (href: string) => /^https?:\/\//u.test(href);
+
+export const isCurrentPath = (currentPath: string, href: string) => {
+  if (!href.startsWith('/')) return false;
+
+  const current = normalizePath(currentPath);
+  const target = normalizePath(href);
+
+  if (target === '/') return current === target;
+
+  return current === target || current.startsWith(`${target}/`);
+};

package/dist/template/src/pages/404.astro

@@ -0,0 +1,17 @@
+---
+import Container from '../components/ui/Container.astro';
+import BaseLayout from '../layouts/BaseLayout.astro';
+---
+
+<BaseLayout title="Page not found" description="The requested page could not be found." canonicalPath="/404/">
+  <Container size="sm" class="pb-16">
+    <section class="hero rounded-box bg-base-200 py-16 text-center">
+      <div class="hero-content flex-col">
+        <div class="badge badge-outline">404</div>
+        <h1 class="text-4xl font-bold">That page is not here.</h1>
+        <p>The address may have changed, or the page may no longer exist.</p>
+        <a href="/" class="btn btn-primary">Return home</a>
+      </div>
+    </section>
+  </Container>
+</BaseLayout>

package/dist/template/src/pages/about.astro

@@ -0,0 +1,22 @@
+---
+import Container from '../components/ui/Container.astro';
+import BaseLayout from '../layouts/BaseLayout.astro';
+---
+
+<BaseLayout title="About" description="Learn how this generic Forge starter is structured and how to make it your own.">
+  <Container size="md" class="pb-16">
+    <article class="prose mx-auto">
+      <div class="badge badge-outline">About this starter</div>
+      <h1>A useful foundation, not a finished identity.</h1>
+      <p class="lead">Forge provides an approachable structure for a content-driven website while leaving its subject, voice, and visual identity up to you.</p>
+
+      <h2>What to replace first</h2>
+      <p>Start with the typed site configuration, then replace these example articles with material that reflects your project. Shared layouts and metadata will update every route consistently.</p>
+
+      <h2>What is already connected</h2>
+      <p>Semantic navigation, responsive layout primitives, local fonts, theme-aware styling, canonical metadata, a sitemap, an RSS feed, and automated accessibility checks are ready to extend.</p>
+
+      <p><a href="/articles/">Explore the example articles</a> or return to the <a href="/">homepage</a>.</p>
+    </article>
+  </Container>
+</BaseLayout>

package/dist/template/src/pages/admin/index.astro

@@ -0,0 +1,24 @@
+---
+import SeoHead from '../../components/seo/SeoHead.astro';
+import { site } from '../../config/site';
+---
+
+<!doctype html>
+<html lang={site.language}>
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width" />
+    <meta name="robots" content="noindex, nofollow" />
+    <SeoHead title="Content Manager" description={`Content management for ${site.name}.`} canonicalPath="/admin/" />
+    <script>
+      import { init } from '@sveltia/cms';
+
+      import { sveltiaConfig } from '../../integrations/sveltia/config';
+      import { registerSveltiaPreviews } from '../../integrations/sveltia/previews';
+
+      registerSveltiaPreviews();
+      init({ config: sveltiaConfig });
+    </script>
+  </head>
+  <body></body>
+</html>

package/dist/template/src/pages/articles/[slug].astro

@@ -0,0 +1,58 @@
+---
+import type { GetStaticPaths } from 'astro';
+import { render } from 'astro:content';
+
+import Pagination from '../../components/navigation/Pagination.astro';
+import Container from '../../components/ui/Container.astro';
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import { getArticleNeighbors, getArticles, type Article } from '../../lib/articles';
+
+export const getStaticPaths = (async () => {
+  const articles = await getArticles({ includeDrafts: import.meta.env.DEV });
+
+  return articles.map((article) => ({
+    params: { slug: article.id },
+    props: { article, articles },
+  }));
+}) satisfies GetStaticPaths;
+
+interface Props {
+  article: Article;
+  articles: readonly Article[];
+}
+
+const { article, articles } = Astro.props;
+const { Content } = await render(article);
+const { previous, next } = getArticleNeighbors(article.id, articles);
+const publishedAt = article.data.publishedAt.toISOString();
+const formattedDate = article.data.publishedAt.toLocaleDateString('en', {
+  dateStyle: 'long',
+  timeZone: 'UTC',
+});
+---
+
+<BaseLayout
+  title={article.data.title}
+  description={article.data.description}
+  type="article"
+  publishedTime={publishedAt}
+>
+  <Container size="md" class="space-y-10 pb-16">
+    <article class="prose mx-auto">
+      {article.data.draft && <div class="badge badge-warning">Draft preview</div>}
+      <h1>{article.data.title}</h1>
+      <p><time datetime={publishedAt}>{formattedDate}</time></p>
+      <p class="lead">{article.data.description}</p>
+      <div class="card-actions" aria-label="Article tags">
+        {article.data.tags.map((tag) => <span class="badge badge-outline">{tag}</span>)}
+      </div>
+      <Content />
+    </article>
+
+    <Pagination
+      label="Article navigation"
+      previous={previous && { href: `/articles/${previous.id}/`, label: previous.data.title }}
+      next={next && { href: `/articles/${next.id}/`, label: next.data.title }}
+    />
+  </Container>
+</BaseLayout>

package/dist/template/src/pages/articles/index.astro

@@ -0,0 +1,34 @@
+---
+import Card from '../../components/ui/Card.astro';
+import Container from '../../components/ui/Container.astro';
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import { getArticles } from '../../lib/articles';
+
+const articles = await getArticles({ includeDrafts: import.meta.env.DEV });
+---
+
+<BaseLayout title="Articles" description="Generic example articles that demonstrate Forge content routes and metadata.">
+  <Container class="space-y-10 pb-16">
+    <header class="max-w-2xl space-y-3">
+      <div class="badge badge-outline">Example content</div>
+      <h1 class="text-4xl font-bold">Articles</h1>
+      <p>Replace these generic entries with your own subject matter when you connect the site to its content model.</p>
+    </header>
+
+    <div class="grid gap-6 md:grid-cols-2">
+      {
+        articles.map((article) => (
+          <Card href={`/articles/${article.id}/`} size="lg">
+            <time datetime={article.data.publishedAt.toISOString()}>{article.data.publishedAt.toLocaleDateString('en', { dateStyle: 'long', timeZone: 'UTC' })}</time>
+            <h2 class="card-title">{article.data.title}</h2>
+            <p>{article.data.description}</p>
+            <div class="card-actions" aria-label="Article tags">
+              {article.data.tags.map((tag) => <span class="badge badge-outline">{tag}</span>)}
+            </div>
+            {article.data.draft && <div class="badge badge-warning">Draft preview</div>}
+          </Card>
+        ))
+      }
+    </div>
+  </Container>
+</BaseLayout>

package/dist/template/src/pages/index.astro

@@ -0,0 +1,64 @@
+---
+import BaseLayout from '../layouts/BaseLayout.astro';
+import { site } from '../config/site';
+import Card from '../components/ui/Card.astro';
+import Container from '../components/ui/Container.astro';
+---
+
+<BaseLayout>
+  <Container class="space-y-16 pb-16">
+    <section class="hero rounded-box bg-base-200 py-16 text-center">
+      <div class="hero-content flex-col">
+        <div class="badge badge-outline">A thoughtful Astro starting point</div>
+        <div class="max-w-3xl space-y-6">
+          <h1 class="text-5xl font-bold tracking-tight sm:text-6xl">Build something worth publishing.</h1>
+          <p class="text-lg">{site.description} Start with accessible components, typed configuration, and a theme system that works without client JavaScript.</p>
+          <div class="flex flex-wrap justify-center gap-3">
+            <a href="/articles/" class="btn btn-primary">Read the examples</a>
+            <a href="/about/" class="btn btn-ghost">About this starter</a>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section id="features" class="space-y-8" aria-labelledby="features-title">
+      <div class="max-w-2xl space-y-3">
+        <div class="badge">Included by default</div>
+        <h2 id="features-title" class="text-3xl font-bold">A solid foundation, ready for your content</h2>
+        <p>Forge keeps the starting point practical: enough structure to demonstrate the system, without prescribing what your site must become.</p>
+      </div>
+
+      <div class="grid gap-6 md:grid-cols-3">
+        <Card size="lg">
+          <div class="badge">Content</div>
+          <h3 class="card-title">Content-first structure</h3>
+          <p>Use reusable layouts and components for articles, notes, documentation, or a personal site.</p>
+        </Card>
+
+        <Card size="lg">
+          <div class="badge">Design</div>
+          <h3 class="card-title">Adaptable themes</h3>
+          <p>Start with four Catppuccin flavors, local fonts, and accessible DaisyUI components.</p>
+        </Card>
+
+        <Card size="lg">
+          <div class="badge">Quality</div>
+          <h3 class="card-title">Production-minded checks</h3>
+          <p>Formatting, linting, type checking, browser tests, and accessibility assertions are already connected.</p>
+        </Card>
+      </div>
+
+    </section>
+
+    <section id="start" class="card bg-base-200" aria-labelledby="start-title">
+      <div class="card-body items-start">
+        <div class="badge badge-outline">Make it yours</div>
+        <h2 id="start-title" class="card-title text-3xl">Replace the examples with your own story.</h2>
+        <p>Update the typed site configuration, choose your content model, and grow the template one reusable piece at a time.</p>
+        <div class="card-actions">
+          <a href="/articles/" class="btn">Browse the articles</a>
+        </div>
+      </div>
+    </section>
+  </Container>
+</BaseLayout>

package/dist/template/src/pages/robots.txt.ts

@@ -0,0 +1,8 @@
+import type { APIRoute } from 'astro';
+
+import { site } from '../config/site';
+
+export const GET: APIRoute = () =>
+  new Response(`User-agent: *\nAllow: /\nSitemap: ${new URL('sitemap-index.xml', site.url)}\n`, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  });

package/dist/template/src/pages/rss.xml.ts

@@ -0,0 +1,17 @@
+import rss from '@astrojs/rss';
+
+import { site } from '../config/site';
+import { getArticles } from '../lib/articles';
+
+export const GET = async () =>
+  rss({
+    title: site.name,
+    description: site.description,
+    site: site.url,
+    items: (await getArticles()).map((article) => ({
+      title: article.data.title,
+      description: article.data.description,
+      link: `/articles/${article.id}/`,
+      pubDate: article.data.publishedAt,
+    })),
+  });

package/dist/template/src/pages/site.webmanifest.ts

@@ -0,0 +1,19 @@
+import type { APIRoute } from 'astro';
+
+import { site } from '../config/site';
+import { darkThemeColor } from '../themes/site-theme';
+
+export const GET: APIRoute = () =>
+  new Response(
+    JSON.stringify({
+      name: site.name,
+      short_name: site.name,
+      description: site.description,
+      start_url: '/',
+      display: 'standalone',
+      background_color: darkThemeColor,
+      theme_color: darkThemeColor,
+      icons: [{ src: '/favicon.svg', sizes: 'any', type: 'image/svg+xml' }],
+    }),
+    { headers: { 'Content-Type': 'application/manifest+json' } },
+  );

package/dist/template/src/styles/global.css

@@ -0,0 +1,73 @@
+@import 'tailwindcss';
+@import '@fontsource/fira-sans/400.css';
+@import '@fontsource/fira-sans/500.css';
+@import '@fontsource/fira-sans/600.css';
+@import '@fontsource/fira-sans/700.css';
+@import '@fontsource/fira-code/400.css';
+@import '@fontsource/fira-code/500.css';
+@import './print.css';
+
+@plugin 'daisyui' {
+  themes: false;
+}
+
+@plugin '@tailwindcss/typography';
+@plugin '../themes/catppuccinTheme.latte.ts';
+@plugin '../themes/catppuccinTheme.frappe.ts';
+@plugin '../themes/catppuccinTheme.macchiato.ts';
+@plugin '../themes/catppuccinTheme.mocha.ts';
+
+@theme {
+  --font-sans: 'Fira Sans', ui-sans-serif, system-ui, sans-serif;
+  --font-mono: 'Fira Code', ui-monospace, monospace;
+}
+
+html {
+  min-height: 100%;
+  background-color: var(--color-base-100);
+  color: var(--color-base-content);
+  font-family: var(--font-sans);
+}
+
+body {
+  min-height: 100vh;
+  margin: 0;
+}
+
+.prose {
+  --tw-prose-body: var(--color-base-content);
+  --tw-prose-headings: var(--color-base-content);
+  --tw-prose-lead: var(--color-base-content);
+  --tw-prose-links: var(--color-primary);
+  --tw-prose-bold: var(--color-base-content);
+  --tw-prose-counters: var(--color-base-content);
+  --tw-prose-bullets: var(--color-primary);
+  --tw-prose-hr: var(--color-base-300);
+  --tw-prose-quotes: var(--color-base-content);
+  --tw-prose-quote-borders: var(--color-primary);
+  --tw-prose-captions: var(--color-base-content);
+  --tw-prose-kbd: var(--color-base-content);
+  --tw-prose-kbd-shadows: var(--color-base-300);
+  --tw-prose-code: var(--color-base-content);
+  --tw-prose-pre-code: var(--color-base-content);
+  --tw-prose-pre-bg: var(--color-base-200);
+  --tw-prose-th-borders: var(--color-base-300);
+  --tw-prose-td-borders: var(--color-base-300);
+}
+
+:where(a, button, input, select, summary, textarea):focus-visible {
+  border-radius: 0.125rem;
+  outline: 0.1875rem solid var(--color-primary);
+  outline-offset: 0.1875rem;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    scroll-behavior: auto !important;
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+  }
+}

package/dist/template/src/styles/print.css

@@ -0,0 +1,34 @@
+.print-only {
+  display: none;
+}
+
+@media print {
+  @page {
+    margin: 0.6in;
+  }
+
+  html,
+  body {
+    background: #fff !important;
+    color: #000 !important;
+  }
+
+  body > header,
+  body > footer,
+  .no-print {
+    display: none !important;
+  }
+
+  .print-only {
+    display: block !important;
+  }
+
+  a[href]::after {
+    content: ' (' attr(href) ')';
+  }
+
+  a[href^='/']::after,
+  a[href^='#']::after {
+    content: '';
+  }
+}

package/dist/template/src/themes/catppuccinTheme.frappe.ts

@@ -0,0 +1,5 @@
+import { createCatppuccinPlugin } from '@catppuccin/daisyui';
+
+import { getCatppuccinDaisyOptions } from './site-theme';
+
+export default createCatppuccinPlugin('frappe', {}, getCatppuccinDaisyOptions('frappe'));

package/dist/template/src/themes/catppuccinTheme.latte.ts

@@ -0,0 +1,5 @@
+import { createCatppuccinPlugin } from '@catppuccin/daisyui';
+
+import { getCatppuccinDaisyOptions } from './site-theme';
+
+export default createCatppuccinPlugin('latte', {}, getCatppuccinDaisyOptions('latte'));

package/dist/template/src/themes/catppuccinTheme.macchiato.ts

@@ -0,0 +1,5 @@
+import { createCatppuccinPlugin } from '@catppuccin/daisyui';
+
+import { getCatppuccinDaisyOptions } from './site-theme';
+
+export default createCatppuccinPlugin('macchiato', {}, getCatppuccinDaisyOptions('macchiato'));

package/dist/template/src/themes/catppuccinTheme.mocha.ts

@@ -0,0 +1,5 @@
+import { createCatppuccinPlugin } from '@catppuccin/daisyui';
+
+import { getCatppuccinDaisyOptions } from './site-theme';
+
+export default createCatppuccinPlugin('mocha', {}, getCatppuccinDaisyOptions('mocha'));

package/dist/template/src/themes/site-theme.test.ts

@@ -0,0 +1,19 @@
+import { flavors } from '@catppuccin/palette';
+import type { FlavorName } from '@catppuccin/palette';
+import { expect, test } from 'vitest';
+
+import { darkTheme, darkThemeColor, getCatppuccinDaisyOptions, lightTheme, lightThemeColor } from './site-theme.ts';
+
+test('derives browser colors from the configured Catppuccin flavors', () => {
+  expect(lightThemeColor).toBe(flavors[lightTheme].colors.base.hex);
+  expect(darkThemeColor).toBe(flavors[darkTheme].colors.base.hex);
+});
+
+test('marks exactly one light default and one preferred dark theme', () => {
+  const flavorNames = Object.keys(flavors) as FlavorName[];
+  const defaults = flavorNames.filter((flavor) => getCatppuccinDaisyOptions(flavor).default);
+  const preferredDark = flavorNames.filter((flavor) => getCatppuccinDaisyOptions(flavor).prefersdark);
+
+  expect(defaults).toEqual([lightTheme]);
+  expect(preferredDark).toEqual([darkTheme]);
+});

package/dist/template/src/themes/site-theme.ts

@@ -0,0 +1,13 @@
+import { flavors } from '@catppuccin/palette';
+import type { FlavorName } from '@catppuccin/palette';
+
+export const lightTheme: FlavorName = 'latte';
+export const darkTheme: FlavorName = 'mocha';
+
+export const lightThemeColor = flavors[lightTheme].colors.base.hex;
+export const darkThemeColor = flavors[darkTheme].colors.base.hex;
+
+export const getCatppuccinDaisyOptions = (theme: FlavorName) => ({
+  default: theme === lightTheme,
+  prefersdark: theme === darkTheme,
+});

package/dist/template/stylelint.config.ts

@@ -0,0 +1,19 @@
+import type { Config } from 'stylelint';
+
+export default {
+  extends: ['stylelint-config-standard'],
+  rules: {
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: ['apply', 'plugin', 'theme'],
+      },
+    ],
+    'import-notation': [
+      'string',
+      {
+        ignore: ['tailwindcss'],
+      },
+    ],
+  },
+} satisfies Config;