@lettercamp/cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# Lettercamp CLI implementation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Astro renderer and commands behind Lettercamp. Most users should install the public wrapper with `npm install -g lettercamp`, then run `lettercamp dev` inside a publication.
+
+Requires Node.js 22.19 or newer. See the [repository](https://github.com/lettercamp/cli) for development and publishing instructions.

package/bin/lettercamp.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../dist/lettercamp.js';

package/dist/build.js

@@ -0,0 +1,38 @@
+import path from 'node:path';
+import { build } from 'astro';
+import mdx from '@astrojs/mdx';
+import { prepareWorkspace } from './workspace.js';
+export async function buildSite(directory, options) {
+    const origin = new URL(options.site);
+    if (!['https:', 'http:'].includes(origin.protocol))
+        throw new Error('Use an HTTP or HTTPS site URL.');
+    const root = path.resolve(directory);
+    const outDir = path.resolve(root, options.outDir ?? 'dist');
+    const overlaps = (a, b) => a === b || a.startsWith(b + path.sep) || b.startsWith(a + path.sep);
+    if (outDir === root || root.startsWith(outDir + path.sep) || ['pages', 'public'].some(name => overlaps(outDir, path.join(root, name)))) {
+        throw new Error('Output must not replace the publication or its source files.');
+    }
+    const { workspace, contentRoot, cleanup } = await prepareWorkspace(root);
+    const previousCwd = process.cwd();
+    try {
+        // Astro 7 places temporary prerender modules relative to cwd when outDir
+        // is external. Keep them beside the renderer's node_modules, not the content.
+        process.chdir(workspace);
+        await build({
+            root: workspace, configFile: false, site: origin.origin,
+            cacheDir: path.join(workspace, '.cache'),
+            publicDir: path.join(contentRoot, 'public'), outDir, output: 'static',
+            integrations: [mdx()],
+            build: { format: 'directory', ...(options.assetsPrefix ? { assetsPrefix: options.assetsPrefix } : {}) },
+            vite: { resolve: { alias: {
+                        home: path.join(workspace, 'src/layouts/Content.astro'),
+                        post: path.join(workspace, 'src/layouts/Content.astro'),
+                    } } },
+        });
+        return outDir;
+    }
+    finally {
+        process.chdir(previousCwd);
+        await cleanup();
+    }
+}

package/dist/cli.js

@@ -0,0 +1,45 @@
+import { Command, InvalidArgumentError } from 'commander';
+import { version, showVersion, update } from './version.js';
+export async function run(argv = process.argv) {
+    const program = new Command()
+        .name('lettercamp')
+        .description('Create and preview your Lettercamp publication.')
+        .version(version, '-v, --version', 'Show the installed CLI version');
+    program.command('new')
+        .description('Download the starter into a new or empty directory')
+        .argument('[directory]', 'Destination directory', 'my-lettercamp')
+        .action(async (directory) => {
+        const { createSite } = await import('./new.js');
+        await createSite(directory);
+    });
+    program.command('version')
+        .description('Show the installed and latest published CLI versions')
+        .action(showVersion);
+    program.command('update')
+        .description('Update the global npm installation if a newer version exists')
+        .action(update);
+    program.command('dev')
+        .description('Preview the current publication with live reload')
+        .option('-p, --port <number>', 'Local port', (value) => {
+        if (!/^\d+$/.test(value) || Number(value) < 1 || Number(value) > 65535) {
+            throw new InvalidArgumentError('Use a port between 1 and 65535.');
+        }
+        return Number(value);
+    }, 3000)
+        .option('--host <address>', 'Host to listen on', 'localhost')
+        .option('--open', 'Open the preview in your browser', false)
+        .action(async (options) => {
+        const { startDev } = await import('./dev.js');
+        await startDev(process.cwd(), options);
+    });
+    program.command('build')
+        .description('Build a static publication for hosting')
+        .requiredOption('--site <url>', 'Public site URL for metadata')
+        .option('--out-dir <directory>', 'Output directory', 'dist')
+        .option('--assets-prefix <url>', 'Base URL for versioned generated assets')
+        .action(async (options) => {
+        const { buildSite } = await import('./build.js');
+        await buildSite(process.cwd(), options);
+    });
+    await program.parseAsync(argv);
+}

package/dist/dev.js

@@ -0,0 +1,72 @@
+import { rm } from 'node:fs/promises';
+import path from 'node:path';
+import { dev } from 'astro';
+import mdx from '@astrojs/mdx';
+import { prepareWorkspace } from './workspace.js';
+export async function startDev(directory, options) {
+    const { workspace, contentRoot, modules } = await prepareWorkspace(directory);
+    let server;
+    let closeVite;
+    let stopping = false;
+    const cleanup = async () => {
+        if (stopping)
+            return;
+        stopping = true;
+        process.off('SIGINT', stop);
+        process.off('SIGTERM', stop);
+        try {
+            if (server)
+                await server.stop();
+            else
+                await closeVite?.();
+        }
+        finally {
+            await rm(workspace, { recursive: true, force: true, maxRetries: 3 });
+        }
+    };
+    const stop = () => {
+        cleanup().catch((error) => {
+            console.error(`Unable to clean up preview: ${error.message}`);
+            process.exitCode = 1;
+        });
+    };
+    try {
+        server = await dev({
+            root: workspace,
+            configFile: false,
+            publicDir: path.join(contentRoot, 'public'),
+            output: 'static',
+            integrations: [mdx()],
+            devToolbar: { enabled: false },
+            server: { port: options.port, host: options.host, open: options.open },
+            vite: {
+                plugins: [{
+                        name: 'lettercamp-content',
+                        configureServer(vite) {
+                            closeVite = () => vite.close();
+                            // Imported files are watched automatically, but external folders
+                            // must be registered for newly created pages to be discovered.
+                            vite.watcher.add([path.join(contentRoot, 'pages'), path.join(contentRoot, 'public'), path.join(contentRoot, 'site.json')]);
+                        },
+                    }],
+                // Astro interprets frontmatter.layout as an import. The publication's
+                // home/post names are presentation hints handled by our outer page.
+                resolve: {
+                    alias: {
+                        home: path.join(workspace, 'src/layouts/Content.astro'),
+                        post: path.join(workspace, 'src/layouts/Content.astro'),
+                    },
+                },
+                server: { strictPort: true, fs: { allow: [workspace, contentRoot, modules] } },
+            },
+        });
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+        console.log(`\nPreviewing ${contentRoot}\nChanges to pages, images, and site.json reload automatically. Press Ctrl+C to stop.\n`);
+        return { stop: cleanup, server };
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
+}

package/dist/lettercamp.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import semver from 'semver';
+try {
+    if (!semver.satisfies(process.versions.node, '>=22.19.0')) {
+        throw new Error(`Node.js 22.19 or newer is required (you have ${process.versions.node}).`);
+    }
+    const { run } = await import('./cli.js');
+    await run();
+}
+catch (error) {
+    console.error(`\nLettercamp: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+}

package/dist/new.js

@@ -0,0 +1,43 @@
+import { cp, mkdir, mkdtemp, readdir, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { downloadTemplate } from 'giget';
+async function ensureEmpty(directory) {
+    let entries;
+    try {
+        entries = await readdir(directory);
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    if (entries.length)
+        throw new Error(`Directory is not empty: ${directory}. Choose a new or empty directory.`);
+}
+export async function createSite(directory) {
+    const destination = path.resolve(directory);
+    await ensureEmpty(destination);
+    const temporary = await mkdtemp(path.join(tmpdir(), 'lettercamp-new-'));
+    try {
+        console.log('Downloading the Lettercamp starter…');
+        await downloadTemplate('github:lettercamp/starter#main', {
+            dir: temporary,
+            force: true,
+            preferOffline: false,
+        });
+        // Download first, so a failed request does not leave a half-created site.
+        await ensureEmpty(destination);
+        await mkdir(destination, { recursive: true });
+        for (const entry of await readdir(temporary)) {
+            await cp(path.join(temporary, entry), path.join(destination, entry), {
+                recursive: true, force: false, errorOnExist: true,
+            });
+        }
+        console.log(`\nCreated your publication at ${destination}`);
+        console.log('Open that directory and run: lettercamp dev');
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+}

package/dist/version.js

@@ -0,0 +1,59 @@
+import { readFile } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import semver from 'semver';
+const metadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+export const version = metadata.version;
+async function latestVersion() {
+    const response = await fetch('https://registry.npmjs.org/lettercamp/latest', {
+        signal: AbortSignal.timeout(10_000),
+        headers: { Accept: 'application/json' },
+    });
+    if (response.status === 404)
+        return null;
+    if (!response.ok)
+        throw new Error(`Unable to check npm for updates (HTTP ${response.status}).`);
+    const { version: latest } = await response.json();
+    if (!semver.valid(latest))
+        throw new Error('npm did not return a valid release version.');
+    return latest;
+}
+export async function showVersion() {
+    console.log(`Installed: ${version}`);
+    try {
+        const latest = await latestVersion();
+        console.log(latest ? `Latest:    ${latest}` : 'Latest:    not published to npm yet');
+        if (latest && semver.gt(latest, version))
+            console.log('Run lettercamp update to install it.');
+    }
+    catch (error) {
+        console.error(`Latest:    unavailable (${error instanceof Error ? error.message : String(error)})`);
+        process.exitCode = 1;
+    }
+}
+export async function update() {
+    const latest = await latestVersion();
+    if (!latest) {
+        console.log('Lettercamp has not been published to npm yet. No update is available.');
+        return;
+    }
+    if (!semver.gt(latest, version)) {
+        console.log(`Lettercamp ${version} is up to date (latest: ${latest}).`);
+        return;
+    }
+    console.log(`Updating Lettercamp ${version} → ${latest} globally with npm…`);
+    await new Promise((resolve, reject) => {
+        const child = spawn('npm', ['install', '--global', `lettercamp@${latest}`], {
+            stdio: 'inherit',
+            // Windows distributes npm as a .cmd shim. Arguments are fixed or semver-validated.
+            shell: process.platform === 'win32',
+        });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`npm update failed (${signal ?? code}). Check npm's output and your global install permissions.`));
+        });
+    });
+    console.log(`Updated to Lettercamp ${latest}.`);
+}

