create-rush-cms 0.0.2 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rafhael Marsigli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,61 @@
 # create-rush-cms
 
-Scaffolds a website powered by [Rush CMS](https://github.com/rush-cms).
+Creates a website powered by [Rush CMS](https://github.com/rush-cms/rush-cms): a production-ready
+[Astro](https://astro.build) site wired to [`@rushcms/astro`](https://github.com/rush-cms/js/tree/main/packages/astro)
+and [`@rushcms/client`](https://github.com/rush-cms/js/tree/main/packages/client). It works with any Rush CMS v2 site
+on day one, whatever its collections, locales and blocks. The generated code is yours: `create-rush-cms` never touches
+it again.
 
-Not released yet. Follow https://github.com/rush-cms/js
+Requires Node 24 or later.
+
+## Usage
+
+```bash
+npm create rush-cms@latest my-site
+bun create rush-cms my-site
+pnpm create rush-cms my-site
+```
+
+| Argument or flag | Description                                                   |
+| ---------------- | ------------------------------------------------------------- |
+| `<dir>`          | Required. The folder to create; it must not exist or be empty |
+| `--no-install`   | Skip installing dependencies                                  |
+| `-h`, `--help`   | Print the usage and exit                                      |
+
+A missing `<dir>`, an unknown flag or an extra argument prints the usage and exits with code 1. An existing folder
+that is not empty exits with code 1 and nothing is written.
+
+## What it writes
+
+- A copy of the [model site](https://github.com/rush-cms/js/tree/main/templates/astro) with `@rushcms/client` and
+  `@rushcms/astro` pinned to the exact versions released together with this package.
+- `package.json` `name`, taken from the folder name (made npm-valid).
+- `.gitignore` (stored as `_gitignore` in the package, because npm strips `.gitignore` from tarballs).
+- `.env`, a copy of `.env.example` with empty values.
+- `node_modules`, installed with the package manager that ran the command (npm, pnpm, bun or yarn; npm when it cannot
+  tell) unless `--no-install` is given. When the install fails, the files stay and the command to run by hand is
+  printed, with exit code 1.
+
+## What it never does
+
+- Ask questions: there are no prompts.
+- Use the network, apart from the dependency install.
+- Read, ask for or write secrets: `.env` is left empty for you to fill.
+- Run `git init`, commit or touch an existing repository.
+- Edit anything after the first run.
+
+## Next steps
+
+1. `cd my-site`, and install if you used `--no-install`.
+2. Fill `.env` with the API URL, the site id and a delivery token of your Rush CMS site.
+3. Run `npm run dev` (or `bun run dev`, `pnpm run dev`). The first start stops with an error that lists the site's
+   locales and a `localePaths` line; paste it into `astro.config.ts` and run it again.
+4. Search the project for `TODO` markers: each one is a place to customize (routes, navigation, the production
+   domain, `trustedProxies`).
+
+The [template README](https://github.com/rush-cms/js/blob/main/templates/astro/README.md) covers the routes, views,
+preview deployment and deployment topologies.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { spawn } from "node:child_process";
+// src/copy.ts
+const GITIGNORE_SOURCE = "_gitignore";
+const GITIGNORE_TARGET = ".gitignore";
+const TEMPLATE_RULES = {
+	skip: () => false,
+	rename: (name) => name === GITIGNORE_SOURCE ? GITIGNORE_TARGET : name
+};
+function copyTree(from, to, rules) {
+	mkdirSync(to, { recursive: true });
+	for (const entry of readdirSync(from, { withFileTypes: true })) {
+		if (rules.skip(entry.name)) continue;
+		const source = join(from, entry.name);
+		const target = join(to, rules.rename(entry.name));
+		if (entry.isDirectory()) copyTree(source, target, rules);
+		else copyFileSync(source, target);
+	}
+}
+function copyTemplate(from, to) {
+	copyTree(from, to, TEMPLATE_RULES);
+}
+// src/package-manager.ts
+const KNOWN = [
+	"pnpm",
+	"bun",
+	"yarn"
+];
+function detectPackageManager(userAgent) {
+	const launcher = userAgent?.split(" ")[0]?.split("/")[0];
+	return KNOWN.find((name) => name === launcher) ?? "npm";
+}
+function installCommand(packageManager) {
+	return `${packageManager} install`;
+}
+function devCommand(packageManager) {
+	return `${packageManager} run dev`;
+}
+// src/next-steps.ts
+function quoted(dir) {
+	return /\s/.test(dir) ? JSON.stringify(dir) : dir;
+}
+const USAGE = [
+	"Usage: create-rush-cms <dir> [--no-install]",
+	"",
+	"Creates a Rush CMS website in <dir>.",
+	"",
+	"Options:",
+	"  --no-install  Skip installing dependencies",
+	"  -h, --help    Show this help"
+];
+function installFailure(input) {
+	return ["Dependency installation failed. The project files were kept.", `Install manually: cd ${quoted(input.dir)} && ${installCommand(input.packageManager)}`];
+}
+function nextSteps(input) {
+	return [
+		"",
+		"Next steps:",
+		...[
+			`cd ${quoted(input.dir)}`,
+			...input.installed ? [] : [installCommand(input.packageManager)],
+			"Fill .env with your Rush CMS API URL, site id and delivery token",
+			`${devCommand(input.packageManager)}, then paste the localePaths line the first-run error prints into astro.config.ts`,
+			"Search the project for TODO markers and fill them in"
+		].map((step, index) => `  ${index + 1}. ${step}`)
+	];
+}
+// src/manifest.ts
+const DEFAULT_INDENT = "	";
+function updateManifest(file, update) {
+	const text = readFileSync(file, "utf8");
+	const indent = /\n([ \t]+)"/.exec(text)?.[1] ?? DEFAULT_INDENT;
+	const manifest = JSON.parse(text);
+	update(manifest);
+	writeFileSync(file, `${JSON.stringify(manifest, null, indent)}\n`);
+}
+// src/package-name.ts
+const FALLBACK = "rush-site";
+const MAX_LENGTH = 214;
+const RESERVED = /* @__PURE__ */ new Set(["node_modules", "favicon.ico"]);
+function packageNameOf(dir) {
+	const name = basename(resolve(dir)).toLowerCase().normalize("NFD").replaceAll(/\p{M}/gu, "").replaceAll(/[^a-z0-9._~-]+/g, "-").replace(/^[._-]+/, "").slice(0, MAX_LENGTH).replace(/-+$/, "");
+	return name === "" || RESERVED.has(name) ? FALLBACK : name;
+}
+// src/run.ts
+const DEFAULT_TEMPLATE_DIR = resolve(import.meta.dirname, "..", "template");
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function emit(lines, write) {
+	for (const line of lines) write(line);
+}
+function parse(argv) {
+	try {
+		const { values, positionals } = parseArgs({
+			args: argv,
+			allowPositionals: true,
+			options: {
+				help: {
+					type: "boolean",
+					short: "h"
+				},
+				"no-install": { type: "boolean" }
+			}
+		});
+		const [dir, ...extra] = positionals;
+		if (values.help === true) return { kind: "help" };
+		if (dir === void 0) return {
+			kind: "invalid",
+			message: "Missing <dir>."
+		};
+		if (extra.length > 0) return {
+			kind: "invalid",
+			message: `Unexpected argument: ${extra.join(" ")}`
+		};
+		return {
+			kind: "ready",
+			options: {
+				dir,
+				install: values["no-install"] !== true
+			}
+		};
+	} catch (error) {
+		return {
+			kind: "invalid",
+			message: messageOf(error)
+		};
+	}
+}
+function isNonEmpty(target) {
+	return existsSync(target) && (!statSync(target).isDirectory() || readdirSync(target).length > 0);
+}
+function setPackageName(target) {
+	updateManifest(join(target, "package.json"), (manifest) => {
+		manifest.name = packageNameOf(target);
+	});
+}
+function scaffold(target, templateDir) {
+	copyTemplate(templateDir, target);
+	setPackageName(target);
+	copyFileSync(join(target, ".env.example"), join(target, ".env"));
+}
+async function run(argv, env, io, templateDir = DEFAULT_TEMPLATE_DIR) {
+	const parsed = parse(argv);
+	if (parsed.kind === "help") {
+		emit(USAGE, io.out);
+		return 0;
+	}
+	if (parsed.kind === "invalid") {
+		io.err(parsed.message);
+		emit(USAGE, io.err);
+		return 1;
+	}
+	const { dir, install } = parsed.options;
+	const target = resolve(env.cwd, dir);
+	if (isNonEmpty(target)) {
+		io.err(`${dir} already exists and is not empty. Nothing was written.`);
+		return 1;
+	}
+	try {
+		scaffold(target, templateDir);
+	} catch (error) {
+		io.err(`Could not create the project: ${messageOf(error)}`);
+		return 1;
+	}
+	const packageManager = detectPackageManager(env.userAgent);
+	const input = {
+		dir,
+		packageManager,
+		installed: install
+	};
+	io.out(`Created ${packageNameOf(target)} in ${dir}`);
+	if (install && await io.spawn(packageManager, target) !== 0) {
+		emit(installFailure(input), io.err);
+		return 1;
+	}
+	emit(nextSteps(input), io.out);
+	return 0;
+}
+// src/spawn-install.ts
+const FAILURE = 1;
+function runCommand(command, args, cwd) {
+	return new Promise((resolve) => {
+		const child = spawn(command, args, {
+			cwd,
+			stdio: "inherit",
+			shell: process.platform === "win32"
+		});
+		child.on("error", () => resolve(FAILURE));
+		child.on("close", (code) => resolve(code ?? FAILURE));
+	});
+}
+function spawnInstall(packageManager, cwd) {
+	const [command = packageManager, ...args] = installCommand(packageManager).split(" ");
+	return runCommand(command, args, cwd);
+}
+// src/cli.ts
+process.exitCode = await run(process.argv.slice(2), {
+	userAgent: process.env.npm_config_user_agent,
+	cwd: process.cwd()
+}, {
+	out: (line) => console.log(line),
+	err: (line) => console.error(line),
+	spawn: spawnInstall
+});
+export {};

package/package.json

@@ -1,14 +1,18 @@
 {
 	"name": "create-rush-cms",
-	"version": "0.0.2",
-	"description": "Create a website powered by Rush CMS. Not released yet.",
+	"version": "0.1.0",
+	"description": "Create an Astro website powered by Rush CMS.",
 	"type": "module",
 	"bin": {
-		"create-rush-cms": "index.js"
+		"create-rush-cms": "dist/cli.js"
 	},
 	"files": [
-		"index.js"
+		"dist",
+		"template"
 	],
+	"engines": {
+		"node": ">=24"
+	},
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/rush-cms/js.git",
@@ -22,5 +26,10 @@
 		"starter"
 	],
 	"author": "Rafhael Marsigli <oi@rafhael.com.br>",
-	"license": "MIT"
+	"license": "MIT",
+	"scripts": {
+		"build": "tsdown && bun ../../scripts/bundle-template.ts",
+		"typecheck": "tsc -p tsconfig.json",
+		"test": "vitest run"
+	}
 }

package/template/.env.example

@@ -0,0 +1,5 @@
+RUSH_API_URL=
+RUSH_SITE_ID=
+RUSH_API_TOKEN=
+RUSH_MEDIA_URL=
+RUSH_PREVIEW=

package/template/README.md

@@ -0,0 +1,127 @@
+# Rush CMS site
+
+An [Astro](https://astro.build) site wired to [Rush CMS](https://github.com/rush-cms/rush-cms) through
+[`@rushcms/astro`](https://github.com/rush-cms/js/tree/main/packages/astro) and
+[`@rushcms/client`](https://github.com/rush-cms/js/tree/main/packages/client). It works with any Rush CMS site: every
+collection, entry, locale, navigation and form comes from the CMS, and the URLs come from this repository. The code
+is yours now; change anything.
+
+Requires Node 24 or later.
+
+## First run
+
+1. Fill `.env`:
+
+    | Variable         | Value                                                       |
+    | ---------------- | ----------------------------------------------------------- |
+    | `RUSH_API_URL`   | The Rush CMS API base URL                                   |
+    | `RUSH_SITE_ID`   | The site ULID                                               |
+    | `RUSH_API_TOKEN` | A delivery token of the site (secret: never commit it)      |
+    | `RUSH_MEDIA_URL` | The media host, when it differs from the API (optional)     |
+    | `RUSH_PREVIEW`   | `true` only for a [preview deployment](#preview-deployment) |
+
+2. Run `npm run dev`. The first start stops with an error that lists the site's locales and a line to paste:
+
+    ```text
+    @rushcms/astro: localePaths locales [] differ from the site locales [pt_BR, en]. Set in astro.config:
+      localePaths: { pt_BR: '', en: 'en' }
+    ```
+
+    When an AI coding agent starts the dev server, Astro runs it in the background and writes this error to
+    `.astro/dev.log` instead of the terminal.
+
+3. Paste that line over `localePaths: {}` in `astro.config.ts` and run `npm run dev` again. The default locale has
+   no URL prefix; every other locale gets its own. Change the prefixes now if you like: they are part of your URLs.
+
+4. Open <http://localhost:4321>, then work through the `TODO` comments (your editor's TODO list finds them all).
+
+| Command           | What it does                                                          |
+| ----------------- | --------------------------------------------------------------------- |
+| `npm run dev`     | Development server with live content                                  |
+| `npm run build`   | Production build in `dist/`                                           |
+| `npm run preview` | Runs the built server with the variables of `.env`, when there is one |
+| `npm run check`   | Type-checks the project with `astro check`                            |
+
+## Routes and views
+
+URLs come only from `routes` and `localePaths` in `astro.config.ts`. The template ships one generic route,
+`'*': '/{locale}/{collection}/{slug}'`, which gives every collection a list page (`/en/posts`, `/en/posts/page/2`)
+and entry pages (`/en/posts/hello`). Replace `'*'` with one key per public collection (a collection id or slug) so
+that collections holding only data get no pages. A collection without a route has no pages, no sitemap entries and
+no navigation links. See [Routes](https://github.com/rush-cms/js/tree/main/packages/astro#routes) for the rules.
+
+No page file encodes a URL shape:
+
+| File                                  | Answers                                                                       |
+| ------------------------------------- | ----------------------------------------------------------------------------- |
+| `src/pages/[...path].astro`           | Every homepage, collection list page and entry, prerendered at build time     |
+| `src/pages/404.astro`                 | Every other path, on demand: redirects retired slugs, else the not-found page |
+| `src/pages/[...locale]/contact.astro` | The contact form of each locale, on demand                                    |
+| `src/pages/sitemap.xml.ts`            | The sitemap, from the same routes                                             |
+| `src/pages/robots.txt.ts`             | `robots.txt` (everything disallowed in a preview deployment)                  |
+
+The dispatcher hands each page to a view:
+
+- `src/views/home.astro`: the front page of every locale. It is a static welcome page; replace it with your design,
+  or render the homepage built in Rush CMS from `page.homepage`.
+- `src/views/collection.astro`: a collection list page with pagination.
+- `src/views/entry.astro`: an entry with its title, featured image, excerpt and every rich-text field.
+- `src/views/not-found.astro`: the 404 page.
+
+To give a collection its own design, create a view and map the collection id or slug in `src/views/index.ts`:
+
+```ts
+import PostEntry from './post-entry.astro'
+
+const views: ViewMap = { posts: { entry: PostEntry } }
+```
+
+A view receives the same props as the generic one (`EntryViewProps` or `ListViewProps`), and `npm run check` fails
+when it does not. `src/astro-modules.d.ts` lets plain TypeScript read the `.astro` imports of that file.
+
+## Navigation and forms
+
+Site content is fetched by stable keys that you create in Rush CMS:
+
+| Key       | Kind       | Used by                                                |
+| --------- | ---------- | ------------------------------------------------------ |
+| `main`    | Navigation | The header menu (nested items open on hover and focus) |
+| `footer`  | Navigation | The footer menu                                        |
+| `contact` | Form       | `/contact` (and `/<locale>/contact`)                   |
+
+Missing content renders nothing: no menu without the navigation, and `/contact` answers 404 without the form (in
+`npm run dev` it shows a reminder instead). Change a key where the `TODO` points to it.
+
+## Preview deployment
+
+Deploy the same repository a second time with `RUSH_PREVIEW=true` and point the CMS preview URL templates at it:
+
+```text
+https://preview.example.com/_rush/preview?token={token}&locale={locale}&collection={collection}&slug={slug}
+https://preview.example.com/_rush/preview?token={token}&locale={locale}
+```
+
+Every page of that deployment is rendered on demand with drafts, carries `X-Robots-Tag: noindex`, and shows a banner
+with a link to leave the preview. See
+[Preview deployment](https://github.com/rush-cms/js/tree/main/packages/astro#preview-deployment).
+
+## Deployment
+
+- `npm run build` fetches every page from the API and writes `dist/`. Static pages change only when you build again,
+  so rebuild after publishing content.
+- Run the server with `node ./dist/server/entry.mjs` (`HOST` and `PORT` set where it listens). It reads the `RUSH_`
+  variables from the process environment, not from `.env`: set them on your host. `npm run preview` starts it
+  locally with `.env` loaded (`node --env-file-if-exists=.env ./dist/server/entry.mjs`). The server answers the 404
+  page, redirects, the contact page and form posts (`/_rush/forms/<key>`).
+- Set `site` to your production URL: canonical links, `hreflang` links and the sitemap use it.
+- List your domains in `security.allowedDomains`, or form posts and preview links fail on them.
+- Set `trustedProxies` to the number of reverse proxies in front of the server, so form posts are rate-limited per
+  visitor. The [topology table](https://github.com/rush-cms/js/tree/main/packages/astro#behind-reverse-proxies) gives
+  the value for Coolify, nginx and Cloudflare.
+
+## Styling
+
+[Tailwind CSS 4](https://tailwindcss.com) through `@tailwindcss/vite`. The design tokens (colors and fonts) live in
+`@theme` in `src/styles/global.css`, with their dark values under `prefers-color-scheme: dark`, so changing a token
+restyles both themes. Rich text is styled by `@tailwindcss/typography` (`prose`), mapped to the same tokens. The UI
+texts of the views are in English; translate them where they appear.

package/template/_gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.astro
+.env
+.env.*
+!.env.example

package/template/astro.config.ts

@@ -0,0 +1,28 @@
+import node from '@astrojs/node'
+import rush from '@rushcms/astro'
+import tailwindcss from '@tailwindcss/vite'
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+	// TODO: set your production URL; canonical links, hreflang links and the sitemap are built from it.
+	site: 'http://localhost:4321',
+	output: 'static',
+	adapter: node({ mode: 'standalone' }),
+	security: {
+		// TODO: list every domain that serves this site, or form posts and preview links fail there.
+		allowedDomains: [{ protocol: 'https', hostname: 'www.example.com' }]
+	},
+	vite: {
+		plugins: [tailwindcss()]
+	},
+	integrations: [
+		rush({
+			// TODO: paste the localePaths line that the first `npm run dev` prints.
+			localePaths: {},
+			// TODO: replace '*' with one route per public collection, so data-only collections get no pages.
+			routes: { '*': '/{locale}/{collection}/{slug}' },
+			// TODO: set how many reverse proxies sit in front of the server (see "Deployment" in README.md).
+			trustedProxies: 1
+		})
+	]
+})

package/template/package.json

@@ -0,0 +1,28 @@
+{
+	"name": "rush-cms-template-astro",
+	"version": "0.0.0",
+	"private": true,
+	"type": "module",
+	"engines": {
+		"node": ">=24"
+	},
+	"scripts": {
+		"dev": "astro dev",
+		"build": "astro build",
+		"preview": "node --env-file-if-exists=.env ./dist/server/entry.mjs",
+		"check": "astro check"
+	},
+	"dependencies": {
+		"@astrojs/node": "11.1.11",
+		"@rushcms/astro": "0.2.0",
+		"@rushcms/client": "4.0.0",
+		"@tailwindcss/typography": "0.5.20",
+		"@tailwindcss/vite": "4.3.5",
+		"astro": "7.4.7",
+		"tailwindcss": "4.3.5"
+	},
+	"devDependencies": {
+		"@astrojs/check": "0.9.12",
+		"typescript": "npm:@typescript/typescript6@6.0.2"
+	}
+}

package/template/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+	<rect width="32" height="32" rx="8" fill="#5b4bdb" />
+	<path d="M10 8h7.5a5.5 5.5 0 0 1 1.9 10.66L23 24h-4.4l-3.1-4.8H14V24h-4zm4 3.4v4.4h3.3a2.2 2.2 0 0 0 0-4.4z" fill="#fff" />
+</svg>

package/template/src/astro-modules.d.ts

@@ -0,0 +1,5 @@
+declare module '*.astro' {
+	type AstroComponent = (props: Record<string, unknown>) => unknown
+	const component: AstroComponent
+	export default component
+}

package/template/src/components/language-switcher.astro

@@ -0,0 +1,39 @@
+---
+import { getUrls, homepageAlternates } from '@rushcms/astro'
+import type { Alternate, LocaleCode } from '@rushcms/client'
+import { languageName } from '../lib/locale'
+
+type Props = {
+	locale: LocaleCode
+	translations: Alternate[]
+}
+
+const { locale, translations } = Astro.props
+const links = homepageAlternates(getUrls(Astro)).map((home) => ({
+	...home,
+	label: languageName(home.locale),
+	url: translations.find((translation) => translation.locale === home.locale)?.url ?? home.url
+}))
+---
+
+{
+	links.length > 1 && (
+		<nav aria-label="Language" class="text-sm">
+			<ul class="flex flex-wrap items-center gap-1">
+				{links.map((link) => (
+					<li>
+						<a
+							href={link.url}
+							hreflang={link.hreflang}
+							lang={link.hreflang}
+							aria-current={link.locale === locale ? 'true' : undefined}
+							class="block rounded-full px-3 py-1 text-muted transition-colors hover:text-ink aria-[current]:bg-accent-soft aria-[current]:text-ink"
+						>
+							{link.label}
+						</a>
+					</li>
+				))}
+			</ul>
+		</nav>
+	)
+}

package/template/src/components/nav-links.astro

@@ -0,0 +1,33 @@
+---
+import type { NavigationLink } from '@rushcms/client'
+
+type Props = {
+	links: NavigationLink[]
+	nested?: boolean
+}
+
+const { links, nested = false } = Astro.props
+---
+
+<ul class:list={['nav-links', nested ? 'nav-links-nested' : 'nav-links-top']}>
+	{
+		links.map((link) => (
+			<li class="nav-item">
+				{link.href === undefined ? (
+					<span class="nav-label">{link.label}</span>
+				) : (
+					<a
+						{...link.attributes}
+						href={link.href}
+						target={link.target}
+						rel={link.rel}
+						class:list={['nav-link', link.className]}
+					>
+						{link.label}
+					</a>
+				)}
+				{link.children.length > 0 && <Astro.self links={link.children} nested />}
+			</li>
+		))
+	}
+</ul>

package/template/src/components/site-footer.astro

@@ -0,0 +1,29 @@
+---
+import type { NavigationLink } from '@rushcms/client'
+import NavLinks from './nav-links.astro'
+
+type Props = {
+	name: string
+	links: NavigationLink[]
+}
+
+const { name, links } = Astro.props
+---
+
+<footer class="border-t border-line">
+	<div
+		class="mx-auto flex max-w-6xl flex-col gap-6 px-6 py-10 text-sm text-muted md:flex-row md:items-start md:justify-between"
+	>
+		<p>
+			&copy; {`${new Date().getFullYear()} ${name}`}. Powered by{' '}
+			<span class="font-medium text-ink">Rush CMS</span>.
+		</p>
+		{
+			links.length > 0 && (
+				<nav aria-label="Footer" class="footer-nav">
+					<NavLinks links={links} />
+				</nav>
+			)
+		}
+	</div>
+</footer>