package/dist/workspace.js

@@ -0,0 +1,32 @@
+import { cp, mkdtemp, readFile, realpath, rm, stat, symlink, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { escapePath } from 'tinyglobby';
+const require = createRequire(import.meta.url);
+const renderer = fileURLToPath(new URL('../renderer/', import.meta.url));
+export async function prepareWorkspace(directory) {
+    const contentRoot = await realpath(directory);
+    JSON.parse(await readFile(path.join(contentRoot, 'site.json'), 'utf8'));
+    if (!(await stat(path.join(contentRoot, 'pages'))).isDirectory())
+        throw new Error('Missing pages directory.');
+    const workspace = await realpath(await mkdtemp(path.join(tmpdir(), 'lettercamp-')));
+    try {
+        await cp(renderer, workspace, { recursive: true });
+        await writeFile(path.join(workspace, 'package.json'), JSON.stringify({ private: true, type: 'module' }));
+        // Dependencies stay in the CLI installation; the glob uses real source paths
+        // so Vite sees additions and deletions without a symlink/realpath mismatch.
+        const modules = path.dirname(path.dirname(require.resolve('astro/package.json')));
+        await symlink(modules, path.join(workspace, 'node_modules'), 'junction');
+        const contentPrefix = path.relative(path.join(workspace, 'src'), path.join(contentRoot, 'pages')).replaceAll('\\', '/') + '/';
+        await writeFile(path.join(workspace, 'src', 'content.js'), `export const contentPrefix = ${JSON.stringify(contentPrefix)};\n` +
+            `export const pages = import.meta.glob(${JSON.stringify(escapePath(contentPrefix) + '**/*.{md,mdx}')}, { eager: true });\n`);
+        await writeFile(path.join(workspace, 'src', 'site.js'), `export { default } from ${JSON.stringify(path.join(contentRoot, 'site.json').replaceAll('\\', '/'))};\n`);
+        return { workspace, contentRoot, modules, cleanup: () => rm(workspace, { recursive: true, force: true, maxRetries: 3 }) };
+    }
+    catch (error) {
+        await rm(workspace, { recursive: true, force: true });
+        throw error;
+    }
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@lettercamp/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Create and preview Lettercamp publications powered by MDX and Astro.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lettercamp/cli.git",
+    "directory": "core"
+  },
+  "homepage": "https://github.com/lettercamp/cli#readme",
+  "bugs": {
+    "url": "https://github.com/lettercamp/cli/issues"
+  },
+  "type": "module",
+  "bin": {
+    "lettercamp": "bin/lettercamp.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "renderer"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "prepack": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@astrojs/mdx": "8.0.3",
+    "astro": "7.3.8",
+    "commander": "^15.0.0",
+    "giget": "^3.3.1",
+    "semver": "^7.7.3",
+    "tinyglobby": "^0.2.17"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@types/semver": "^7.8.0",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    "./cli": "./dist/lettercamp.js"
+  }
+}

package/renderer/src/layouts/Content.astro

@@ -0,0 +1 @@
+<slot />

package/renderer/src/layouts/SiteLayout.astro

@@ -0,0 +1,43 @@
+---
+import '../styles/site.css';
+
+const { site, page } = Astro.props;
+const title = page.title ?? site.name;
+const description = page.description ?? site.description;
+const image = page.ogImage ?? page.image ?? site.ogImage;
+const imageUrl = image ? new URL(image, Astro.url).href : undefined;
+---
+
+<!doctype html>
+<html lang={site.language ?? 'en'}>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{title === site.name ? title : `${title} · ${site.name}`}</title>
+    <meta name="description" content={description} />
+    <meta property="og:title" content={title} />
+    <meta property="og:description" content={description} />
+    <meta property="og:site_name" content={site.name} />
+    <meta property="og:type" content={page.layout === 'post' ? 'article' : 'website'} />
+    <meta property="og:url" content={Astro.url.href} />
+    {imageUrl && <meta property="og:image" content={imageUrl} />}
+    <meta name="twitter:card" content={imageUrl ? 'summary_large_image' : 'summary'} />
+    {site.favicon && <link rel="icon" href={site.favicon} />}
+  </head>
+  <body>
+    <a class="skip-link" href="#content">Skip to content</a>
+    <header class="site-header">
+      <a class="brand" href="/">
+        {site.favicon && <img src={site.favicon} width="30" height="30" alt="" />}
+        <span>{site.name}</span>
+      </a>
+      <nav aria-label="Main navigation">
+        {(site.navigation ?? [{ label: 'Home', href: '/' }]).map((item) =>
+          <a href={item.href} aria-current={item.href === Astro.url.pathname ? 'page' : undefined}>{item.label}</a>
+        )}
+      </nav>
+    </header>
+    <main id="content"><slot /></main>
+    <footer class="site-footer"><span>© {new Date().getFullYear()} {site.name}</span><a href="https://lettercamp.com">Published with Lettercamp</a></footer>
+  </body>
+</html>

package/renderer/src/pages/[...slug].astro

@@ -0,0 +1,41 @@
+---
+import SiteLayout from '../layouts/SiteLayout.astro';
+import site from '../site.js';
+import { pages, contentPrefix } from '../content.js';
+
+export function getStaticPaths() {
+  return Object.entries(pages).map(([filename, page]) => {
+    const slug = filename.slice(contentPrefix.length).replace(/\.(md|mdx)$/, '')
+      .replace(/(^|\/)index$/, '');
+    return { params: { slug: slug || undefined }, props: { page } };
+  });
+}
+
+const { page } = Astro.props;
+const { Content, frontmatter = {} } = page;
+const home = frontmatter.layout === 'home' || Astro.url.pathname === '/';
+const author = frontmatter.author ?? site.author;
+const date = frontmatter.date ? new Date(`${String(frontmatter.date).slice(0, 10)}T12:00:00Z`) : null;
+const dateLabel = date && !Number.isNaN(date.valueOf())
+  ? new Intl.DateTimeFormat(site.language ?? 'en', { month: 'long', day: 'numeric', year: 'numeric', timeZone: 'UTC' }).format(date)
+  : null;
+---
+
+<SiteLayout site={site} page={frontmatter}>
+  <article class:list={['publication', { 'publication-home': home }]}>
+    <header class="article-header">
+      {!home && <a class="back-link" href="/">← All posts</a>}
+      <p class="eyebrow">{home ? 'News, ideas & notes' : site.name}</p>
+      <h1>{frontmatter.title ?? site.name}</h1>
+      {frontmatter.description && <p class="description">{frontmatter.description}</p>}
+      {!home && (author || dateLabel) && <p class="byline">
+        {author && <span>{author}</span>}
+        {dateLabel && <time datetime={String(frontmatter.date).slice(0, 10)}>{dateLabel}</time>}
+      </p>}
+    </header>
+    {!home && frontmatter.image && <figure class="cover">
+      <img src={frontmatter.image} alt={frontmatter.imageAlt ?? ''} width="1200" height="630" />
+    </figure>}
+    <div class="prose"><Content /></div>
+  </article>
+</SiteLayout>

package/renderer/src/styles/site.css

@@ -0,0 +1,70 @@
+:root {
+  color-scheme: light;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  color: #20201e;
+  background: #fffefa;
+  font-synthesis: none;
+  -webkit-font-smoothing: antialiased;
+}
+* { box-sizing: border-box; }
+body { margin: 0; }
+a { color: inherit; text-underline-offset: .2em; }
+a:focus-visible { outline: 2px solid #235b45; outline-offset: 5px; border-radius: 2px; }
+img { display: block; max-width: 100%; height: auto; }
+.site-header, .site-footer { width: min(1080px, calc(100% - 48px)); margin: auto; display: flex; align-items: center; justify-content: space-between; gap: 24px; }
+.site-header { min-height: 88px; }
+.brand { display: flex; align-items: center; gap: 8px; font-size: 21px; font-weight: 650; letter-spacing: -.6px; text-decoration: none; }
+nav { display: flex; flex-wrap: wrap; gap: 24px; font-size: 14px; }
+nav a { text-decoration: none; color: #66655f; }
+nav a[aria-current], nav a:hover { color: #20201e; }
+.publication { width: min(760px, calc(100% - 48px)); margin: 56px auto 96px; }
+.publication-home { width: min(880px, calc(100% - 48px)); }
+.article-header { margin-bottom: 38px; }
+.back-link { display: inline-block; font-size: 14px; color: #77746e; text-decoration: none; margin-bottom: 40px; }
+.eyebrow { text-transform: uppercase; letter-spacing: .16em; font-size: 11px; font-weight: 600; color: #77746e; margin: 0 0 20px; }
+h1, h2, h3, h4 { text-wrap: balance; }
+h1 { font: 500 clamp(38px, 5.8vw, 62px)/1.08 Georgia, serif; letter-spacing: -.045em; margin: 0 0 22px; }
+.publication-home .article-header { text-align: center; margin: 12px auto 56px; max-width: 700px; }
+.description { color: #6b6962; font-size: 19px; line-height: 1.6; max-width: 650px; margin: 0; }
+.publication-home .description { margin: auto; }
+.byline { display: flex; flex-wrap: wrap; gap: 8px 20px; margin-top: 26px; font-size: 13px; color: #77746e; }
+.cover { margin: 0 0 44px; }
+.cover img, .prose img { width: 100%; border-radius: 5px; }
+.prose { font: 19px/1.85 Georgia, 'Times New Roman', serif; overflow-wrap: anywhere; }
+.prose > :first-child { margin-top: 0; }
+.prose p { margin: 1.3em 0; }
+.prose h2 { font: 600 29px/1.3 -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; letter-spacing: -.04em; margin: 2em 0 .7em; }
+.prose h3 { font: 600 23px/1.4 -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; letter-spacing: -.03em; margin: 1.7em 0 .6em; }
+.prose h4 { font: 600 19px/1.5 -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; margin: 1.6em 0 .5em; }
+.prose h3 a { text-decoration: none; }
+.prose h3 a:hover { text-decoration: underline; }
+.prose ul, .prose ol { padding-left: 1.4em; }
+.prose li { padding-left: .2em; margin: .5em 0; }
+.prose blockquote { border-left: 3px solid #b6bfae; padding: 4px 0 4px 26px; margin: 36px 0; color: #575c50; font-size: 25px; line-height: 1.55; font-style: italic; }
+.prose blockquote p { margin: .3em 0; }
+.prose hr { border: 0; height: 1px; background: #e8e5dd; margin: 42px 0; }
+.prose pre { padding: 24px; overflow: auto; border-radius: 6px; font-size: 14px; line-height: 1.8; }
+.prose code { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: .85em; }
+.prose :not(pre) > code { padding: .18em .35em; background: #efede6; border-radius: 3px; }
+.cards { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; margin: 32px 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }
+.card { display: flex; flex-direction: column; align-items: start; padding: 26px; border-radius: 8px; background: #f3f1eb; text-decoration: none; }
+.card:hover { background: #ebe8df; }
+.card-eyebrow { font-size: 11px; text-transform: uppercase; letter-spacing: .1em; color: #747168; }
+.prose .card h3 { font-size: 22px; margin: 12px 0 6px; }
+.prose .card p { font-size: 15px; line-height: 1.7; color: #6b6962; margin: 0 0 20px; }
+.card-link { font-size: 13px; font-weight: 600; margin-top: auto; }
+.site-footer { padding: 30px 0; font-size: 12px; color: #7b786f; }
+.site-footer a { text-decoration: none; }
+.skip-link { position: absolute; left: 20px; top: -100px; padding: 10px 15px; background: #20201e; color: white; z-index: 10; }
+.skip-link:focus { top: 15px; }
+@media (max-width: 600px) {
+  .site-header, .site-footer, .publication, .publication-home { width: calc(100% - 36px); }
+  .site-header { min-height: 74px; }
+  .brand { font-size: 18px; }
+  nav { gap: 14px; font-size: 13px; }
+  .publication { margin-top: 34px; }
+  .description { font-size: 17px; }
+  .prose { font-size: 18px; }
+  .cards { grid-template-columns: 1fr; }
+  .site-footer { align-items: start; flex-direction: column; gap: 10px; }
+}